Översikt över tillägget Meta Conversions API
Med Meta Conversions API kan du koppla marknadsföringsdata på serversidan till Meta-tekniker för att optimera er annonsinriktning, minska kostnaden per åtgärd och mäta resultat. Händelser är länkade till ett Meta Pixel-ID och bearbetas på ungefär samma sätt som händelser på klientsidan.
Med tillägget Meta Conversions API kan du utnyttja API:ts funktioner i reglerna för vidarebefordran av händelser för 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 i en händelsevidarebefordring av regeln.
Demo
Följande video är avsedd att stödja 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 klient- respektive serversidan, eftersom detta kan hjälpa till att återställa händelser som inte plockats upp av Meta Pixel. Innan du installerar tillägget Conversions API ska du läsa guiden för tillägget Meta Pixel för steg om hur du integrerar det i implementeringar av taggar på klientsidan.
För att kunna använda tillägget Conversions API måste du ha tillgång till händelsevidarebefordran och ha ett giltigt 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
Om du vill installera tillägget Meta Conversions API går du till användargränssnittet för datainsamlingen eller användargränssnittet för Experience Platform och väljer Event Forwarding i den vänstra navigeringen. 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 markerat eller skapat den önskade egenskapen väljer du Extensions i den vänstra navigeringen och väljer sedan fliken Catalog. Sök efter kortet Meta Conversions API och välj sedan Install.
I konfigurationsvyn som visas måste du ange det Pixel-ID som du kopierade tidigare för att kunna 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. Mer information om hur du hämtar det här värdet finns i Conversions API-dokumentationen om generering av en åtkomsttoken.
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 Facebook- och Instagram-tillägg facebook
Integreringen med Facebook- och Instagram-tilläggen gör att du snabbt kan autentisera dig i ditt Meta Business Account. Detta fyller sedan automatiskt i Pixel ID och Meta Conversions API Access Token, vilket gör det enklare att installera och konfigurera Meta Conversions API.
En dialogruta för autentisering i Facebook och Instagram visas när tillägget Meta Conversions API installeras.
En dialogruta för autentisering i Facebook och Instagram 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. Integreringen minimerar kontextväxling och hjälper dig att förbättra framgången för implementeringarna av Meta Conversion API. De här händelsepoängen visas på konfigurationsskärmen Meta Conversions API extension.
Integrering med LiveRamp (Alpha) alpha
LiveRamp-kunder som har LiveRamps ATS (Authenticated Traffic Solution) distribuerat på sina webbplatser kan välja att dela RampID:n som en kundinformationsparameter. Samarbeta med ditt Meta-kontoteam för att gå med i Alpha-programmet 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 tillägget Conversions API 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 som tillägg och sedan Send Conversions API Event som åtgärdstyp.
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åde Meta Pixel och Conversions API för att skicka händelser måste du ta med både en Event Name (
event_name) och Event ID (event_id) för varje händelse, eftersom dessa värden används för händelsededuplicering.Du kan även välja att Enable Limited Data Use ska hjälpa till att följa kundavanmälningarna. Mer information om den här funktionen finns i Conversions API-dokumentationen om databearbetningsalternativ.
För att säkerställa en bra gemensam API-anslutning och hög händelsematchningskvalitet (EMQ) rekommenderar vi att du skickar alla accepterade kundinformationsparametrar tillsammans med serverhändelser. Dessa parametrar bör också prioriteras baserat på deras betydelse och påverkan på EMQ.
Om du skickar en köphändelse måste du använda det här avsnittet för att ange de nödvändiga attributen
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ändelse som vidarebefordrar build för att aktivera ändringar som gjorts i biblioteket.
Borttagning av händelser deduplication
Som vi nämnt i avsnittet Krav rekommenderar vi att du använder både taggtillägget Meta Pixel och tillägget Conversions API 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 enskild händelse delas av både Meta Pixel och Conversions API måste du dock se till att dessa redundanta händelser dedupliceras så att din rapportering 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, använder Meta automatiskt flera strategier för att deduplicera dem och behålla de mest relevanta data. Mer information om den här processen finns i Meta-dokumentationen om deduplicering för Meta Pixel och Conversions API händelser.
Snabbstart: Meta Conversions API Extension (Beta) quick-start
- Snabbstartsfunktionen är tillgänglig för kunder som har köpt Real-Time CDP Prime- och Ultimate-paketet. Kontakta Adobe 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. Detta verktyg automatiserar flera steg som utförs i Adobe-taggar och vidarebefordran av händelser, vilket avsevärt minskar konfigurationstiden.
Den här funktionen installerar och konfigurerar automatiskt både Meta Conversions API och Meta Pixel-tilläggen på en nyligen genererad tagg och händelsevidarebefordringsegenskap med de regler och dataelement som behövs. 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 Event Forwarding och Experience Platform Edge Network.
I följande video visas en introduktion till snabbstartsfunktionen.
Installera snabbstartsfunktion
Följ instruktionerna i den guidade konfigurationen för att komma igång med den guidade konfigurationen.
Lägga till ytterligare händelser
Välj Edit Your Tags Web Property om du vill lägga till nya händelser.
Markera den regel som motsvarar metahändelsen som du vill redigera. Exempel: MetaConversion_AddToCart.
Om du vill lägga till en händelse väljer du Add under rubriken Events.
Markera Event Type. I det här exemplet har vi markerat händelsen Click och konfigurerat den så att den utlöses när .add-to-cart-button väljs. 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.
Markera sedan listrutan bredvid Save to Library och välj 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 sista MetaConversion_* rule i aktuell MetaConversion_* rule.Under konfigurationen tillfrågades du var datalagret finns. Som standard är detta window.dataLayer.meta och i objektet meta förväntas dina data enligt nedan.
Detta är viktigt att förstå eftersom varje MetaConversion_*-regel använder den här datastrukturen för att skicka relevanta datadelar till Meta Pixel-tillägget och till Meta Conversions API. Mer information om vilka data olika metahändelser kräver finns i dokumentationen för standardhändelser.
Om du till exempel vill använda regeln MetaConversion_Subscribe måste du uppdatera window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv och window.dataLayer.meta.value enligt objektegenskaperna som beskrivs i dokumentationen för 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 genereras <datalayerpath>.conversionData.eventId 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 för dataelementet MetaConversion_DataLayer i din egenskap.
Nästa steg
I den här guiden beskrivs hur du skickar händelsedata på serversidan till Meta med tillägget Meta Conversions API. Här rekommenderas att du utökar integreringen genom att ansluta fler Pixels och dela 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 alla 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 även dessa händelser till Conversions API från serversidan.
Mer information om hur du implementerar din integrering finns i Meta-dokumentationen om bästa praxis för Conversions API. Mer allmän information om taggar och vidarebefordran av händelser i Adobe Experience Cloud finns i taggöversikten.