Protokollieren von Events mit der Events API für Business Messaging

Dieser Leitfaden beschreibt, wie du App- und Facebook-Seiten-Events protokollierst, um zu analysieren, wie Nutzer*innen mit der Messenger-Erfahrung interagieren.

Bevor du beginnst

Du benötigst Folgendes:

• Die page_events-Berechtigung

  • Erweiterter Zugriff wird für diese Berechtigung automatisch erteilt, wenn du deine App für den App Review einreichst und sie bereits über erweiterten Zugriff für die pages_messaging-Berechtigung verfügt und in den letzten 90 Tagen gegen keine Richtlinien verstoßen hat.
• Einen Seiten-Zugriffsschlüssel, der von der Person angefordert wird, die die ANALYZE-Aufgabe auf der Seite durchführen kann, für die eine Abfrage getätigt wird

Einschränkungen

Diese Events API ist derzeit noch nicht für Unternehmen oder Kunden aus Europa bzw. Japan verfügbar.

Richtlinie und Nutzungsbedingungen

• Die Nutzungsbedingungen für Facebook Business-Tools
• Richtlinien für Seiten, Gruppen und Veranstaltungen

Events protokollieren

Events werden protokolliert, indem eine POST-Anfrage an die page_activities-Edge einer Anwendung übermittelt wird:

https://graph.facebook.com/

Beispielanfrage:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

In der folgenden Tabelle werden die Eigenschaften und Werte beschrieben, die für den Endpunkt verfügbar sein müssen, um Messenger-Events zu protokollieren:

Melden von Leads über die Messaging Event API

Apps können jetzt Lead-Einreichungen in Threads melden. Das lead_submitted-Event ermöglicht es Apps, automatisch Threads zu melden, die als Verkaufs-Leads betrachtet werden (d. h. ein*e Nutzer*in teilt seine*ihre Kontaktinformationen mit der Bitte bezüglich eines Verkaufs kontaktiert zu werden).

Das Event kann verwendet werden, um bestimmte Nutzer*innen als Leads zu ermitteln, was Unternehmen dabei helfen soll, deren Threads zu priorisieren. Ein Unternehmen kann zum Beispiel einen automatisierten Flow einrichten, der eine*n Nutzer*in als potenziellen Lead qualifiziert, und dieses Event auslösen, wenn der*die Nutzer*in diesen Flow ausführt, sodass der Thread einem*einer Mitarbeiter*in als Thread mit hohem Potenzial gemeldet wird.

Derzeit ist diese Funktion in einer offenen Betaversion verfügbar und die Berichterstellung im Werbeanzeigenmanager ist integriert, sodass Leads-Daten in der Werbeanzeigenmanager-UI in gemeldet werden.

Beispiel für einen API-Aufruf zum Melden eines Lead-Events in einem Thread:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Melden von Leads über die Ads Insights API

Das gemeldete Lead-Event kann mit der Ads Insights API visualisiert werden. Mit dieser API kannst du ein erweitertes Analyse-Dashboard erstellen, um den Lead zu visualisieren, der CTX-Kampagnen zugeordnet wird

Voraussetzungen

Bevor du diese API verwendest, stelle sicher, dass die App den App-Review-Vorgang für die ads_read-Berechtigung durchlaufen hat und du über erweiterten Zugriff verfügst.

Umsetzung

Ein beispielhafter Insights-Aufruf auf Werbekampagnenebene sieht folgendermaßen aus:

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
    

Die Insight API kann auf Werbekonto-, Kampagnen- und Anzeigengruppenebene abgerufen werden, je nach gewünschter Genauigkeit.

Dies ist der Aufruf, um den Lead abzurufen:

• Leads (zugeordnet)

  • /<OBJECT_ID>/insights?fields=actions
  • Im Ergebnis: action_type=onsite_converstion.lead_grouped

Eine detaillierte Definition der oben genannten Aktionstypen findest du in der Referenz „Ads Action Stats“.

Best Practices für die Klassifizierung von Leads

1. Der Werbetreibende ist in einer der klassischen Leadgenerierungs-Branchen (Automobil, professionelle Dienstleistungen, Finanzdienstleistungen, B2B, Bildung, Gesundheit).
2. Der Werbetreibende fragt nach Kontaktinformationen wie Telefon- oder E-Mail-Adresse und der*die Nutzer*in stellt sie bereit
3. Den Fragen nach Telefon- oder E-Mail-Adresse geht eine Art Qualifikation voraus (z. B. 1–2 Zusatzfragen).
4. Wenn du Vorlagen für die Leadgenerierung in deiner App anbietest, füge dieses Signal standardmäßig am Ende der Prozesse zur Leadgenerierung hinzu.

Event-Protokollierung verifizieren

Als App- oder Seiten-Admin kannst du deine Einrichtung verifizieren, indem du deine Events im Werbeanzeigenmanager suchst.

Besondere Erwägungen für Analytics für Messenger

• Eine einzelne App kann Interaktionen für mehrere Seiten protokollieren. In diesen Fällen werden Events aus Interaktionen mit allen Seiten in derselben App angezeigt.
• Mit einer Seite können mehrere Apps verknüpft sein. In diesem Fall erhalten alle mit der Seite verknüpften Apps ein fb_messenger_bot_stopped-Event, wenn die Seite gesperrt wird.
• Die Anzahl der gelöschten Messenger-Bot-Unterhaltungen kann höher sein als die Zahl der neuen Nutzeraktivitäten Die Zahl gelöschte Messenger-Bot-Unterhaltungen gibt an, wie oft Nutzer einen Thread gelöscht haben. Nachdem ein Nutzer einen Thread gelöscht hat, kann die Seite weitere Unterhaltungen initiieren. Die zusätzlichen Threads können von Nutzern gelöscht werden, wodurch die Zahl der gelöschten Messenger-Bot-Unterhaltungen steigt.

Nutzung für Plattform-Provider

Protokollierungsziel

Plattformen, die die Erstellung von Messenger-Erlebnissen über visuelle Schnittstellen ermöglichen, verwenden in der Regel eine zentrale App, um alle verknüpften Seiten zu betreiben. Damit deine Kunden ihre eigenen Events sehen können, musst du diese auf der Seite der Kunden protokollieren, indem du die Einstellung logging_target auf Seite oder App_und_Seite festlegst.

Benutzeroberfläche

In Zusammenhang mit einem visuellen Editor kannst du einen Block anbieten, der verschoben werden kann und in dem Benutzer ein Event auswählen und zusätzliche Parameter definieren können. So können Seiten-Admins den Messenger-Prozess mit passenden Events genau festlegen. Idealerweise sollten Nutzer in der Lage sein, den Namen eines Standard-Events in einer Dropdown-Liste auszuwählen, da nur Standard-Events im Werbeanzeigenmanager angezeigt werden und für das Anzeigen-Targeting und die Optimierung verfügbar sind (falls zutreffend). Wenn kein Name eines Standard-Events mit der Nutzerhandlung übereinstimmt und Anzeigenberichte nicht erforderlich sind, kannst du ein formloses Feld bereitstellen, in das Nutzer einen selbstdefinierten Event-Namen und Parameter eingeben können.

Berechtigungen

Die erforderliche page_events-Berechtigung muss während des Facebook Login-Prozesses deiner App erteilt werden. Diese musst du zu den angeforderten Berechtigungen des Login-Buttons, des Facebook JavaScript-SDK-Aufrufs oder deines manuell erstellten Anmeldeprozesses hinzufügen, wie in diesem Leitfaden beschrieben.

Weitere Ressourcen

• Best Practices-Leitfaden für App-Events: Enthält Empfehlungen in Bezug auf Events zur Verwendung in verschiedenen Arten von Apps.