Messaging Insights API-Referenz

Mit der Messaging Insights API kannst du programmatisch dieselben Informationen abrufen, die auch auf dem Tab „Seiten-Insights“ deiner Facebook-Seite zu sehen sind.

Weitere Informationen zur Messaging Insights API und zu anderen auf der Messenger-Plattform verfügbaren Analysen findest du unter Analytics.

Weitere Informationen zur Pages Insights API, einschließlich Informationen zu weiteren verfügbaren Kennzahlen und den dafür erforderlichen Berechtigungen, findest du in der Dokumentation zu Seiten-Insights oder in der Insights-Objektreferenz.

Berechtigungen

Um mit diesem Endpunkt zu interagieren, benötigst du einen Seiten-Zugriffsschlüssel mit der Berechtigung read_insights.

Beispielanfrage

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

Beispielantwort

{ 
  "data": [ 
    { 
      "name": "

Parameter

Parameter	Beschreibung
`breakdowns`	Dimensionen, nach denen die Antwort gruppiert ist. Mögliche Werte: `messaging_channel` (Messenger oder Instagram), `recurring_notification_topic`, `recurring_notifications_freuency`
`date_preset`	Relativer Datumsbereich, der statt `since` und `until` verwendet werden kann. Mögliche Werte: `last_week`, `last_month`, `last_quarter` und weitere.
`metric`	Eine durch Komma getrennte Liste mit zurückzugebenden Kennzahlen
`period`	Die angegebene Aggregation innerhalb des durch „since“/„until“ bzw. „date_range“ definierten Zeitraums. Der Wert `total_over_range` liefert einen einzelnen Wert für die Kennzahl im ausgewählten Datumsbereich. Mögliche Werte: `day`, `week`, `month`, `days_28` oder `total_over_range`
`since`	UNIX-Zeitstempel des Startzeitpunkts zum Abruf der entsprechenden Kennzahl
`until`	UNIX-Zeitstempel des Endzeitpunkts zum Abruf der entsprechenden Kennzahl

Verfügbare Kennzahlen

Die folgenden Kennzahlen sind über die Messaging Insights API verfügbar:

Name der `metric`	Beschreibung
`recurring_notification_tokens`	So oft haben Konten sich für Marketing-Nachrichten deines Unternehmens registriert. Hat ein Konto mehrere Themen abonniert, wird es für jedes Thema einzeln gezählt. Berechnung: Diese Kennzahl erfasst, wie oft Konten dem Erhalt von regelmäßigen Nachrichten zugestimmt haben, abzüglich der Anzahl der beendeten Abonnements. Mögliche Werte für `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Diese Kennzahl ist in Entwicklung.
`page_messages_engagement`	So oft haben Nutzer*innen per Nachricht mit deiner Unternehmensseite interagiert, etwa durch Tippen auf einen Call-to-Action-Button. Diese Kennzahl berücksichtigt ausschließlich Daten zu Marketing-Nachrichten. Mögliche Werte für `breakdowns`: `messaging_channel` `recurring_notifications_topic` Diese Kennzahl ist in Entwicklung.
`page_messages_sent`	Die Anzahl der Nachrichten, welche die Seite deines Unternehmens an Kund*innen gesendet hat. Diese Kennzahl berücksichtigt ausschließlich Daten zu Marketing-Nachrichten. Mögliche Werte für `breakdowns`: `messaging_channel` `recurring_notifications_topic` Diese Kennzahl ist in Entwicklung.
`page_messages_read_ratio`	Die Anzahl der gelesenen Nachrichten geteilt durch die gesendeten Nachrichten deiner Seite. Manche gelesenen Nachrichten werden möglicherweise nicht erfasst, etwa wenn derdie Kundin Lesebestätigungen deaktiviert hat. Diese Kennzahl berücksichtigt ausschließlich Daten zu Marketing-Nachrichten. Mögliche Werte für `breakdowns`: `messaging_channel` `recurring_notifications_topic` Diese Kennzahl ist in Entwicklung.
`page_messages_order_count`	Die Anzahl der Bestellungen, die du im Rahmen von Unterhaltungen bzw. in Drittanbieter-Apps oder -Websites erstellt hast, welche du zur Verwaltung von Unterhaltungen einsetzt. Diese Kennzahl ist in Entwicklung.
`page_messages_paid_order_earnings`	Die ungefähren Einnahmen, die du durch Bestellungen im Rahmen von Unterhaltungen bzw. durch Drittanbieter-Apps oder -Websites erzielt hast, welche du zur Verwaltung von Unterhaltungen einsetzt. Die endgültigen Beträge können aufgrund von Währungsumrechnungen abweichen. Diese Kennzahl ist in Entwicklung.
`page_messages_with_business_outcomes`	Hierbei handelt es sich um die Anzahl der Messenger-Kontakte mit mindestens einer erstellten Bestellung. Diese Kennzahl ist in Entwicklung.
`page_messages_blocked_conversations_unique`	Die Anzahl der Unterhaltungen mit der Seite, die blockiert wurden.
`page_messages_new_conversations_unique`	Die Anzahl der begonnenen Messenger-Unterhaltungen mit Personen, die deinem Unternehmen zuvor noch keine Nachricht geschrieben hatten.
`page_messages_reported_conversations_unique`	Die Anzahl der Unterhaltungen mit deiner Seite, die von Nutzer*innen beispielsweise wegen Spam oder unangemessenen Inhalten gemeldet wurden.
`page_messages_total_messaging_connections`	Die Anzahl der Personen, an die dein Unternehmen Nachrichten senden kann. Diese Kennzahl gibt die Gesamtzahl der Personen an, die deinem Unternehmen jemals eine Nachricht gesendet haben. Ausgeschlossen werden dabei solche, die dein Unternehmen im Messenger blockiert oder gemeldet haben. Das Senden von Nachrichten an deine Kontakte kann gewissen Einschränkungen unterliegen, etwa einer Obergrenze für die Anzahl der Nachrichten, die du in einem bestimmten Zeitraum senden kannst. Diese Kennzahl beinhaltet ausschließlich Kontakte seit Oktober 2016, also seitdem die Daten verfügbar sind.

Antworteigenschaften

Eigenschaft	Beschreibung
`data` Array von Objekten	Liste mit Kennzahl-Objekten
`name` String	Name der Kennzahl
`period` String	Zeitraum der erfassten Daten
`values` Array von Objekten	Liste mit Daten zu einer Kennzahl
`value` Array von Objekten	Die tägliche Anzahl der angefragten Kennzahl. Für Kennzahlen, die nach Typ aufgeschlüsselt werden, wird ein Objekt mit Anzahlen für jeden Typ zurückgegeben.
`end_time` UNIX-Zeitstempel	UTC-Zeitstempel des Endzeitpunkts der Kennzahl

Siehe auch

Weitere Informationen über die Verwendung der Messaging Insights API findest du im Guide zur Verwendung der Messaging Insights API.