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.
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.
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.
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 -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.
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 Meta Conversions API-Erweiterung Konfigurationsbildschirm.
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.
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.
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.
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.
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.
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.
Wenn Sie ein Kaufereignis senden, müssen Sie in diesem Abschnitt die erforderlichen Attribute angeben
currency und value.Wählen Sie zum Abschluss Änderungen beibehalten , um die Aktion zur Regelkonfiguration hinzuzufügen.
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
- 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 Erste Schritte für Send Conversions Data to Meta zur Datenerfassung in Adobe Experience Platform Startseite Seite.
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.
Im Ersteinrichtung Dialogfeld eingeben Meta-Pixel-ID, Zugriffstoken für Metadaten-Konversions-API, und Datenschichtpfad, wählen Sie Nächste.
Warten Sie einige Minuten, bis der erste Einrichtungsprozess abgeschlossen ist, und wählen Sie dann Nächste.
Aus dem Code zu Ihrer Site hinzufügen Kopieren Sie den Code, der mit der Kopie bereitgestellt wird.
<head> Ihrer Quell-Website. Wählen Sie nach der Implementierung Validierung starten
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.
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.
Hinzufügen zusätzlicher Ereignisse
Um neue Ereignisse hinzuzufügen, wählen Sie Bearbeiten Ihrer Tags-Webeigenschaft.
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 Veranstaltungen -Überschrift.
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.
Das neue Ereignis wurde gespeichert. Auswählen 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 wählen 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. 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.
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.
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.