Übersicht über die Meta Conversions API-Erweiterung
Mit dem Meta Conversions API können Sie Ihre Server-seitigen Marketing-Daten mit Meta -Technologien verbinden, um Ihr Anzeigen-Targeting zu optimieren, die Kosten pro Aktion zu senken und die Ergebnisse zu messen. Ereignisse sind mit einer Meta Pixel -ID verknüpft und werden ähnlich wie clientseitige Ereignisse verarbeitet.
Mithilfe der Erweiterung Meta Conversions API können Sie die API-Funktionen in Ihren Regeln zur Ereignisweiterleitung nutzen, um Daten vom Adobe Experience Platform-Edge Network an Meta zu senden. In diesem Dokument wird beschrieben, wie Sie die Erweiterung installieren und ihre Funktionen in der Ereignisweiterleitung Regel verwenden.
Demo
Das folgende Video soll Ihr Verständnis von Meta Conversions API unterstützen.
Voraussetzungen
Es wird dringend empfohlen, Meta Pixel und Conversions API zu verwenden, um dieselben Ereignisse vom Client- bzw. vom Server-seitigen Ereignis freizugeben und zu senden, da dies dazu beitragen kann, Ereignisse wiederherzustellen, die nicht von Meta Pixel erfasst wurden. Anweisungen zur Integration in Ihre clientseitigen Tag-Implementierungen finden Sie im Handbuch zur Meta Pixel Erweiterung , bevor Sie die Erweiterung Conversions API installieren.
Um die Erweiterung Conversions API verwenden zu können, müssen Sie Zugriff auf die Ereignisweiterleitung haben und über ein gültiges Meta-Konto mit Zugriff auf Ad Manager und Event Manager verfügen. Insbesondere müssen Sie die ID eines vorhandenen Meta Pixel kopieren (oder stattdessen einen neuen Pixel erstellen), damit die Erweiterung für Ihr Konto konfiguriert werden kann.
Installieren der Erweiterung
Um die Erweiterung Meta Conversions API zu installieren, navigieren Sie zur Benutzeroberfläche für Datenerfassung oder Experience Platform und wählen Sie im linken Navigationsbereich die Option Ereignisweiterleitung 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, wählen Sie im linken Navigationsbereich Erweiterungen und dann die Registerkarte Katalog aus. Suchen Sie nach der Karte Metadaten-API und wählen Sie dann Installieren aus.
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 außerdem ein Zugriffstoken bereitstellen, um speziell das Conversions API zu verwenden. Anweisungen zum Abrufen dieses Werts finden Sie in der Dokumentation zu Conversions API unter Generieren eines Zugriffstokens .
Wählen Sie abschließend Speichern 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 Zugriffs-Token automatisch ausgefüllt, was die Installation und Konfiguration der Meta Conversions-API erleichtert.
Bei der Installation der Erweiterung Meta Conversions API wird eine Dialogfeldmeldung zur Authentifizierung in Facebook und Instagram angezeigt.
Eine Dialogaufforderung zur Authentifizierung in Facebook und Instagram wird auch in der Schnellstart-Workflow-Benutzeroberfläche bei der Ereignisweiterleitung angezeigt.
Integration mit der Ereignisqualitätsübereinstimmung (EMQ) emq
Durch die Integration mit der Ereignisqualitäts-Match-Bewertung (EMQ) können Sie die Effektivität Ihrer Implementierung einfach anzeigen, indem Sie EMQ-Bewertungen anzeigen. Diese Integration minimiert das Wechseln des Kontexts und hilft Ihnen, den Erfolg Ihrer Meta Conversions API-Implementierungen zu verbessern. Diese Ereignisbewertungen werden im Konfigurationsbildschirm der Meta Conversions API-Erweiterung angezeigt.
hervorgehoben wird.
Integration mit LiveRamp (Alpha) alpha
LiveRamp Kunden, die die authentifizierte Traffic-Lösung (ATS) von LiveRamp auf ihren Sites bereitgestellt haben, können sich dafür entscheiden, RampIDs als Kundendatenparameter freizugeben. Wenden Sie sich an Ihr Meta -Account-Team, um dem Alpha-Programm für diese Funktion beizutreten.
Konfigurieren einer Ereignisweiterleitungsregel rule
In diesem Abschnitt wird beschrieben, wie Sie die Erweiterung Conversions API in einer allgemeinen 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 erforderlichen Feldern, Feldern für App-Daten, Parametern für Kundeninformationen und benutzerdefinierten Datendetails 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 Metadaten-API-Erweiterung für die Erweiterung und dann für den Aktionstyp Konversions-API-Ereignis senden aus.
Es werden Steuerelemente angezeigt, mit denen Sie die Ereignisdaten konfigurieren können, die über den Conversions API an Meta gesendet werden. Diese Optionen können direkt in die bereitgestellten Eingaben eingegeben werden oder Sie können vorhandene Datenelemente auswählen, um die Werte stattdessen darzustellen. 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 einen Ereignisnamen (
event_name
) als auch eine Ereignis-ID (event_id
) einschließen, da diese Werte für die Ereignisdeduplizierung verwendet werden.Sie haben auch die Option Eingeschränkte Datenverwendung aktivieren , um die Einhaltung von Kunden-Opt-outs zu unterstützen. Weitere Informationen zu dieser Funktion finden Sie in der Dokumentation zu Conversions API zu den Datenverarbeitungsoptionen .
Um eine gute gemeinsame API-Verbindung und eine hohe EMQ-Qualität (Event Match Quality) sicherzustellen, wird empfohlen, alle akzeptierten Parameter für Kundeninformationen zusammen mit Serverereignissen zu senden. Diese Parameter sollten auch entsprechend ihrer Bedeutung und Auswirkung auf EMQ priorisiert werden.
Wenn Sie ein Kaufereignis senden, müssen Sie in diesem Abschnitt die erforderlichen Attribute
currency
und value
angeben.Wählen Sie nach Abschluss Änderungen beibehalten aus, 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.
Ereignisdeduplizierung deduplication
Wie im Abschnitt Voraussetzungenerwähnt, wird empfohlen, sowohl die Tag-Erweiterung Meta Pixel als auch die Ereignisweiterleitungs-Erweiterung Conversions API zu verwenden, um dieselben Ereignisse vom Client und Server in einem redundanten Setup zu senden. Dies kann dazu beitragen, Ereignisse wiederherzustellen, die nicht von der einen oder anderen Erweiterung erfasst wurden.
Wenn Sie verschiedene Ereignistypen vom Client und Server senden, ohne dass sich die beiden überschneiden, ist keine Deduplizierung erforderlich. Wenn jedoch ein einzelnes Ereignis sowohl von Meta Pixel als auch von Conversions API freigegeben wird, müssen Sie sicherstellen, dass diese redundanten Ereignisse dedupliziert werden, damit Ihre Berichterstellung nicht beeinträchtigt wird.
Stellen Sie beim Senden von freigegebenen Ereignissen sicher, dass Sie eine Ereignis-ID und einen Namen mit jedem Ereignis einbeziehen, das Sie vom Client und vom Server senden. Wenn mehrere Ereignisse mit derselben ID und demselben Namen empfangen werden, verwendet Meta automatisch mehrere Strategien, um sie zu deduplizieren und die relevantesten Daten beizubehalten. Weitere Informationen zu diesem Prozess finden Sie in der Dokumentation Meta zu Deduplizierung für Meta Pixel und Conversions API Ereignisse .
Schnellstart-Workflow: Metadaten-Konversions-API-Erweiterung (Beta) quick-start
- Die Schnellstartfunktion steht Kunden zur Verfügung, die das Real-Time CDP Prime- und Ultimate-Package erworben haben. Bitte wenden Sie sich an den Adobe-Support-Mitarbeiter, um weitere Informationen zu erhalten.
- Diese Funktion ist für neue Netto-Implementierungen vorgesehen und unterstützt derzeit nicht die automatische Installation von Erweiterungen und Konfigurationen für vorhandene Tags und Ereignisweiterleitungseigenschaften.
- Verwenden Sie ihn als Beginn einer brandneuen Implementierung.
- Nutzen Sie ihn als Referenzimplementierung, die Sie untersuchen können, um zu sehen, wie er konfiguriert wurde, und dann in Ihren aktuellen Produktionsimplementierungen replizieren können.
Mit der Schnellstartfunktion können Sie mit der Meta-Konversions-API und den Meta-Pixel-Erweiterungen einfach und effizient einrichten. Dieses Tool automatisiert mehrere Schritte, die in Adobe-Tags und 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-Pixel-Erweiterungen für neu automatisch generierte Tags und die Ereignisweiterleitungs-Eigenschaft mit den erforderlichen Regeln und Datenelementen. Außerdem werden das Experience Platform Web SDK und Datastream automatisch installiert und konfiguriert. Schließlich veröffentlicht die Schnellstartfunktion die Bibliothek automatisch in der angegebenen URL in einer Entwicklungsumgebung, was die clientseitige Datenerfassung und die serverseitige Ereignisweiterleitung über die Ereignisweiterleitung und das Experience Platform-Edge Network in Echtzeit ermöglicht.
Das folgende Video bietet eine Einführung in die Schnellstarterfunktion.
Schnellstartfunktion installieren
Bei diesem Setup werden sowohl die Meta Conversions-API als auch die Meta Pixel-Erweiterungen automatisch installiert. Diese Hybridimplementierung wird von Meta empfohlen, um serverseitige Ereigniskonversionen zu erfassen und weiterzuleiten.
Die schnelle Setup-Funktion soll Kunden bei den ersten Schritten mit der Implementierung der Ereignisweiterleitung unterstützen und soll keine vollständige Implementierung liefern, die alle Anwendungsfälle berücksichtigt.
Um die Funktion zu installieren, wählen Sie auf der Adobe Experience Platform-Datenerfassungsseite Startseite die Option Erste Schritte für Send Conversions Data to Meta aus.
Geben Sie Ihre Domäne ein und wählen Sie dann Weiter aus. Diese Domäne wird als Namenskonvention für automatisch generierte Tags und Ereignisweiterleitungseigenschaften, Regeln, Datenelemente, Datenspeicher usw. verwendet.
Geben Sie im Dialogfeld Ersteinrichtung Ihre Meta Pixel ID, den Metadaten-API-Zugriffstoken und den Datenschichtpfad ein und wählen Sie dann Weiter aus.
Warten Sie einige Minuten, bis der anfängliche Einrichtungsprozess abgeschlossen ist, und wählen Sie dann Weiter aus.
Kopieren Sie im Dialogfeld Code für Ihre Site hinzufügen den Code, der mit der Kopieren-Funktion
bereitgestellt wird, und fügen Sie ihn in den Abschnitt <head>
Ihrer Quellwebsite ein. Wählen Sie nach der Implementierung Validierung starten
Im Dialogfeld Überprüfungsergebnisse werden die Ergebnisse der Implementierung der Meta-Erweiterung angezeigt. Wählen Sie Weiter aus. Sie können auch zusätzliche Überprüfungsergebnisse anzeigen, indem Sie den Link Zuverlässigkeit auswählen.
Dialogfeld
Die Anzeige Nächste Schritte 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 Schließen aus.
Hinzufügen zusätzlicher Ereignisse
Um neue Ereignisse hinzuzufügen, wählen Sie Webeigenschaft für Tags bearbeiten aus.
Wählen Sie die Regel aus, die dem Meta-Ereignis 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 Ereignis Klick ausgewählt und für den Trigger konfiguriert, wenn die Schaltfläche .add-to-cart-button ausgewählt wird. Wählen Sie Änderungen beibehalten aus.
Das neue Ereignis wurde gespeichert. Wählen Sie Eine Arbeitsbibliothek auswählen und wählen Sie die Bibliothek aus, die Sie erstellen möchten.
Wählen Sie als Nächstes das Dropdown-Menü neben In Bibliothek speichern und dann In Bibliothek speichern und erstellen. Dadurch wird die Änderung in der Bibliothek veröffentlicht.
Wiederholen Sie diese Schritte für jedes andere Meta-Konversionsereignis, das Sie konfigurieren möchten.
Datenschichtkonfiguration 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 den letzten MetaConversion_* rule
im aktuellen MetaConversion_* rule
senden.Während der Konfiguration wurden Sie gefragt, wo sich Ihre Datenschicht befindet. Standardmäßig ist dies window.dataLayer.meta
. Innerhalb des meta
-Objekts werden Ihre Daten erwartet, wie unten dargestellt.
Dies ist wichtig, da jede MetaConversion_*
-Regel diese Datenstruktur verwendet, um die relevanten Datenteile an die Meta Pixel -Erweiterung und an die Meta Conversions API zu übergeben. Weitere Informationen dazu, welche Daten für verschiedene Meta-Ereignisse erforderlich sind, finden Sie in der Dokumentation zu Standardereignissen .
Wenn Sie beispielsweise die Regel MetaConversion_Subscribe
verwenden möchten, müssen Sie window.dataLayer.meta.currency
, window.dataLayer.meta.predicted_ltv
und window.dataLayer.meta.value
entsprechend den Objekteigenschaften aktualisieren, die in der Dokumentation zu Standardereignissen beschrieben sind.
Im Folgenden 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 von der Aktion "Neue Ereignis-ID generieren"für eine der MetaConversion_* rules
generiert.
Um eine lokale Referenz dazu zu erhalten, wie die Datenschicht aussehen soll, können Sie den Editor für benutzerdefinierten Code im Datenelement MetaConversion_DataLayer
in Ihrer Eigenschaft öffnen.
Nächste Schritte
In diesem Handbuch wurde beschrieben, wie serverseitige Ereignisdaten mit der Erweiterung Meta Conversions API an Meta gesendet werden. Von hier aus wird empfohlen, Ihre Integration zu erweitern, indem mehr Pixels verbunden und ggf. weitere Ereignisse freigegeben werden. Eine der folgenden Maßnahmen kann dazu beitragen, Ihre Anzeigenleistung 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 Client-Seite senden, senden Sie diese Ereignisse auch vom Server-seitigen an den Conversions API.
Weitere Anleitungen zur effektiven Implementierung Ihrer Integration finden Sie in der Meta -Dokumentation zu den Best Practices für den Conversions API . Allgemeine Informationen zu Tags und zur Ereignisweiterleitung in Adobe Experience Cloud finden Sie in der Tag-Übersicht .