Ö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örhandskrav

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 Pixelfö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 datainsamling 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 facebook

Tack vare integreringen med Facebook och Instagram kan du snabbt autentisera dig i ditt Meta Business Account. Detta fyller sedan automatiskt i Pixel ID och Meta Conversion API Access Token, vilket gör det enklare att installera och konfigurera API:t för metakonvertering.

En dialogruta om att autentisera i Facebook och Instagram visas när tillägget Meta Conversions API installeras.

En dialogruta för att autentisera 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. 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ä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.

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: API-tillägg för metakonveringar (Beta) quick-start

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 Event Forwarding 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.

Om du vill installera funktionen väljer du Get Started för Send Conversions Data to Meta på sidan Adobe Experience Platform Data Collection Home.

Ange din Domain och välj sedan 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 dialogrutan Initial Setup anger du Meta Pixel ID, Meta Conversion API Access Token och Data Layer Path och väljer sedan Next.

Det tar några minuter innan den första installationsprocessen har slutförts och välj sedan Next.

I dialogrutan Add Code on Your Site kopierar du koden som har tillhandahållits med funktionen och klistrar in den i <head> på källwebbplatsen. Välj Start Validation när den är implementerad

Dialogrutan Validation Results visar metatilläggets implementeringsresultat. Välj Next. Du kan även se ytterligare valideringsresultat genom att välja länken Assurance.

Skärmbilden Next Steps bekräftar att konfigurationen 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 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

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:

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.