Meta Conversions API overzicht van extensies
Met Meta Conversions API kunt u uw marketinggegevens aan de serverzijde verbinden met 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.
Gebruikend de Meta Conversions API uitbreiding, kunt u hefboomwerking de mogelijkheden van API in uw gebeurtenis door:sturen regels om gegevens naar Meta van Adobe Experience Platform Edge Network te verzenden. Dit document behandelt hoe te om de uitbreiding te installeren en zijn mogelijkheden in een gebeurtenis te gebruiken die regel door:sturen.
Demo
De volgende video is bedoeld om uw begrip van Meta Conversions API te steunen.
Vereisten
Het wordt ten zeerste aanbevolen om Meta Pixel en Conversions API te gebruiken om dezelfde gebeurtenissen te delen en te verzenden vanaf respectievelijk de client en de server, aangezien dit ertoe kan bijdragen dat gebeurtenissen worden hersteld die niet door Meta Pixel zijn opgehaald. Alvorens de Conversions API uitbreiding te installeren, zie de gids op de Meta Pixel uitbreiding voor stappen op hoe te om het in uw cliënt-zijmarkeringsimplementaties te integreren.
Als u de extensie Conversions API wilt gebruiken, hebt u toegang tot het doorsturen van gebeurtenissen en hebt u een geldige Meta -account met toegang tot Ad Manager en Event Manager . Specifiek, moet u identiteitskaart van bestaande Meta Pixel kopiëren (of creeer een nieuw Pixel in plaats daarvan) zodat kan de uitbreiding aan uw rekening worden gevormd.
De extensie installeren
Als u de extensie Meta Conversions API wilt installeren, navigeert u naar de gebruikersinterface van de gegevensverzameling of de gebruikersinterface van 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.
Wanneer u de gewenste eigenschap hebt geselecteerd of gemaakt, selecteert u Extensions in de linkernavigatie en selecteert u vervolgens de tab Catalog . Zoek de Meta Conversions API -kaart en selecteer vervolgens Install .
In de configuratieweergave die wordt weergegeven, moet u de Pixel id opgeven 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 Conversions API specifiek te gebruiken. Verwijs naar de Conversions API documentatie over het produceren van een toegangstoken voor stappen op hoe te om deze waarde te verkrijgen.
Selecteer Save wanneer u klaar bent
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 snel verifiëren bij uw Meta Business Account. Vervolgens worden de Pixel ID en de Meta Conversions API Access Token automatisch ingevuld, zodat de Meta Conversions API eenvoudiger kan worden geïnstalleerd en geconfigureerd.
Wanneer u de extensie Meta Conversions API installeert, wordt er een dialoogvenster weergegeven waarin u wordt gevraagd om verificatie op Facebook en Instagram uit te voeren.
Er wordt ook een dialoogvenster weergegeven met de vraag of verificatie op Facebook en Instagram moet worden uitgevoerd. Dit wordt ook weergegeven in de gebruikersinterface van de snelstartworkflow wanneer gebeurtenissen worden doorgestuurd.
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 Meta Conversions API implementaties te verbeteren. Deze gebeurtenissencores worden weergegeven in het configuratiescherm van Meta Conversions API extension .
Integratie met LiveRamp (Alpha) alpha
LiveRamp klanten die LiveRamp voor authentiek verklaarde Oplossing van het Verkeer (ATS) op hun plaatsen hebben opgesteld kunnen verkiezen om RampIDs als parameter van de klanteninformatie te delen. Werk samen met uw Meta -accountteam om deel te nemen aan het Alpha-programma voor deze functie.
Vorm een gebeurtenis door:sturen regel rule
Deze sectie behandelt hoe te om de Conversions API uitbreiding in een generische gebeurtenis te gebruiken die regel door:sturen. In praktijk, zou u verscheidene regels moeten vormen om alle toegelaten standaardgebeurtenissen via Meta Pixel en Conversions API te verzenden. Voor mobiele toepassingsgegevens, gelieve te zien de vereiste gebieden, de gebieden van toepassingsgegevens, de parameters van de klanteninformatie, en de details van douanegegevens hier .
Begin creërend een nieuwe gebeurtenis door:sturen regel en vorm zijn voorwaarden zoals gewenst. Wanneer u de handelingen voor de regel selecteert, selecteert u Meta Conversions API Extension voor de extensie en selecteert u Send Conversions API Event voor het actietype.
Er worden besturingselementen weergegeven waarmee u de gebeurtenisgegevens kunt configureren die via Meta naar Conversions API worden verzonden. 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 zowel Meta Pixel als Conversions API gebruikt om gebeurtenissen te verzenden, zorg ervoor om zowel Event Name (
event_name) als Event ID (event_id) met elke gebeurtenis te omvatten, aangezien deze waarden voor gebeurtenisdeduplicatie worden gebruikt.u hebt ook de optie aan Enable Limited Data Use om te helpen aan klant opt-outs voldoen. Zie de Conversions API documentatie over gegevens verwerkend opties voor details op deze eigenschap.
om een goede gemeenschappelijke API verbinding en de hoge kwaliteit van de gebeurtenisgelijke (EMQ) te verzekeren, wordt het geadviseerd dat u alle toegelaten parameters van de klanteninformatie naast servergebeurtenissen verzendt. Deze parameters zouden ook moeten worden geprioriteerd gebaseerd op hun belang en effect op EMQ .
Als u een aankoopgebeurtenis verzendt, moet u deze sectie gebruiken om de vereiste attributen
currency en value te verstrekken.Als u klaar bent, selecteert u Keep Changes om de handeling aan de regelconfiguratie toe te voegen.
Selecteer Save to Library als u tevreden bent met de regel. Tot slot publiceer een nieuwe gebeurtenis door:sturen bouwt om de veranderingen toe te laten die aan de bibliotheek worden aangebracht.
Gebeurtenisdeduplicatie deduplication
Zoals vermeld in de eerste vereisten sectie , adviseert men dat u zowel de Meta Pixel markeringsuitbreiding als Conversions API gebeurtenis gebruikt 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 zowel Meta Pixel als Conversions API , moet u ervoor zorgen dat deze overbodige gebeurtenissen worden gededupliceerd, zodat de rapportage niet 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, gebruikt Meta automatisch verschillende strategieën om deze te dedupliceren en de meest relevante gegevens te behouden. Zie de Meta documentatie over deduplicatie voor Meta Pixel en Conversions API gebeurtenissen voor details op dit proces.
Snelle startworkflow: Meta Conversions API Extension (Beta) quick-start
- De functie Snel starten is beschikbaar voor klanten die het pakket Real-Time CDP Prime en Ultimate hebben aangeschaft. Neem contact op met uw Adobe-vertegenwoordiger 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 Meta Conversies API en de Meta Pixel-extensies. Met dit gereedschap worden meerdere stappen geautomatiseerd die worden uitgevoerd in Adobe-tags en het doorsturen van gebeurtenissen, waardoor de installatietijd aanzienlijk korter wordt.
Deze functie installeert en configureert automatisch de Meta Conversies API en de Meta Pixel-extensies op een nieuw automatisch gegenereerde tag en eigenschap voor het doorsturen van gebeurtenissen met de vereiste regels en gegevenselementen. Bovendien installeert en configureert het automatisch de Experience Platform Web SDK en DataStream. Tot slot publiceert de functie Snel starten de bibliotheek automatisch naar de opgegeven URL in een ontwikkelomgeving, waardoor 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
Om met de geleide opstelling begonnen te worden, volg de instructies in de Gebeurtenis door:sturen geleide opstelling .
Extra gebeurtenissen toevoegen
Selecteer Edit Your Tags Web Property als u nieuwe gebeurtenissen wilt toevoegen.
Selecteer de regel die overeenkomt met de meta-gebeurtenis die u wilt bewerken. Bijvoorbeeld, MetaConversion_AddToCart.
Als u een gebeurtenis wilt toevoegen, selecteert u Add onder de kop Events .
Selecteer het Event Type. In dit voorbeeld, hebben wij de Click gebeurtenis geselecteerd en het gevormd om te teweegbrengen wanneer .add-to-cart-button wordt geselecteerd. Selecteer Keep Changes.
De nieuwe gebeurtenis is opgeslagen. Selecteer Select a working library en selecteer de bibliotheek die u wilt maken.
Selecteer vervolgens de vervolgkeuzelijst naast Save to Library en selecteer 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 bijwerkt tussen regels, kunt u ook in een geval lopen waarin u gegevens van de laatste MetaConversion_* rule in de huidige MetaConversion_* rule verzendt.Tijdens de configuratie, werd u gevraagd waar uw gegevenslaag leeft. Standaard is dit window.dataLayer.meta en binnen het meta -object worden uw gegevens verwacht zoals hieronder wordt weergegeven.
Dit is belangrijk om te begrijpen, aangezien elke MetaConversion_* -regel deze gegevensstructuur gebruikt om de relevante gegevens door te geven aan de Meta Pixel -extensie en aan Meta Conversions API . Verwijs naar de documentatie over standaardgebeurtenissen voor meer informatie over welke gegevens de verschillende meta gebeurtenissen vereisen.
Bijvoorbeeld, als u de MetaConversion_Subscribe regel wilde gebruiken, zou u window.dataLayer.meta.currency moeten bijwerken, window.dataLayer.meta.predicted_ltv, en window.dataLayer.meta.value volgens de objecten eigenschappen die in de documentatie over worden beschreven 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 wordt de <datalayerpath>.conversionData.eventId willekeurig gegenereerd door de actie Nieuwe gebeurtenis-id genereren voor een van de MetaConversion_* rules .
Voor een lokale verwijzing naar hoe de gegevenslaag eruit zou moeten zien, kunt u de redacteur van de douanecode op het MetaConversion_DataLayer gegevenselement op uw bezit openen.
Volgende stappen
In deze handleiding wordt beschreven hoe u gebeurtenisgegevens aan de serverzijde naar Meta kunt verzenden met de extensie Meta Conversions API . Het wordt aanbevolen om vanaf hier uw integratie uit te breiden door meer Pixels aan te sluiten en meer gebeurtenissen te delen, indien van toepassing. Voer een van de volgende twee handelingen uit om uw advertentieprestaties verder te verbeteren:
- Sluit andere Pixels -bestanden aan die nog niet zijn verbonden met een Conversions API -integratie.
- Als u bepaalde gebeurtenissen uitsluitend via Meta Pixel op de client verzendt, moet u deze gebeurtenissen ook vanaf de server naar Conversions API verzenden.
Zie de Meta documentatie over beste praktijken voor Conversions API voor meer begeleiding op hoe te om uw integratie effectief uit te voeren. Voor meer algemene informatie over markeringen en gebeurtenis die in Adobe Experience Cloud door:sturen, verwijs naar het overzicht van markeringen .