Meta Conversions API Erweiterungsübersicht

Die Meta Conversions API ermöglicht es Ihnen, Ihre Server-seitigen Marketing-Daten mit Meta Technologien zur Optimierung Ihres Anzeigen-Targeting, Senkung der Kosten pro Aktion und Messung der Ergebnisse. Ereignisse sind mit einer Meta Pixel ID und werden ähnlich wie clientseitige Ereignisse verarbeitet.

Verwenden der Meta Conversions API -Erweiterung verwenden, können Sie die API-Funktionen in Ihrer Ereignisweiterleitung Regeln zum Senden von Daten an Meta vom Adobe Experience Platform-Edge Network aus. In diesem Dokument wird beschrieben, wie Sie die Erweiterung installieren und ihre Funktionen in der Ereignisweiterleitung verwenden. Regel.

Demo

Das folgende Video soll Ihr Verständnis der Meta Conversions API.

Voraussetzungen

Es wird dringend empfohlen Meta Pixel und Conversions API , um dieselben Ereignisse vom Client- bzw. vom Server-seitigen freizugeben und zu senden, da dies dazu beitragen kann, Ereignisse wiederherzustellen, die nicht von abgerufen wurden. Meta Pixel. Vor der Installation Conversions API -Erweiterung, siehe Handbuch im Meta Pixel Erweiterung für Schritte zur Integration in Ihre clientseitigen Tag-Implementierungen.

NOTE
Der Abschnitt zu Ereignisdeduplizierung weiter unten in diesem Dokument die Schritte beschrieben, um sicherzustellen, dass dasselbe Ereignis nicht zweimal verwendet wird, da es sowohl vom Browser als auch vom Server empfangen werden kann.

Um die Conversions API -Erweiterung, müssen Sie Zugriff auf die Ereignisweiterleitung haben und über eine gültige Meta Konto mit Zugriff auf Ad Manager und Event Manager. Insbesondere müssen Sie die Kennung eines vorhandenen Meta Pixel (oder Erstellen Sie eine neue Pixel ), damit die Erweiterung für Ihr Konto konfiguriert werden kann.

INFO
Wenn Sie diese Erweiterung mit App-Daten verwenden möchten oder wenn Sie auch mit Offline-Ereignisdaten in Ihrer Meta Kampagnen erstellen, müssen Sie Ihren Datensatz über eine vorhandene App erstellen und Aus einer Pixel-ID erstellen angezeigt. Siehe Artikel Entscheiden Sie, welche Datensatzerstellungsoption für Ihr Unternehmen geeignet ist. für Details. Siehe Abschnitt Konversions-API für App-Ereignisse für alle erforderlichen und optionalen App-Tracking-Parameter.

Installieren der Erweiterung

So installieren Sie die Meta Conversions API Erweiterung, navigieren Sie zur Datenerfassungs-Benutzeroberfläche oder Experience Platform-Benutzeroberfläche und wählen Sie Ereignisweiterleitung über die linke Navigation. 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 Erweiterungen im linken Navigationsbereich und wählen Sie dann die Katalog Registerkarte. Suchen Sie nach Meta Conversions-API Karte, und wählen Sie Installieren.

Die Installieren Option, die für die Meta Conversions-API -Erweiterung in der Datenerfassungs-Benutzeroberfläche.

In der angezeigten Konfigurationsansicht müssen Sie die Variable Pixel ID, die Sie zuvor kopiert haben, 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 die Conversions API speziell. Siehe Abschnitt Conversions API Dokumentation zu Zugriffstoken generieren für Schritte zum Abrufen dieses Werts.

Wählen Sie zum Abschluss Speichern

Die Pixel ID, die in der Erweiterungskonfigurationsansicht als Datenelement bereitgestellt wird.

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 wird Ihre Pixel-ID und die Meta Conversions-API Zugriffstoken, wodurch die Installation und Konfiguration der Meta Conversions-API vereinfacht werden.

Bei der Installation der Meta Conversions-API -Erweiterung.

Die API-Erweiterung für Meta Conversions Hervorhebung der Installationsseite Mit Meta verbinden.

Eine Dialogaufforderung zur Authentifizierung in Facebook und Instagram wird auch in der Schnellstart-Workflow-Benutzeroberfläche bei der Ereignisweiterleitung angezeigt.

Die Schnellstart-Workflow-Benutzeroberfläche - Hervorhebung Mit Meta verbinden.

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 Meta Conversions API-Erweiterung Konfigurationsbildschirm.

Die API-Erweiterung für Meta Conversions Hervorhebung der Konfigurationsseite EMQ-Bewertung anzeigen.

Integration mit LiveRamp (Alpha) alpha

LiveRamp Kunden, die LiveRampDie auf ihren Sites bereitgestellte authentifizierte Traffic-Lösung (ATS) kann sich dafür entscheiden, RampIDs als Parameter für Kundeninformationen freizugeben. Arbeiten Sie bitte mit Ihrem Meta Account-Team , um dem Alpha-Programm für diese Funktion beizutreten.

Die Meta-Ereignisweiterleitung Regel Hervorhebung der Konfigurationsseite Partnername (Alpha) und Partner-ID (Alpha).

Konfigurieren einer Ereignisweiterleitungsregel rule

In diesem Abschnitt wird die Verwendung der Conversions API -Erweiterung in einer generischen Ereignisweiterleitungsregel. In der Praxis sollten Sie mehrere Regeln konfigurieren, um alle akzeptierten zu senden Standardereignisse via Meta Pixel und Conversions API. Informationen zu Mobile-App-Daten finden Sie in den erforderlichen Feldern, Feldern für App-Daten, Parametern für Kundeninformationen und benutzerdefinierten Datendetails. here.

NOTE
Ereignisse sollten in Echtzeit gesendet oder so nah wie möglich in Echtzeit, um eine bessere Anzeigenkampagnenoptimierung zu erzielen.

Beginnen Sie mit der Erstellung einer neuen Ereignisweiterleitungsregel und konfigurieren Sie deren Bedingungen nach Bedarf. Wenn Sie die Aktionen für die Regel auswählen, wählen Sie API-Erweiterung für Meta Conversions für die Erweiterung und wählen Sie dann Ereignis der Konversions-API senden für den Aktionstyp.

Die Seitenansicht senden Aktionstyp, der für eine Regel in der Datenerfassungs-Benutzeroberfläche ausgewählt wird.

Es werden Steuerelemente angezeigt, mit denen Sie die Ereignisdaten konfigurieren können, die an Meta über die Conversions API. 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.

Konfigurationsabschnitt
Beschreibung
Server-Ereignisparameter
Allgemeine Informationen zum Ereignis, einschließlich der Zeit, zu der es aufgetreten ist, und der Quellaktion, die es ausgelöst hat. Siehe Abschnitt Meta Entwicklerdokumentation für weitere Informationen zu Standard-Ereignisparameter von Conversions API.

Wenn Sie beide Meta Pixel und Conversions API Um Ereignisse zu senden, stellen Sie sicher, dass Sie sowohl eine als auch eine Ereignisname (event_name) und Ereignis-ID (event_id) bei jedem Ereignis verwenden, da diese Werte für Ereignisdeduplizierung.

Sie können auch Eingeschränkte Datenverwendung aktivieren um die Einhaltung von Kunden-Opt-outs zu unterstützen. Siehe Conversions API Dokumentation zu Datenverarbeitungsoptionen für Details zu dieser Funktion.
Parameter für Kundeninformationen
Benutzeridentitätsdaten, mit denen das Ereignis einem Kunden zugeordnet wird. Einige dieser Werte müssen gehasht werden, bevor sie an die API gesendet werden können.

Um eine gute gemeinsame API-Verbindung und eine hohe Ereignisübereinstimmungsqualität (EMQ) sicherzustellen, wird empfohlen, alle akzeptierte Kundeninformationsparameter neben Serverereignissen. Diese Parameter sollten ebenfalls priorisiert anhand ihrer Bedeutung und Auswirkung auf EMQ.
Benutzerdefinierte Daten
Zusätzliche Daten, die zur Optimierung der Anzeigenbereitstellung verwendet werden und in Form eines JSON-Objekts bereitgestellt werden. Siehe Abschnitt Conversions API Dokumentation für weitere Informationen zu den zulässigen Eigenschaften für dieses Objekt.

Wenn Sie ein Kaufereignis senden, müssen Sie in diesem Abschnitt die erforderlichen Attribute angeben currency und value.
Testereignis
Diese Option wird verwendet, um zu überprüfen, ob Ihre Konfiguration dazu führt, dass Serverereignisse von empfangen werden Meta wie erwartet. Um diese Funktion zu verwenden, wählen Sie die Als Testereignis senden und geben Sie dann in der unten stehenden Eingabe einen Test-Ereigniscode Ihrer Wahl ein. Nachdem die Ereignisweiterleitungsregel bereitgestellt wurde, sollten bei der korrekten Konfiguration der Erweiterung und Aktion Aktivitäten angezeigt werden, die im Test Events Ansicht in Meta Events Manager.

Wählen Sie zum Abschluss Änderungen beibehalten , um die Aktion zur Regelkonfiguration hinzuzufügen.

Änderungen beibehalten für die Aktionskonfiguration ausgewählt werden.

Wenn Sie mit der Regel zufrieden sind, wählen Sie In Bibliothek speichern. Veröffentlichen Sie schließlich eine neue Ereignisweiterleitung build um die Änderungen zu aktivieren, die an der Bibliothek vorgenommen wurden.

Ereignisdeduplizierung deduplication

Wie in Abschnitt mit Voraussetzungen, wird empfohlen, beide Meta Pixel Tag-Erweiterung und Conversions API Ereignisweiterleitungs-Erweiterung, um dieselben Ereignisse vom Client und Server in einer redundanten Einrichtung 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 von beiden gemeinsam genutzt wird Meta Pixel und Conversions APImü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, Meta verwendet automatisch mehrere Strategien, um sie zu deduplizieren und die relevantesten Daten beizubehalten. Siehe Meta Dokumentation zu Deduplizierung für Meta Pixel und Conversions API events für Details zu diesem Prozess.

Schnellstart-Workflow: Metadaten-Konversions-API-Erweiterung (Beta) quick-start

IMPORTANT
  • 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.
NOTE
Jeder vorhandene Client kann die Schnellstart-Workflows verwenden, um eine Referenzimplementierung zu erstellen, die für Folgendes verwendet werden kann:
  • 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

NOTE
Diese Funktion soll Ihnen bei den ersten Schritten mit der Implementierung der Ereignisweiterleitung helfen. Es wird keine End-to-End-Implementierung liefern, die voll funktionsfähig ist und allen Anwendungsfällen gerecht wird.

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 Erste Schritte für Send Conversions Data to Meta zur Datenerfassung in Adobe Experience Platform Startseite Seite.

Datenerfassungs-Startseite mit Konversionsdaten in Meta

Geben Sie Ihre Domäne, wählen Sie Nächste. Diese Domäne wird als Namenskonvention für automatisch generierte Tags und Ereignisweiterleitungseigenschaften, Regeln, Datenelemente, Datenspeicher usw. verwendet.

Begrüßungsbildschirm, der den Domänennamen anfordert

Im Ersteinrichtung Dialogfeld eingeben Meta-Pixel-ID, Zugriffstoken für Metadaten-Konversions-API, und Datenschichtpfad, wählen Sie Nächste.

Dialogfeld für die Ersteinrichtung

Warten Sie einige Minuten, bis der erste Einrichtungsprozess abgeschlossen ist, und wählen Sie dann Nächste.

Bildschirm zur Ersteinrichtung zur Bestätigung

Aus dem Code zu Ihrer Site hinzufügen Kopieren Sie den Code, der mit der Kopie bereitgestellt wird. Kopieren -Funktion und fügen Sie sie in die <head> Ihrer Quell-Website. Wählen Sie nach der Implementierung Validierung starten

Code zum Dialogfeld Ihrer Site hinzufügen

Die Überprüfungsergebnisse zeigt die Implementierungsergebnisse der Meta-Erweiterung an. Auswählen Nächste. Sie können auch zusätzliche Überprüfungsergebnisse anzeigen, indem Sie die Assurance -Link.

Dialogfeld mit Testergebnissen mit Implementierungsergebnissen

Die Nächste Schritte Bildschirmanzeige bestätigt den Abschluss der Einrichtung. 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.

Dialogfeld Nächste Schritte

Hinzufügen zusätzlicher Ereignisse

Um neue Ereignisse hinzuzufügen, wählen Sie Bearbeiten Ihrer Tags-Webeigenschaft.

Nächstes Dialogfeld mit dem Bearbeiten der Tag-Webeigenschaft

Wählen Sie die Regel aus, die dem Meta-Ereignis entspricht, das Sie bearbeiten möchten. Beispiel: MetaConversion_AddToCart.

NOTE
Wenn kein Ereignis vorhanden ist, wird diese Regel nicht ausgeführt. Dies gilt für alle Regeln, mit dem MetaConversion_PageView -Regel ist die Ausnahme.

Um ein Ereignis hinzuzufügen, wählen Sie Hinzufügen unter Veranstaltungen -Überschrift.

Seite Tag-Eigenschaftenohne Ereignisse

Wählen Sie die Ereignistyp. In diesem Beispiel haben wir die Variable Klicks -Ereignis und konfigurieren Sie es für den Trigger, wenn die .add-to-cart-button ausgewählt ist. Wählen Sie Änderungen beibehalten aus.

Bildschirm zur Ereigniskonfiguration mit Klick-Ereignis

Das neue Ereignis wurde gespeichert. Auswählen Arbeitsbibliothek auswählen und wählen Sie die Bibliothek aus, die Sie erstellen möchten.

Auswählen einer Dropdown-Liste für die Arbeitsbibliothek

Wählen Sie als Nächstes das Dropdown-Menü neben In Bibliothek speichern und wählen In Bibliothek speichern und erstellen. Dadurch wird die Änderung in der Bibliothek veröffentlicht.

In Bibliothek speichern und erstellen auswählen

Wiederholen Sie diese Schritte für jedes andere Meta-Konversionsereignis, das Sie konfigurieren möchten.

Datenschichtkonfiguration configuration

IMPORTANT
Die Art und Weise, wie Sie diese globale Datenschicht aktualisieren, hängt von Ihrer Website-Architektur ab. Eine einseitige Anwendung unterscheidet sich von einer serverseitigen Rendering-App. Es besteht auch die Möglichkeit, dass Sie vollständig dafür verantwortlich sind, diese Daten innerhalb des Tags-Produkts zu erstellen und zu aktualisieren. In allen Fällen muss die Datenschicht zwischen der Ausführung der einzelnen MetaConversion_* rules. Wenn Sie die Daten zwischen Regeln nicht aktualisieren, können Sie auch auf einen Fall stoßen, in dem Sie veraltete Daten aus der letzten MetaConversion_* rule im aktuellen MetaConversion_* rule.

Während der Konfiguration wurden Sie gefragt, wo sich Ihre Datenschicht befindet. Standardmäßig wäre dies window.dataLayer.metaund innerhalb der meta -Objekt, werden Ihre Daten wie unten dargestellt erwartet.

Datenschichtmetainformationen

Dies ist wichtig, da jede MetaConversion_* verwendet diese Datenstruktur, um die relevanten Datenteile an die Meta Pixel und Meta Conversions API. Weitere Informationen finden Sie in der Dokumentation unter Standardereignisse Weitere Informationen dazu, welche Daten für verschiedene Meta-Ereignisse erforderlich sind.

Wenn Sie beispielsweise die MetaConversion_Subscribe -Regel verwenden, müssen Sie window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv, und window.dataLayer.meta.value entsprechend den Objekteigenschaften, die in der Dokumentation unter Standardereignisse.

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.

Daten-Layer-Metadaten aktualisieren

Standardmäßig wird die Variable <datalayerpath>.conversionData.eventId wird zufällig von der Aktion "Neue Ereignis-ID generieren"für eine der MetaConversion_* rules.

Um eine lokale Referenz dazu zu erhalten, wie die Datenschicht aussehen soll, können Sie den Editor für benutzerdefinierten Code im MetaConversion_DataLayer -Datenelement in Ihrer Eigenschaft.

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie serverseitige Ereignisdaten an senden Meta mithilfe der Meta Conversions API -Erweiterung. Von hier aus wird empfohlen, Ihre Integration durch eine stärkere Verbindung zu erweitern Pixels und teilen Sie ggf. weitere Ereignisse. Eine der folgenden Maßnahmen kann dazu beitragen, Ihre Anzeigenleistung weiter zu verbessern:

  • Andere verbinden Pixels , die noch nicht mit einer Conversions API Integration.
  • Wenn Sie bestimmte Ereignisse ausschließlich über senden Meta Pixel Client-seitig senden Sie dieselben Ereignisse an die Conversions API auch vom Server aus.

Siehe Meta Dokumentation zu Best Practices für Conversions API für weitere Anleitungen zur effektiven Implementierung Ihrer Integration. Allgemeine Informationen zu Tags und zur Ereignisweiterleitung in Adobe Experience Cloud finden Sie im Abschnitt Tag-Übersicht.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743