Meta Conversions API tilläggsöversikt
The Meta Conversions API kan ni koppla marknadsföringsdata på serversidan till Meta för att optimera er annonsinriktning, minska kostnaden per åtgärd och mäta resultaten. Händelser är länkade till en Meta Pixel ID och behandlas på ett liknande sätt som händelser på klientsidan.
Använda Meta Conversions API kan du utnyttja API:ts funktioner i händelsevidarebefordran regler att skicka data till Meta från Adobe Experience Platform Edge Network. Det här dokumentet beskriver hur du installerar tillägget och använder dess funktioner vid en händelsevidarebefordring regel.
Demo
Följande video är avsedd att ge stöd för din förståelse av Meta Conversions API.
Förutsättningar
Vi rekommenderar starkt att du använder Meta Pixel och Conversions API för att dela och skicka samma händelser från klienten respektive serversidan, eftersom detta kan hjälpa till att återställa händelser som inte plockats upp av Meta Pixel. Innan du installerar Conversions API -tillägget, se guiden på Meta Pixel extension om du vill ha steg för hur du kan integrera det i implementeringar av taggar på klientsidan.
För att kunna använda Conversions API måste du ha tillgång till händelsevidarebefordran och ha en giltig Meta konto med tillgång till Ad Manager och Event Manager. Du måste kopiera ID:t för en befintlig Meta Pixel (eller skapa en ny Pixel i stället) så att tillägget kan konfigureras för ditt konto.
Installera tillägget
Installera Meta Conversions API navigerar du till användargränssnittet för datainsamling eller användargränssnittet för Experience Platform och väljer Event Forwarding från vänster navigering. Här väljer du en egenskap som tillägget ska läggas till i eller skapar en ny egenskap i stället.
När du har valt eller skapat den önskade egenskapen väljer du Extensions i den vänstra navigeringen väljer du Catalog -fliken. Sök efter Meta Conversions API kort, välj Install.
I konfigurationsvyn som visas måste du ange Pixel ID som du kopierade tidigare för att länka tillägget till ditt konto. Du kan klistra in ID:t direkt i indata eller använda ett dataelement i stället.
Du måste också ange en åtkomsttoken för att kunna använda Conversions API specifikt. Se Conversions API dokumentation om generera en åtkomsttoken om du vill se steg för hur du får fram det här värdet.
När du är klar väljer du Save
Tillägget är installerat och du kan nu använda dess funktioner i reglerna för vidarebefordran av händelser.
Integrering med Meta Business Extension (MBE) mbe
Tack vare integreringen med MBE (Meta Business Extensions) kan du snabbt autentisera med ditt Meta Business Account. Detta fyller sedan i Pixel ID och Meta Conversions API Access Token, vilket gör det enklare att installera och konfigurera API:t för metakonvertering.
En dialogruta för autentisering i MBE visas när du installerar Meta Conversions API tillägg.
En dialogruta för att autentisera i MBE visas också i snabbstartsgränssnittet vid vidarebefordran av händelser.
Integrering med EMQ (Event Quality Match Score) emq
Integrationen med EMQ (Event Quality Match Score) gör att du enkelt kan se hur effektiv implementeringen är genom att visa EMQ-poäng. Den här integreringen minimerar kontextväxling och hjälper dig att förbättra framgången för implementeringarna av Meta Conversions API. De här händelserumren visas i Meta Conversions API extension konfigurationsskärmen.
Integrering med LiveRamp (Alpha) alpha
LiveRamp kunder som har LiveRampATS (Authenticated Traffic Solution) som distribueras på deras webbplatser kan välja att dela RampID:n som en kundinformationsparameter. Var vänlig och arbeta med Meta kontoteam för att gå med i Alpha för den här funktionen.
Konfigurera en regel för vidarebefordran av händelser rule
I det här avsnittet beskrivs hur du använder Conversions API tillägg i en allmän regel för vidarebefordran av händelser. I praktiken bör du konfigurera flera regler för att skicka alla godkända standardhändelser via Meta Pixel och Conversions API. Information om mobilappsdata finns i obligatoriska fält, appdatafält, kundinformationsparametrar och anpassad datainformation här.
Börja skapa en ny regel för vidarebefordring av händelser och konfigurera villkoren efter behov. När du väljer åtgärder för regeln väljer du Meta Conversions API Extension för tillägget väljer du Send Conversions API Event för åtgärdstypen.
Det visas kontroller som gör att du kan konfigurera händelsedata som ska skickas till Meta via Conversions API. Dessa alternativ kan anges direkt i de angivna inmatningarna eller så kan du välja befintliga dataelement som ska representera värdena i stället. Konfigurationsalternativen är uppdelade i fyra huvudavsnitt enligt nedan.
Om du använder båda Meta Pixel och Conversions API om du vill skicka händelser, se till att inkludera både en Event Name (
event_name
) och Event ID (event_id
) med varje händelse eftersom dessa värden används för deduplicering av händelser.Du kan också välja att Enable Limited Data Use för att hjälpa till att följa kundernas avval. Se Conversions API dokumentation om databearbetningsalternativ för mer information om den här funktionen.
För att säkerställa en bra gemensam API-anslutning och hög händelsematchningskvalitet (EMQ) rekommenderar vi att du skickar alla godkända parametrar för kundinformation tillsammans med serverhändelser. Dessa parametrar bör också prioriterad baserat på deras betydelse och inverkan på det europeiska folkhälsoområdet.
Om du skickar en köphändelse måste du använda det här avsnittet för att ange de attribut som krävs
currency
och value
.När du är klar väljer du Keep Changes för att lägga till åtgärden i regelkonfigurationen.
När du är nöjd med regeln väljer du Save to Library. Publicera slutligen en ny händelsevidarebefordring bygg för att aktivera ändringar som gjorts i biblioteket.
Borttagning av händelser deduplication
Som nämndes i kravsektionrekommenderar vi att du använder båda Meta Pixel taggtillägg och Conversions API tillägg för händelsevidarebefordran för att skicka samma händelser från klienten och servern i en redundant konfiguration. Detta kan hjälpa till att återställa händelser som inte har hämtats av ett tillägg eller av ett annat.
Om du skickar olika händelsetyper från klienten och servern utan överlappning mellan de båda behöver du inte deduplicera. Om en enda händelse delas av båda Meta Pixel och Conversions APImåste du se till att dessa redundanta händelser dedupliceras så att rapporteringen inte påverkas negativt.
När du skickar delade händelser måste du se till att du inkluderar ett händelse-ID och namn för varje händelse som du skickar från både klienten och servern. När flera händelser med samma ID och namn tas emot, Meta använder automatiskt flera strategier för att deduplicera dem och behålla de mest relevanta data. Se Meta dokumentation om deduplicering för Meta Pixel och Conversions API händelser om du vill ha mer information om processen.
Snabbstartarbetsflöde: API-tillägg för metakonveringar (beta) quick-start
- Snabbstartsfunktionen är tillgänglig för kunder som har köpt Real-Time CDP Prime- och Ultimate-paketet. Kontakta din Adobe-representant om du vill ha mer information.
- Den här funktionen är avsedd för nya implementeringar och stöder för närvarande inte automatisk installation av tillägg och konfigurationer i befintliga taggar och egenskaper för händelsevidarebefordran.
- Använd det som början på en helt ny implementering.
- Utnyttja det som en referensimplementering som du kan undersöka för att se hur det har konfigurerats och sedan replikera i dina nuvarande produktionsimplementationer.
Med snabbstartsfunktionen blir det enklare och effektivare att konfigurera med Meta Conversions API och Meta Pixel-tilläggen. Det här verktyget automatiserar flera steg som utförs i taggar för Adobe och vidarebefordran av händelser, vilket avsevärt minskar konfigurationstiden.
Den här funktionen installerar och konfigurerar automatiskt både Meta Conversion API och Meta Pixel-tilläggen på en nyligen genererad tagg och händelsevidarebefordringsegenskap med nödvändiga regler och dataelement. Dessutom installeras och konfigureras Experience Platform Web SDK och Datastream automatiskt. Slutligen publicerar snabbstartsfunktionen automatiskt biblioteket till den angivna URL:en i en utvecklingsmiljö, vilket möjliggör datainsamling på klientsidan och vidarebefordran av händelser på serversidan i realtid via händelsevidarebefordring och Experience Platform Edge Network.
I följande video visas en introduktion till snabbstartsfunktionen.
Installera snabbstartsfunktion
Den här installationen installerar både Meta Conversion API och Meta Pixel-tilläggen automatiskt. Den här hybridimplementeringen rekommenderas av Meta för att samla in och vidarebefordra händelsekonverteringar på serversidan.
Snabbinstallationsfunktionen är utformad för att hjälpa kunderna att komma igång med en händelsevidarebefordringsimplementering och är inte avsedd att leverera en heltäckande, fullt fungerande implementering som passar alla användningsfall.
Installera funktionen genom att välja Get Started for Send Conversions Data to Meta om Adobe Experience Platform Data Collection Home sida.
Ange Domain väljer Next. Den här domänen kommer att användas som namngivningskonvention för dina automatiskt genererade taggar och egenskaper för händelsevidarebefordran, regler, dataelement, datastreams osv.
I Initial Setup genom att Meta Pixel ID, Meta Conversion API Access Token och Data Layer Path väljer Next.
Tillåt några minuter innan den första installationsprocessen är klar och välj sedan Next.
Från Add Code on Your Site kopierar koden som anges med kopian
funktionen och klistra in den i <head>
på källwebbplatsen. När implementeringen är klar väljer du Start Validation
The Validation Results visas implementeringsresultatet för metatillägget. Välj Next. Du kan även se ytterligare valideringsresultat genom att välja Assurance länk.
The Next Steps skärmvisningen bekräftar att installationen har slutförts. Härifrån har du möjlighet att optimera implementeringen genom att lägga till nya händelser, som visas i nästa avsnitt.
Om du inte vill lägga till fler händelser väljer du Close.
Lägga till ytterligare händelser
Välj om du vill lägga till nya händelser Edit Your Tags Web Property.
Markera den regel som motsvarar metahändelsen som du vill redigera. Till exempel: MetaConversion_AddToCart.
Lägg till en händelse genom att välja Add under Events rubrik.
Markera Event Type. I det här exemplet har vi valt Click -händelsen och konfigurerade den att utlösas när .add-to-cart-button är markerat. Välj Keep Changes.
Den nya händelsen har sparats. Välj Select a working library och välj det bibliotek som du vill bygga till.
Välj sedan listrutan bredvid Save to Library och markera Save to Library and Build. Ändringen publiceras i biblioteket.
Upprepa dessa steg för alla andra metakonverteringshändelser som du vill konfigurera.
Datalagerkonfiguration configuration
MetaConversion_* rules
. Om du inte uppdaterar data mellan regler kan du även stöta på ett fall där du skickar inaktuella data från den senaste MetaConversion_* rule
i aktuell MetaConversion_* rule
.Under konfigurationen tillfrågades du var datalagret finns. Som standard är detta window.dataLayer.meta
och i meta
-objektet, förväntas dina data enligt nedan.
Detta är viktigt att förstå MetaConversion_*
regeln använder den här datastrukturen för att skicka relevanta datadelar till Meta Pixel tillägg och Meta Conversions API. Mer information finns i dokumentationen om standardhändelser för mer information om vilka data olika metahändelser kräver.
Om du till exempel vill använda MetaConversion_Subscribe
regel, du måste uppdatera window.dataLayer.meta.currency
, window.dataLayer.meta.predicted_ltv
och window.dataLayer.meta.value
enligt objektegenskaperna som beskrivs i dokumentationen om standardhändelser.
Nedan visas ett exempel på vad som behöver köras på en webbplats för att datalagret ska uppdateras innan regeln körs.
Som standard är <datalayerpath>.conversionData.eventId
genereras slumpmässigt av åtgärden"Generera nytt händelse-ID" på någon av MetaConversion_* rules
.
Om du vill ha en lokal referens om hur datalagret ska se ut kan du öppna den anpassade kodredigeraren på MetaConversion_DataLayer
dataelement på din egenskap.
Nästa steg
I den här guiden beskrivs hur du skickar händelsedata på serversidan till Meta med Meta Conversions API tillägg. Härifrån rekommenderar vi att du utökar integreringen genom att ansluta mer Pixels och dela med dig av fler händelser när det är tillämpligt. Om du gör något av följande kan du förbättra din annonsering ytterligare:
- Anslut andra Pixels som ännu inte är anslutna till en Conversions API integrering.
- Om du skickar vissa händelser exklusivt via Meta Pixel på klientsidan skickar du samma händelser till Conversions API även från serversidan.
Se Meta dokumentation om de bästa sätten för Conversions API om du vill ha mer information om hur ni kan implementera er integrering på ett effektivt sätt. Mer allmän information om taggar och vidarebefordran av händelser i Adobe Experience Cloud finns i taggöversikt.