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 Event Forwarding in der linken Navigationsleiste aus. 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 Navigationsbereich auf Extensions und wählen Sie dann die Registerkarte Catalog aus. Suchen Sie nach der Karte Meta Conversions API und klicken Sie dann auf Install.
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 .
Wenn Sie fertig sind, wählen Sie Save aus
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-Access Token automatisch ausgefüllt, was die Installation und Konfiguration der Meta Conversions-API vereinfacht.
Bei der Installation der Meta Conversions API-Erweiterung 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 Ereignisbewertungen werden im Bildschirm Meta Conversions API extension 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 aus.
Es werden Steuerelemente angezeigt, mit denen Sie die Ereignisdaten konfigurieren können, die über die Meta an Conversions API 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 die Conversions API zum Senden von Ereignissen verwenden, stellen Sie sicher, dass Sie bei jedem Ereignis sowohl eine Event Name (
event_name) als auch eine Event ID (event_id) einbeziehen, da diese Werte für die Ereignis-Deduplizierung.Sie haben auch die Möglichkeit, bei der Einhaltung von Kunden-Opt-outs zu Enable Limited Data Use. 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, dass Sie alle akzeptierten Kundeninformationsparameter zusammen mit Serverereignissen 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 Sie Keep Changes aus, um die Aktion zur Regelkonfiguration hinzuzufügen.
Wenn Sie mit der Regel zufrieden sind, wählen Sie Save to Library 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-Mitarbeiter, 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
Mit diesem Setup werden automatisch sowohl die Meta Conversions-API als auch die Meta Pixel Extensions installiert. Diese Hybridimplementierung wird von Meta zur Server-seitigen Erfassung und Weiterleitung von Ereigniskonversionen empfohlen.
Die Funktion für die Schnelleinrichtung soll Kundinnen und Kunden bei den ersten Schritten mit einer Implementierung der Ereignisweiterleitung unterstützen und soll keine durchgängige, voll funktionsfähige Implementierung bereitstellen, die alle Anwendungsfälle berücksichtigt.
Um die Funktion zu installieren, wählen Sie Get Started zur Send Conversions Data to Meta auf der Seite Datenerfassungs-Home von Adobe Experience Platform aus.
Geben Sie Ihre Domain ein und wählen Sie dann Next aus. Diese Domain wird als Namenskonvention für Ihre automatisch generierten Tags und Eigenschaften der Ereignisweiterleitung, Regeln, Datenelemente, Datenströme usw. verwendet.
Geben Sie im Dialogfeld Initial Setup Ihre Meta Pixel ID, Meta Conversion API Access Token und Data Layer Path ein und wählen Sie dann Next aus.
Warten Sie einige Minuten, bis der anfängliche Einrichtungsprozess abgeschlossen ist, und wählen Sie dann Next aus.
Kopieren Sie im Dialogfeld Add Code on Your Site den mit der Funktion
<head> Ihrer Quell-Website ein. Wählen Sie nach der Implementierung Start Validation aus
Im Dialogfeld Validation Results werden die Ergebnisse der Implementierung der Meta-Erweiterung angezeigt. Wählen Sie Next aus. Sie können auch zusätzliche Validierungsergebnisse anzeigen, indem Sie auf den Link Assurance klicken.
Die Next Steps bestätigt den Abschluss des Setups. Von hier aus haben Sie die Möglichkeit, Ihre Implementierung zu optimieren, indem Sie neue Ereignisse hinzufügen, die im nächsten Abschnitt angezeigt werden.
Wenn Sie keine zusätzlichen Ereignisse hinzufügen möchten, wählen Sie Close aus.
Hinzufügen zusätzlicher Ereignisse
Um neue Ereignisse hinzuzufügen, wählen Sie Edit Your Tags Web Property 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 Add unter der Überschrift Events aus.
Wählen Sie die Event Type aus. In diesem Beispiel haben wir das Click-Ereignis ausgewählt und es so konfiguriert, dass es zu Trigger wird, wenn die Schaltfläche .Zum Warenkorb hinzufügen ausgewählt wird. Wählen Sie Keep Changes aus.
Das neue Ereignis wurde gespeichert. Wählen Sie Select a working library und dann die Bibliothek aus, die Sie erstellen möchten.
Wählen Sie als Nächstes das Dropdown-Menü neben Save to Library aus und klicken Sie auf Save to Library and Build. 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-Erweiterung an Meta Conversions API 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 Meta Integration finden Sie in der Dokumentation Conversions APIBest Practices für die ). Weitere allgemeine Informationen zu Tags und zur Ereignisweiterleitung in Adobe Experience Cloud finden Sie unter Tags - Übersicht.