Meta Conversions API - Übersicht
Mit dem Meta Conversions API können Sie Ihre Server-seitigen Marketing-Daten mit Meta Technologien verbinden, um Ihr Anzeigen-Targeting zu optimieren, Kosten pro Aktion zu senken und Ergebnisse zu messen. Ereignisse sind mit einer Meta Pixel-ID verknüpft und werden auf ähnliche Weise wie Client-seitige Ereignisse verarbeitet.
Mit der Meta Conversions API-Erweiterung können Sie die Funktionen der API in Ihren Regeln Ereignisweiterleitung nutzen, um Daten aus Adobe Experience Platform Edge Network an Meta zu senden. In diesem Dokument wird beschrieben, wie Sie die Erweiterung installieren und ihre Funktionen in einer Ereignisweiterleitungsregel () .
Demo
Im folgenden Video werden die Meta Conversions API erklärt.
Voraussetzungen
Es wird dringend empfohlen, Meta Pixel und den Conversions API zu verwenden, um dieselben Ereignisse von der Client- bzw. Serverseite freizugeben und zu senden, da dies dazu beitragen kann, Ereignisse wiederherzustellen, die von Meta Pixel nicht erfasst wurden. Bevor Sie die Conversions API-Erweiterung installieren, lesen Sie das Handbuch unter Meta Pixel Erweiterung , um Anweisungen zur Integration in Ihre Client-seitigen Tag-Implementierungen zu erhalten.
Um die Conversions API-Erweiterung verwenden zu können, müssen Sie Zugriff auf die Ereignisweiterleitung haben und über ein gültiges Meta mit Zugriff auf Ad Manager und Event Manager verfügen. Insbesondere müssen Sie die ID einer vorhandenen Meta Pixel kopieren (oder stattdessen eine neue erstellen Pixel, damit die Erweiterung für Ihr Konto konfiguriert werden kann.
Installieren der Erweiterung
Um die Meta Conversions API zu installieren, navigieren Sie zur Datenerfassungs-Benutzeroberfläche oder zur Experience Platform-Benutzeroberfläche und wählen Sie linken Navigationsbereich Ereignisweiterleitung“. Wählen Sie hier eine Eigenschaft aus, der die Erweiterung hinzugefügt werden soll, oder erstellen Sie stattdessen eine neue Eigenschaft.
Nachdem Sie die gewünschte Eigenschaft ausgewählt oder erstellt haben, klicken Sie im linken auf Erweiterungen und wählen Sie dann die Registerkarte Katalog aus. Suchen Sie nach der Karte Meta Conversions API und wählen Sie dann Installieren.
In der angezeigten Konfigurationsansicht müssen Sie die zuvor kopierte Pixel-ID angeben, um die Erweiterung mit Ihrem Konto zu verknüpfen. Sie können die ID direkt in die Eingabe einfügen oder stattdessen ein Datenelement verwenden.
Sie müssen auch ein Zugriffstoken angeben, um die Conversions API spezifisch zu verwenden. Anweisungen zum Abrufen dieses Werts finden Sie in der Conversions API- unter eines Zugriffstokens .
Klicken Sie abschließend auf Speichern
Die Erweiterung ist installiert und Sie können jetzt ihre Funktionen in Ihren Ereignisweiterleitungsregeln verwenden.
Integration mit der Facebook- und Instagram-Erweiterung facebook
Durch die Integration mit der Facebook- und Instagram-Erweiterung können Sie sich schnell bei Ihrem Meta Business-Konto authentifizieren. Dadurch werden Ihre Pixel-ID und die Meta Conversions-API Zugriffstoken automatisch ausgefüllt, was die Installation und Konfiguration der Meta Conversions-API erleichtert.
Bei der Installation der Erweiterung Meta Conversions API wird eine Dialogaufforderung zur Authentifizierung in Facebook und Instagram angezeigt.
Eine Dialogaufforderung zur Authentifizierung in Facebook und Instagram wird auch in der Benutzeroberfläche des Schnellstart-Workflows bei der Ereignisweiterleitung angezeigt.
Integration mit dem Event Quality Match Score (EMQ) emq
Die Integration mit dem Event Quality Match Score (EMQ) ermöglicht es Ihnen, die Effektivität Ihrer Implementierung einfach durch die Anzeige von EMQ-Bewertungen zu überprüfen. Diese Integration minimiert den Kontextwechsel und hilft Ihnen, den Erfolg Ihrer Meta Conversions-API-Implementierungen zu verbessern. Diese Ereigniswerte werden im Konfigurationsbildschirm der Erweiterung der Meta ConversionsAPI angezeigt.
Integration mit LiveRamp (Alpha) alpha
LiveRamp Kunden, die die Authentication Traffic Solution (ATS) von LiveRamp auf ihren Sites bereitgestellt haben, können sich dafür entscheiden, RampIDs als Kundeninformationsparameter freizugeben. Bitte wenden Sie sich an Ihr Meta-Account-Team, um am Alpha-Programm für diese Funktion teilzunehmen.
Konfigurieren einer Ereignisweiterleitungsregel rule
In diesem Abschnitt wird beschrieben, wie Sie die Conversions API-Erweiterung in einer generischen Ereignisweiterleitungsregel verwenden. In der Praxis sollten Sie mehrere Regeln konfigurieren, um alle akzeptierten Standardereignisse über Meta Pixel und Conversions API zu senden. Informationen zu Mobile-App-Daten finden Sie in den Pflichtfeldern, App-Datenfeldern, Kundeninformationsparametern und Details zu benutzerdefinierten Daten hier.
Beginnen Sie mit der Erstellung einer neuen Ereignisweiterleitungsregel und konfigurieren Sie deren Bedingungen nach Bedarf. Wählen Sie bei der Auswahl der Aktionen für die Regel Meta Conversions API Extension für die Erweiterung und wählen Sie dann Send Conversions API Event für den Aktionstyp.
Es werden Steuerelemente angezeigt, mit denen Sie die Ereignisdaten konfigurieren können, die über die Conversions API an Meta gesendet werden. Diese Optionen können direkt in die bereitgestellten Eingaben eingegeben werden oder Sie können stattdessen vorhandene Datenelemente zur Darstellung der Werte auswählen. Die Konfigurationsoptionen sind wie unten beschrieben in vier Hauptabschnitte unterteilt.
Wenn Sie sowohl Meta Pixel als auch Conversions API zum Senden von Ereignissen verwenden, stellen Sie sicher, dass Sie sowohl Ereignisname (
event_name) als auch Ereignis-ID (event_id) in jedes Ereignis einbeziehen, da diese Werte für die Ereignisdeduplizierung verwendet werden.Sie haben auch die Option Eingeschränkte Datennutzung aktivieren, um Kunden-Opt-outs einzuhalten. Einzelheiten zu dieser Funktion finden Sie in der Conversions API Datenverarbeitungsoptionen.
Um eine gute gemeinsame API-Verbindung und eine hohe Ereignisabgleichqualität (Event Match Quality, EMQ) sicherzustellen, wird empfohlen, alle akzeptierten Kundeninformationsparameter“ zusammen mit -Serverereignissen zu senden. Diese Parameter sollten ebenfalls priorisiert werden basierend auf ihrer Bedeutung und ihren Auswirkungen auf den EMQ.
Wenn Sie ein Kaufereignis senden, müssen Sie diesen Abschnitt verwenden, um die erforderlichen Attribute
currency und value anzugeben.Wenn Sie fertig sind, wählen Änderungen beibehalten, um die Aktion zur Regelkonfiguration hinzuzufügen.
Wenn Sie mit der Regel zufrieden sind, wählen Sie In Bibliothek speichern aus. Veröffentlichen Sie abschließend eine neue Ereignisweiterleitung build, um die an der Bibliothek vorgenommenen Änderungen zu aktivieren.
Ereignis-Deduplizierung deduplication
Wie im Abschnitt Voraussetzungen erwähnt, wird empfohlen, sowohl die Meta Pixel Tag-Erweiterung als auch die Conversions API Ereignisweiterleitungserweiterung zu verwenden, um dieselben Ereignisse vom Client und Server in einer redundanten Einrichtung zu senden. Dies kann beim Wiederherstellen von Ereignissen helfen, die von der einen oder anderen Erweiterung nicht aufgenommen wurden.
Wenn Sie verschiedene Ereignistypen vom Client und Server senden, ohne dass sich diese überschneiden, ist keine Deduplizierung erforderlich. Wenn jedoch ein einzelnes Ereignis sowohl von Meta Pixel als auch von der Conversions API gemeinsam verwendet wird, müssen Sie sicherstellen, dass diese redundanten Ereignisse dedupliziert werden, damit Ihr Reporting nicht beeinträchtigt wird.
Stellen Sie beim Senden von freigegebenen Ereignissen sicher, dass Sie zu jedem Ereignis, das Sie sowohl vom Client als auch vom Server senden, eine Ereignis-ID und einen Namen hinzufügen. Wenn mehrere Ereignisse mit derselben ID und demselben Namen empfangen werden, wendet Meta automatisch mehrere Strategien an, um sie zu deduplizieren und die relevantesten Daten zu speichern. Weitere Informationen zu diesem Prozess finden Sie in der Meta Deduplizierung für Meta Pixel und Conversions API Ereignisse.
Schnellstart-Workflow: Meta Conversions-API-Erweiterung (Beta) quick-start
- Die Schnellstartfunktion steht Kunden zur Verfügung, die das Real-Time CDP Prime- und Ultimate-Paket erworben haben. Bitte wenden Sie sich an den Adobe-Support, um weitere Informationen zu erhalten.
- Diese Funktion ist für neue Implementierungen vorgesehen und unterstützt derzeit nicht die automatische Installation von Erweiterungen und Konfigurationen für vorhandene Tags und Ereignisweiterleitungseigenschaften.
- Verwenden Sie sie als Beginn einer völlig neuen Implementierung.
- Nutzen Sie diese als Referenzimplementierung, um zu sehen, wie sie konfiguriert wurde, und replizieren Sie sie dann in Ihren aktuellen Produktionsimplementierungen.
Die Schnellstartfunktion erleichtert und vereinfacht die Einrichtung mit der Meta Conversions-API und den Meta Pixel Extensions. Dieses Tool automatisiert mehrere Schritte, die in Adobe-Tags und in der Ereignisweiterleitung ausgeführt werden, wodurch die Einrichtungszeit erheblich verkürzt wird.
Diese Funktion installiert und konfiguriert automatisch sowohl die Meta Conversions-API als auch die Meta-Pixelerweiterungen für eine neu automatisch generierte Tag- und Ereignisweiterleitungseigenschaft mit den erforderlichen Regeln und Datenelementen. Darüber hinaus werden Experience Platform Web SDK und Datenstrom automatisch installiert und konfiguriert. Schließlich veröffentlicht die Schnellstart-Funktion die Bibliothek automatisch in der angegebenen URL in einer Entwicklungsumgebung, was die Client-seitige Datenerfassung und Server-seitige Ereignisweiterleitung in Echtzeit über die Ereignisweiterleitung und Experience Platform Edge Network ermöglicht.
Das folgende Video bietet eine Einführung in die Schnellstart-Funktion.
Schnellstartfunktion installieren
Um mit dem geführten Setup zu beginnen, befolgen Sie die Anweisungen im Geführte Einrichtung zur Ereignisweiterleitung.
Hinzufügen zusätzlicher Ereignisse
Um neue Ereignisse hinzuzufügen, wählen Sie Bearbeiten Ihrer Tags-Web-Eigenschaft aus.
Wählen Sie die Regel aus, die dem Metaereignis entspricht, das Sie bearbeiten möchten. Beispiel: MetaConversion_AddToCart.
Um ein Ereignis hinzuzufügen, wählen Sie Hinzufügen unter der Überschrift Ereignisse aus.
Wählen Sie den Ereignistyp aus. In diesem Beispiel haben wir das Click-Ereignis ausgewählt und es so konfiguriert, dass es bei Auswahl der Schaltfläche .Zum Warenkorb hinzufügen zu einem Trigger wird. Wählen Sie Änderungen beibehalten aus.
Das neue Ereignis wurde gespeichert. Wählen Sie Arbeitsbibliothek auswählen und wählen Sie die Bibliothek aus, die Sie erstellen möchten.
Wählen Sie anschließend das Dropdown-Menü neben In Bibliothek speichern und wählen Sie In Bibliothek speichern und. Dadurch wird die Änderung in der Bibliothek veröffentlicht.
Wiederholen Sie diese Schritte für jedes andere Meta-Konversionsereignis, das Sie konfigurieren möchten.
Konfiguration der Datenschicht configuration
MetaConversion_* rules aktualisiert werden. Wenn Sie die Daten zwischen den Regeln nicht aktualisieren, können Sie auch auf einen Fall stoßen, in dem Sie veraltete Daten aus dem letzten MetaConversion_* rule im aktuellen MetaConversion_* rule senden.Während der Konfiguration wurden Sie gefragt, wo Ihre Datenschicht lebt. Standardmäßig ist dies window.dataLayer.meta und innerhalb des meta werden Ihre Daten erwartet, wie unten dargestellt.
Dies ist wichtig, da jede MetaConversion_* diese Datenstruktur verwendet, um die relevanten Datenelemente an die Meta Pixel und an die Meta Conversions API zu übergeben. Weitere Informationen dazu, welche Daten für verschiedene -Ereignisse erforderlich sind, finden in der Dokumentation unter „Standardereignisse“.
Wenn Sie beispielsweise die MetaConversion_Subscribe verwenden möchten, müssen Sie window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv und window.dataLayer.meta.value gemäß den Objekteigenschaften aktualisieren, die in der Dokumentation unter "" beschrieben .
Nachfolgend finden Sie ein Beispiel dafür, was auf einer Website ausgeführt werden muss, um die Datenschicht zu aktualisieren, bevor die Regel ausgeführt wird.
Standardmäßig wird die <datalayerpath>.conversionData.eventId zufällig durch die Aktion „Neue Ereignis-ID generieren“ auf einem der MetaConversion_* rules generiert.
Als lokale Referenz dazu, wie die Datenschicht aussehen sollte, können Sie den Editor für benutzerdefinierten Code im MetaConversion_DataLayer Datenelement in Ihrer Eigenschaft öffnen.
Nächste Schritte
In diesem Handbuch wurde beschrieben, wie Sie Server-seitige Ereignisdaten mithilfe der Meta Conversions API-Erweiterung an Meta senden. Von hier aus wird empfohlen, Ihre Integration zu erweitern, indem Sie weitere Pixels verbinden und ggf. weitere Ereignisse freigeben. Die Durchführung der folgenden Schritte kann dazu beitragen, die Leistung Ihrer Anzeige weiter zu verbessern:
- Verbinden Sie alle anderen Pixels, die noch nicht mit einer Conversions API-Integration verbunden sind.
- Wenn Sie bestimmte Ereignisse ausschließlich über Meta Pixel auf der Client-Seite senden, senden Sie dieselben Ereignisse auch von der Server-Seite an die Conversions API.
Weitere Anleitungen zur effektiven Implementierung Integration finden Sie in der Meta Dokumentation Conversions APIBest Practices für die ). Weitere allgemeine Informationen zu Tags und zur Ereignisweiterleitung in Adobe CX Enterprise finden Sie unter Tags - Übersicht.