Meta Conversions API extensieoverzicht
De Meta Conversions API staat u toe om uw server-kant marketing gegevens aan te sluiten Meta -technologieën om uw advertentie te optimaliseren, de kosten per actie te verlagen en de resultaten te meten. Gebeurtenissen zijn gekoppeld aan een Meta Pixel ID en worden op dezelfde manier verwerkt als gebeurtenissen aan de clientzijde.
Met de Meta Conversions API kunt u de API-mogelijkheden in uw gebeurtenis doorsturen regels voor het verzenden van gegevens naar Meta van de Adobe Experience Platform Edge Network. In dit document wordt beschreven hoe u de extensie installeert en de mogelijkheden van de extensie gebruikt bij het doorsturen van gebeurtenissen regel.
Demo
De volgende video is bedoeld ter ondersteuning van uw begrip van de Meta Conversions API.
Vereisten
Het wordt sterk aanbevolen om Meta Pixel en de Conversions API om dezelfde gebeurtenissen te delen en te verzenden van respectievelijk de zijde van de client en de server, aangezien dit kan helpen gebeurtenissen te herstellen die niet zijn opgehaald door Meta Pixel. Voordat u de Conversions API voor meer informatie, raadpleegt u de handleiding op de Meta Pixel extension voor stappen over hoe te om het in uw cliënt-zijmarkeringsimplementaties te integreren.
Voor het gebruik van de Conversions API uitbreiding, moet u toegang tot gebeurtenis hebben door:sturen en een geldige Meta account met toegang tot Ad Manager en Event Manager. U moet met name de id van een bestaande id kopiëren Meta Pixel (of een nieuwe Pixel in plaats daarvan) kan de extensie worden geconfigureerd voor uw account.
De extensie installeren
Als u het dialoogvenster Meta Conversions API de extensie, navigeert u naar de gebruikersinterface van de gegevensverzameling of het Experience Platform en selecteert u Event Forwarding in de linkernavigatie. Selecteer van hieruit een eigenschap waaraan u de extensie wilt toevoegen of maak een nieuwe eigenschap.
Als u de gewenste eigenschap hebt geselecteerd of gemaakt, selecteert u Extensions in de linkernavigatie, dan selecteer Catalog tab. Zoeken naar Meta Conversions API kaart, dan selecteren Install.
In de configuratieweergave die wordt weergegeven, moet u de opdracht Pixel ID die u eerder hebt gekopieerd om de extensie te koppelen aan uw account. U kunt de id rechtstreeks in de invoer plakken, maar u kunt ook een gegevenselement gebruiken.
U moet ook een toegangstoken verstrekken om te gebruiken Conversions API specifiek. Zie de Conversions API documentatie over toegangstoken genereren voor stappen voor het verkrijgen van deze waarde.
Selecteer Save
De uitbreiding is geïnstalleerd en u kunt zijn mogelijkheden in uw gebeurtenis nu gebruiken die regels door:sturen.
Integratie met de extensie Facebook en Instagram facebook
Dankzij de integratie met de extensie Facebook en Instagram kunt u uw account snel verifiëren bij uw Meta Business-account. Dit vult dan automatisch uw Pixel ID en de Meta Conversions API Access Token, waardoor de API voor metaconversies eenvoudiger kan worden geïnstalleerd en geconfigureerd.
Er wordt een dialoogvenster weergegeven met de vraag of u de verificatie in Facebook en Instagram wilt uitvoeren. Meta Conversions API extensie.
Een dialoogvraag om in Facebook en Instagram voor authentiek te verklaren verschijnt ook in de snel startwerkschemaUI binnen gebeurtenis het door:sturen.
Integratie met Event Quality Match Score (EMQ) emq
Dankzij de integratie met de Event Quality Match Score (EMQ) kunt u de doeltreffendheid van uw implementatie eenvoudig bekijken door de EMQ-scores weer te geven. Deze integratie minimaliseert contextomschakeling en helpt u het succes van uw implementaties van Meta Conversions API verbeteren. Deze gebeurtenissencores worden weergegeven in het dialoogvenster Meta Conversions API extension configuratiescherm.
Integratie met LiveRamp (Alpha) alpha
LiveRamp klanten die LiveRampDe voor authentiek verklaarde Oplossing van het Verkeer (ATS) die op hun plaatsen wordt opgesteld kan verkiezen om RampIDs als parameter van de klanteninformatie te delen. Werk met uw Meta accountteam om deel te nemen aan het Alpha-programma voor deze functie.
Vorm een gebeurtenis door:sturen regel rule
In deze sectie wordt beschreven hoe u de Conversions API uitbreiding in een generische gebeurtenis die regel door:sturen. In de praktijk, zou u verscheidene regels moeten vormen om allen te verzenden toegelaten standaardgebeurtenissen via Meta Pixel en Conversions API. Voor mobiele toepassingsgegevens raadpleegt u de vereiste velden, toepassingsgegevensvelden, parameters voor klantgegevens en aangepaste gegevens hier.
Begin creërend een nieuwe gebeurtenis door:sturen regel en vorm zijn voorwaarden zoals gewenst. Selecteer bij het selecteren van de handelingen voor de regel de optie Meta Conversions API Extension voor de extensie selecteert u vervolgens Send Conversions API Event voor het actietype.
De controles verschijnen die u toestaan om de gebeurtenisgegevens te vormen die zullen worden verzonden naar Meta via de Conversions API. Deze opties kunnen rechtstreeks in de verstrekte input worden ingevoerd, of u kunt bestaande gegevenselementen selecteren om de waarden te vertegenwoordigen. De configuratieopties worden verdeeld in vier hoofdsecties, zoals hieronder beschreven.
Als u beide gebruikt Meta Pixel en de Conversions API om gebeurtenissen te verzenden, zorg ervoor zowel als omvat Event Name (
event_name
) en Event ID (event_id
) bij elke gebeurtenis, aangezien deze waarden worden gebruikt voor deduplicatie van gebeurtenissen.U kunt ook Enable Limited Data Use om te helpen voldoen aan de opt-outs van klanten. Zie de Conversions API documentatie over gegevensverwerkingsopties voor meer informatie over deze functie.
Voor een goede algemene API-verbinding en een hoge evenementkwaliteit (EMQ) is het raadzaam alle geaccepteerde parameters voor klantinformatie naast servergebeurtenissen. Deze parameters moeten ook prioriteit op basis van hun belang en impact op het EMQ.
Als u een aankoopgebeurtenis verzendt, moet u deze sectie gebruiken om de vereiste kenmerken op te geven
currency
en value
.Selecteer Keep Changes om de actie aan de regelconfiguratie toe te voegen.
Als u tevreden bent met de regel, selecteert u Save to Library. Ten slotte publiceert u een nieuwe gebeurtenis die wordt doorgestuurd build om de wijzigingen in de bibliotheek mogelijk te maken.
Gebeurtenisdeduplicatie deduplication
Zoals vermeld in het sectie voorwaardenwordt aangeraden beide Meta Pixel de extensie van de tag en de Conversions API gebeurtenis die uitbreiding door:sturen om de zelfde gebeurtenissen van de cliënt en de server in een overtollige opstelling te verzenden. Dit kan helpen gebeurtenissen herstellen die niet door één of andere uitbreiding werden opgepikt.
Als u verschillende gebeurtenistypen verzendt van de client en de server zonder overlapping tussen beide, is deduplicatie niet nodig. Als echter één gebeurtenis wordt gedeeld door beide Meta Pixel en de Conversions API, moet u ervoor zorgen dat deze overtollige gebeurtenissen worden gededupliceerd zodat uw rapport niet negatief wordt beïnvloed.
Wanneer u gedeelde gebeurtenissen verzendt, moet u een gebeurtenis-id en een naam opnemen voor elke gebeurtenis die u verzendt van zowel de client als de server. Wanneer meerdere gebeurtenissen met dezelfde id en naam worden ontvangen, Meta maakt automatisch gebruik van verschillende strategieën om deze te dedupliceren en de meest relevante gegevens te bewaren. Zie de Meta documentatie over deduplicatie voor Meta Pixel en Conversions API gebeurtenissen voor meer informatie over dit proces.
Snelle startworkflow: extensie voor metaconversie-API (bèta) quick-start
- De functie Snel starten is beschikbaar voor klanten die het Real-Time CDP-pakket Premier en Ultimate hebben aangeschaft. Neem contact op met uw Adobe voor meer informatie.
- Deze eigenschap is voor netto nieuwe implementaties en steunt momenteel niet auto installerende uitbreidingen en configuraties op bestaande markeringen en gebeurtenis die eigenschappen door:sturen.
- Gebruik dit als het begin van een gloednieuwe implementatie.
- Haal voordeel uit het als verwijzingsimplementatie die u kunt onderzoeken om te zien hoe het is gevormd en dan in uw huidige productieimplementaties repliceert.
Met de functie Snel starten kunt u eenvoudig en efficiënt werken met de API voor metaconversie en de Pixel-extensies Meta. Dit hulpmiddel automatiseert veelvoudige stappen die in Adobe markeringen en gebeurtenis door:sturen worden uitgevoerd, beduidend verminderend de opstellingstijd.
Deze functie installeert en configureert automatisch de API voor metaconversie en de Pixel-extensies van Meta op nieuwe automatisch gegenereerde tags en de eigenschap voor het doorsturen van gebeurtenissen met de vereiste regels en gegevenselementen. Bovendien, installeert het ook auto en vormt het Web SDK van het Experience Platform en de Datstream. Ten slotte publiceert de functie Snel starten de bibliotheek automatisch naar de opgegeven URL in een ontwikkelomgeving, zodat gegevensverzameling aan de clientzijde en gebeurtenisdoorsturen aan de serverzijde in real time mogelijk zijn via Event Forwarding en Experience Platform Edge Network.
In de volgende video wordt een inleiding gegeven op de functie Snel starten.
Snelstartfunctie installeren
Deze setup wordt automatisch uitgevoerd om zowel de API voor metaconversie als de Pixel-extensies van Meta te installeren. Deze hybride implementatie wordt aanbevolen door Meta voor het verzamelen en doorsturen van de serverzijde van de conversie van gebeurtenissen.
De snelle opstellingseigenschap wordt ontworpen om klanten te helpen met een gebeurtenis beginnen die implementatie door:sturen en is niet bedoeld om een eind aan eind te leveren, volledig functionele implementatie die alle gebruiksgevallen aanpast.
Selecteer Get Started for Send Conversions Data to Meta over de Adobe Experience Platform-gegevensverzameling Home pagina.
Voer uw Domain selecteert u vervolgens Next. Dit domein zal als noemende overeenkomst voor uw auto geproduceerde Markeringen en Gebeurtenis worden gebruikt die eigenschappen, regels, gegevenselementen, gegevensstromen, etc. door:sturen.
In de Initial Setup dialoogvenster voert uw Meta Pixel ID, Meta Conversion API Access Token, en Data Layer Path selecteert u vervolgens Next.
Wacht enkele minuten tot het initiële installatieproces is voltooid en selecteer vervolgens Next.
Van de Add Code on Your Site dialoogvenster de code kopiëren die is opgegeven met behulp van de kopie
<head>
van uw bronwebsite. Na implementatie selecteert u Start Validation
De Validation Results geeft de resultaten van de implementatie van de extensie Meta weer. Selecteren Next. U kunt ook aanvullende validatieresultaten zien door de optie Assurance koppeling.
De Next Steps schermweergave bevestigt de voltooiing van de installatie. Van hieruit hebt u de optie om uw implementatie te optimaliseren door nieuwe gebeurtenissen toe te voegen, die in de volgende sectie worden getoond.
Als u geen extra gebeurtenissen wilt toevoegen, selecteert u Close.
Extra gebeurtenissen toevoegen
Selecteer Edit Your Tags Web Property.
Selecteer de regel die overeenkomt met de meta-gebeurtenis die u wilt bewerken. Bijvoorbeeld: MetaConversion_AddToCart.
Om een gebeurtenis toe te voegen selecteer Add onder de Events kop.
Selecteer de Event Type. In dit voorbeeld hebben we de Click gebeurtenis en geconfigureerd om te activeren wanneer de .add-to-cart-button is geselecteerd. Selecteren Keep Changes.
De nieuwe gebeurtenis is opgeslagen. Selecteren Select a working library en selecteer de bibliotheek die u wilt maken.
Selecteer de vervolgkeuzelijst naast Save to Library en selecteert u Save to Library and Build. Hiermee wordt de wijziging in de bibliotheek gepubliceerd.
Herhaal deze stappen voor elke andere meta-omzettingsgebeurtenis u zou willen vormen.
Configuratie van gegevenslaag configuration
MetaConversion_* rules
. Als u de gegevens niet tussen regels bijwerkt, kunt u ook in een geval lopen waar u stapelgegevens van het laatste verzendt MetaConversion_* rule
in de huidige MetaConversion_* rule
.Tijdens de configuratie, werd u gevraagd waar uw gegevenslaag leeft. Standaard is dit window.dataLayer.meta
en binnen de meta
-object, worden uw gegevens verwacht zoals hieronder wordt weergegeven.
Dit is belangrijk om te begrijpen zoals elke MetaConversion_*
regel gebruikt deze gegevensstructuur om de relevante gegevens door te geven aan de Meta Pixel en de Meta Conversions API. Raadpleeg de documentatie bij standaardgebeurtenissen voor meer informatie over welke gegevens verschillende meta - gebeurtenissen vereisen.
Als u bijvoorbeeld de opdracht MetaConversion_Subscribe
regel, u zou moeten bijwerken window.dataLayer.meta.currency
, window.dataLayer.meta.predicted_ltv
, en window.dataLayer.meta.value
zoals beschreven in de documentatie over de objecteigenschappen standaardgebeurtenissen.
Hieronder ziet u een voorbeeld van wat er op een website moet worden uitgevoerd om de gegevenslaag bij te werken voordat de regel wordt uitgevoerd.
Standaard worden de <datalayerpath>.conversionData.eventId
wordt willekeurig gegenereerd door de actie "Nieuwe gebeurtenis-id genereren" op een van de MetaConversion_* rules
.
Voor een lokale verwijzing naar hoe de gegevenslaag zou moeten kijken, kunt u de redacteur van de douanecode op MetaConversion_DataLayer
data element on your property.
Volgende stappen
In deze handleiding wordt beschreven hoe u gebeurtenisgegevens op de server kunt verzenden naar Meta met de Meta Conversions API extensie. Het wordt aanbevolen om vanaf hier uw integratie uit te breiden door meer verbinding te maken Pixels en delen van meer gebeurtenissen, indien van toepassing. Voer een van de volgende twee handelingen uit om uw advertentieprestaties verder te verbeteren:
- Andere verbindingen maken Pixels die nog niet met een Conversions API integratie.
- Als u bepaalde gebeurtenissen uitsluitend via Meta Pixel op de client, stuur dezelfde gebeurtenissen naar de Conversions API ook aan de serverzijde.
Zie de Meta documentatie over beste praktijken voor Conversions API voor meer begeleiding over hoe te om uw integratie effectief uit te voeren. Raadpleeg voor meer algemene informatie over tags en het doorsturen van gebeurtenissen in Adobe Experience Cloud de overzicht van tags.