Diese API befindet sich derzeit in der Betaphase. Wende dich für Zugriff an deine*n Meta-Ansprechpartner*in.
Werbetreibende, die Server-Events mit der Conversions API teilen, können im Events Manager die Event Match Quality (EMQ) sehen. Dies ist jedoch nur für einzelne Events möglich und lässt sich nur schwer skalieren, wenn ein Tech-Anbieter, eine Agentur oder ein Werbetreibender Hunderte oder Tausende von Meta-Pixeln für sein*ihr Unternehmen verwaltet. Die Integration Quality API kann zur Lösung dieses Problems beitragen, indem sie Metriken zur Integrationsqualität programmatisch und in großem Umfang konsolidiert.
Die Event Match Quality (EMQ) ist eine Punktzahl (von 10), die angibt, wie hilfreich die von deinem Server gesendeten Kund*innen-Informationen bei der Zuordnung von Event-Instanzen zu einem Facebook-Konto sind. Eine hohe Event Match Quality kann die Attribution und Leistung von Anzeigen verbessern. Diese Metrik befindet sich in Entwicklung.
Die Event Match Quality wird berechnet, indem untersucht wird, welche Kund*innen-Informationsparameter von deinem Server über eine Conversions-API-Integration empfangen werden. Außerdem werden die Qualität der empfangenen Informationen und der Prozentsatz der Event-Instanzen, die mit einem Meta-Konto übereinstimmen, berücksichtigt.
Anhand der Event Match Quality wird beurteilt, ob du über die Conversions API die richtigen Kund*innen-Informationen sendest, um deine Events einem Meta-Konto zuzuordnen, und ob du deine Kund*innen-Informationsparameter richtig eingerichtet hast. Parameter für die Kund*innen-Informationen helfen dir, deine Events einem Meta-Konto zuzuordnen, sodass du deinen Anzeigen Conversions zuordnen und sie an Personen ausliefern kannst, bei denen die Wahrscheinlichkeit einer Conversion am größten ist.
Die Event Match Quality wird in Echtzeit berechnet. Weitere Informationen zu Best Practices in Bezug auf EMQ findest du hier.
EMQ 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.
Partner und Agenturen können die Integration Quality API nutzen, um ein Qualitäts-Dashboard und Einblicke bereitzustellen und ihren Werbetreibenden bei der Verbesserung und Optimierung ihrer Integrationen zu helfen. Partner können diese Integration auch nutzen, um die Stabilität ihrer Conversions-API-Integration zu überwachen. Werbetreibende können diesen Endpunkt nutzen, um Daten zur Integrationsqualität zu sammeln und in ihre Überwachung einzubeziehen.
Du musst zunächst eine Autorisierung zum Senden von Events im Namen deiner Kund*innen beantragen. Für die Authentifizierung stehen dir folgende Optionen zur Verfügung:
Facebook Login for Business ist die bevorzugte Authentifizierungs- und Autorisierungslösung für Tech-Anbieter und Entwickler*innen von Business-Apps, die Zugang zu den Assets ihrer Geschäftskunden benötigen. Du kannst damit den Typ von Zugriffsschlüssel, die Asset-Typen sowie die Berechtigungen angeben, die deine App benötigt, und als einen Satz (Konfiguration) speichern. Du kannst den Satz dann deinen Geschäftskunden anzeigen, die den Vorgang abschließen und deiner App Zugriff auf ihre Business-Assets gewähren können.
Mit dieser Option gibt Meta Facebook Business Extension (MBE) alle notwendigen Informationen zurück, um Events im Namen des*der Kund*in zu senden. Die MBE stellt einen Endpunkt für den Abruf von Zugriffstoken für Systemnutzer bereit, die im Business Manager des*der Kund*in erstellt wurden. Dieser Prozess umfasst Berechtigungen für das Senden von Server-Events. Er erfolgt automatisch und ist sicher. MBE befindet sich derzeit in der Betaphase. Wende dich für Zugriff bitte an deine*n Meta-Ansprechpartner*in.
Der Endpunkt benötigt einen Nutzer*innen-Zugriffstoken als Eingabeparameter. Wenn du ein*e neue* MBE-Nutzer*in bist, rufe diesen Endpunkt auf, um den Zugriffstoken des Systemnutzers abzurufen, nachdem du die MBE eingerichtet hast. Bestehende Nutzer*innen müssen sich erneut authentifizieren lassen, um den neuen API-Endpunkt aufrufen zu können.
Mit dieser Option teilen Kund*innen ihr Meta-Pixel über die Business Manager-Einstellungen oder über die API mit dem Partner. Der Partner kann dann dem Kund*innen-Pixel den Partnersystemnutzer zuweisen und einen Zugriffstoken zum Senden von Server-Events generieren.
Mit dem folgenden API-Endpunkt, den Parametern und Feldern kannst du den Event Match Quality-Wert pro Event zusammen mit den gesendeten Abgleichsschlüsseln überwachen:
https://graph.facebook.com/v21.0
/<pixel_id>/integration_quality
Parameter | Beschreibung |
---|---|
agent_name String | Optional. Lautet dein „partner_agent“-Wert beispielsweise Mit dem Wenn du Werbetreibender bist, solltest du dir in den meisten Fällen keine Gedanken über die Wenn du keinen |
Feld | Beschreibung |
---|---|
event_name String | Der Name eines Standard-Events oder selbstdefinierten Events. |
event_match_quality AdsPixelCAPIEMQ | Die Event Match Quality gibt Aufschluss darüber, wie hilfreich die von deinem Server gesendeten Kund*innen-Informationen dabei sind, Event-Instanzen einem Facebook-Konto zuzuordnen. |
Graph API Explorer
GET/v21.0
/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>
cURL
curl -X GET -G \ -d 'fields="event_match_quality,event_name"' \ -d 'agent_name="<AGENT_NAME>"' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality
API-Antwort
{ "data": [ { "event_match_quality": { "composite_score": 5.1, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } } ] }, "event_name": "pLTVPurchase" }, { "event_match_quality": { "composite_score": 7.2, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "phone", "coverage": { "percentage": 69.1 } }, { "identifier": "fbp", "coverage": { "percentage": 96.7 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } }, { "identifier": "fbc", "coverage": { "percentage": 3.2 } } ] }, "event_name": "CompleteRegistration" } ] }
The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.
The partner_agent
value in your API GET request should be a normalized lowercase format. This field is now optional.
Steigere die Leistung mit einer optimierten Conversions API-Einrichtung.
Best Practices für das Onboarding der Conversions API für Partner
Informationen zur Qualität der Conversions API-Einrichtung aus dem Hilfebereich für Unternehmen von Meta: