Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.
Englisch aktualisiert: Gestern

Best Practices – Conversions API

Betrachte diese Best Practices als allgemeine Empfehlung für eine erfolgreiche Integration der Conversions API. Mit diesen Empfehlungen wollen wir dir dabei helfen, die Conversions API optimal zu nutzen. Befolge die Empfehlungen für die Implementierung und für nach der Implementierung, um eine reibungslose Integration und optimale Ergebnisse zu erzielen, wenn du Daten über Meta teilst.

Wir empfehlen dir, zusätzlich zu den folgenden Best Practices dieses Video anzusehen. Hier findest du ein stärker praxisbezogenes Tutorial zur Verwendung der Conversions API. Im Video findest du Anleitungen zu den folgenden Themen:

Für Web-, App- und physische Store-Events, die mit der Conversions API geteilt werden, sind bestimmte Parameter erforderlich. Die Liste der erforderlichen Parameter ist hier verfügbar.

Implementierung

Vereinfache beim Einrichten deiner Kampagnen die Kontostruktur und befolge die folgenden bewährten Best Practices für Kampagnen:

Redundante Events einrichten

Wir empfehlen dir, die Conversions API zusätzlich zum Meta-Pixel zu verwenden und dieselben Events mit beiden Tools zu teilen. Das ist eine redundante Event-Einrichtung. Wenn du beispielsweise Purchase-, Initiate Checkout- und Contact-Events mit dem Meta-Pixel teilst, solltest du dieselben Events auch mit der Conversions API über deinen Server teilen.

Mit der Conversions API kannst du Website-Events teilen, die dem Pixel aufgrund von Problemen mit der Netzwerkverbindung oder von Seitenladefehlern entgehen. Mit der Conversions API können auch andere Arten wichtiger Events und Daten geteilt werden, die offline oder später stattfinden und die vom Pixel nicht geteilt werden können.

Sicherstellen, dass redundante Events dedupliziert werden können

Wenn du redundante Events mit dem Meta-Pixel und der Conversions API sendest, dann stelle sicher, dass beide Events den gleichen event_name nutzen und dass entweder event_id oder eine Kombination aus external_id und fbp angegeben wird. Wir empfehlen dir, diese Parameter alle zu verwenden, damit Meta Events richtig dedupliziert und doppeltes Reporting von identischen Events vermieden wird. Erfahre mehr über Deduplizierung, darüber, wann sie notwendig ist und wie sie eingerichtet wird.

Erforderliche und empfohlene Parameter senden

Die folgenden Parameter für Server-Events und Kundeninformationen sind erforderlich:

ParameterTypErforderlich wann?

action_source

Server-Event

Alle Events

event_source_url

Server-Event

Alle Website-Events

client_user_agent

Kundeninformationen

Alle Website-Events

Indem du die Conversions API verwendest, stimmst du zu, dass der Parameter action_source nach deinem bestem Wissen und Gewissen korrekt ist. Wir empfehlen dir auch, die external_id- und event_id-Event-Parameter für alle Events anzugeben.

Wenn du zusätzliche Kundeninformationsparameter sendest, kannst du damit eventuell die Qualität des Event-Abgleichs verbessern. Es können nur abgeglichene Events für die Optimierung der Anzeigenattribution und der Anzeigenauslieferung verwendet werden. Je höher dabei die Abgleichqualität, desto besser. Nicht abgeglichene Events können zwar nicht für die Attribution oder die Anzeigenauslieferung verwendet werden, du kannst sie jedoch trotzdem für die grundlegende Messung heranziehen. Beispiele für Parameter für Kundeninformationen mit hoher Qualität:

  • E-Mail-Adresse (em)
  • IP-Adresse (client_ip_address)
  • Name (fn und ln)
  • Telefonnummer (ph)

Grundanforderungen für den Abgleich

Im Anschluss an die Veröffentlichung von Version 13.0 der Graph API aktualisieren wir dir Grundanforderungen, die Kombinationen von Kundeninformationsparametern erfüllen müssen, um für ein Conversions API-Event als gültig angesehen zu werden. Dank dieser Änderungen können wir besseres Feedback bereitstellen, wenn ein Event eine Kombination von Kundeninformationsparametern aufweist, die so breit gefächert ist, dass sie für den Abgleich sehr wahrscheinlich unbrauchbar ist.

Ein Event wird als ungültig betrachtet, wenn es ausschließlich Kundeninformationsparameter enthält, die aus einer der folgenden Kombinationen bestehen (oder einer Teilmenge davon).

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

Wenn ein Event beispielsweise nur aus den Kundeninformationsparametern ge, ct, st und country bestünde (diese könnten sich auf einen Mann in Menlo Park, Kalifornien, USA beziehen), würde es abgelehnt werden, da diese Kundeninformationsparameter eine Teilmenge einer der oben genannten Kombinationen sind.

Sorge dafür, dass die Parameter fbp und fbc aktualisiert werden.

Die Parameter fbp und fbc sind Cookie-Werte, die üblicherweise in Verbindung mit der Erstanbieter-Cookie-Lösung von Meta in den Browsern deiner Site-Besucher*innen eingefügt werden. Wenn du sie als Nutzer*innen-Parameter sendest, solltest du ihre Werte regelmäßig aktualisieren.

Diese Werte werden bei der Implementierung des Meta-Pixel auf deiner Website als First-Party Cookies eingerichtet und können für die Verwendung in Conversions API-Anfragen abgerufen werden.

Events in nahezu Echtzeit teilen

Wenn du Events dann teilst, wenn sie stattfinden, erzielst du mit deinen Kampagnen die besten Ergebnisse. Du kannst Server-Events mit der Conversions API in Echtzeit oder nahezu in Echtzeit in Batches teilen.

Test-Events verwenden

Wir empfehlen dir, deine Conversions API-Verbindung mit dem Tool „Test-Events“ zu überprüfen. Entwickler*innen sollten in der Regel ihre eigenen Kund*innen-Iformationsparameter für Test-Events verwenden (zum Beispiel Name, Adresse, Telefonnummer), da diese Events möglicherweise verworfen werden, wenn sie nicht mit einem Facebook- oder Meta-Konto übereinstimmen.

Das Tool „Test-Events“ kannst du für folgende Aktionen verwenden:

  • Überprüfen, dass du deine Server-Events richtig eingerichtet hast und dass wir sie erhalten haben.
  • Überprüfen, dass du Events richtig dedupliziert hast, indem du siehst, welche Events verarbeitet und dedupliziert wurden.
  • Debuggen aller ungewöhnlichen Aktivitäten.

Erfahre, wie du deine Server-Events mit dem Tool „Test-Events“ testest.

Das Payload-Hilfstool verwenden

Fülle die erforderlichen und empfohlenen Datenparameterfelder im Payload-Hilfstool aus, um zu erfahren, wie dein Payload strukturiert sein sollte. Außerdem erhältst du Empfehlungen, welche Parameter du am besten angibst.

Unser Business-SDK verwenden

Die Codebeispiele in unserer Dokumentation beinhalten Business-SDK-Beispiele in Python, Java, Ruby, PHP und Node. Damit kannst du Entwicklungsaufwand sparen, wie zum Beispiel das Hashing von Benutzerparametern, das im Business-SDK automatisch erfolgt.

Falls du das Business-SDK nicht verwenden möchtest, empfehlen wir dir, Hashing zu implementieren.

Conversions API für Offline-Events verwenden

Die Conversions API unterstützt alle Offline-Events und du solltest sie als umfassenden Container für diese Arten von Events verwenden. Beispiele sind Verkäufe im phyischen Geschäft, Telefonanrufe, auf Geräten ausgeführte Handlungen (wie Smart-TVs oder Spielekonsolen) und Offline-Abonnements.

Wenn du Offline-Events sendest, stelle sicher, dass du den action_source-Event-Parameter angibst und den entsprechenden Wert wählst (sollte nicht website sein). Du musst dabei die Handlungsquelle angeben, um die Kampagnenziele für das Event festzulegen.

Indem du die Conversions API verwendest, stimmst du zu, dass der Parameter action_source nach deinem bestem Wissen und Gewissen korrekt ist.

Weitere Best Practices für Partner

Agenturen: Senden des partner_agent-Strings

Partner*innen oder Agenturen, die Events für ihre Werbetreibenden teilen, sollten einen eindeutigen partner_agent-String senden und auch den Plattformnamen wie dokumentiert angeben. Arbeite gegebenenfalls mit deinem *deiner Meta-Vertreter*in zusammen, um zu entscheiden, welcher Agent-String geeignet ist.

Website-Plattformen: Onboarding von Werbetreibenden

Website-Plattformpartner können standardmäßig entscheiden, ob sie die Conversions API selektiv anbieten oder Opt-ins für Werbetreibende durchführen möchten. Für das Facebook-Pixel und die Conversions API werden dieselben Geschäftsbedingungen angewendet. Wir empfehlen dir, für deine Kunden Opt-ins auszuführen. Damit werden ihre Daten auch mit der Conversions API geteilt, wenn sie das Meta-Pixel einrichten. Wir sind zwar davon überzeugt, dass Werbekunden mit beiden Tools ihre Daten langfristig stärken und schützen können, empfehlen dir jedoch auch, dass du deinen Kunden Informationen über die Conversions API und das Meta-Pixel gibst, damit sie eine Entscheidungsgrundlage haben.

Nach der Implementierung

Qualität des Event-Abgleichs prüfen

Wenn du Server-Events mit der Conversions API teilst, siehst du im Events Manager die Event Match Quality (EMQ) für jedes Event. Der EMQ-Wert eines Events (1–10) gibt an, wie effektiv die Kundeninformationen deines Server-Events mit einem Facebook-oder Meta-Konto abgeglichen werden können. Weitere Informationen zu Best Practices in Bezug auf EMQ findest du hier.

Die Qualität des Event-Abgleichs ist derzeit nur für Web-Events verfügbar. Für andere Eventtypen wie Offline-Events und Events in physischen Geschäften, App-Events, Conversion Leads oder alle anderen Integrationen in der Alpha- oder Beta-Phase kontaktiere deine*n Meta-Ansprechpartner*in, um zu erfahren, wie du die Match-Qualität verbesserst.

Test ausführen

Für die Verwendung der Conversions API empfehlen wir dir, deine Meta-Werbestrategie zu testen und zu optimieren. Hier sind einige Testoptionen:

  • Conversion Lift-Studie: Erfahre mehr über die inkrementelle Performance-Auswirkung von Server-Events.

  • Split-Tests: Erfahre, mit welcher Kampagnenstrategie du die besten und effizientesten Ergebnisse zur Performance-Optimierung erzielst.