Référence sur l’API Messaging Insights

Avec l’API Messaging Insights, vous pouvez récupérer, par programmation, les informations affichées dans l’onglet Statistiques de Page de votre Page Facebook.

Pour plus d’informations sur l’API Messaging Insights et les autres statistiques disponibles depuis la plateforme Messenger, consultez la page Analyses.

Pour plus d’informations sur l’API Pages Insights, notamment sur les autres indicateurs disponibles et les autorisations requises, veuillez consulter la documentation sur les statistiques de Pages ou la référence sur les statistiques d’objet.

Autorisations

Un token d’accès de Page associé à l’autorisation read_insights est obligatoire pour interagir avec ce point de terminaison.

Exemple de requête

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

Exemple de réponse

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

Paramètres

Paramètre	Description
`breakdowns`	Dimensions selon lesquelles la réponse est groupée. Les valeurs possibles sont `messaging_channel` (Messenger ou Instagram), `recurring_notification_topic`, `recurring_notifications_freuency`.
`date_preset`	Période relative pouvant être utilisée à la place de `since` et `until`. Les valeurs possibles sont `last_week`, `last_month` et `last_quarter`, entre autres.
`metric`	Liste des indicateurs à renvoyer, séparés par une virgule.
`period`	Agrégation fournie dans la plage since/until ou date_preset. La valeur `total_over_range` associe une valeur unique à l’indicateur sur la période donnée. Les valeurs possibles sont `day`, `week`, `month`, `days_28` et `total_over_range`.
`since`	Horodatage UNIX de l’heure de début pour laquelle récupérer l’indicateur.
`until`	Horodatage UNIX de l’heure de fin pour laquelle récupérer l’indicateur.

Indicateurs disponibles

Les indicateurs suivants sont disponibles via l’API Messaging Insights :

Nom de l’indicateur `metric`	Description
`recurring_notification_tokens`	Nombre de fois où un compte s’est abonné afin de recevoir des messages marketing de votre entreprise. Si un même compte s’est abonné à plusieurs sujets, il sera comptabilisé pour chaque sujet. Méthode de calcul : cet indicateur comptabilise le nombre de fois que des comptes ont accepté de recevoir des messages récurrents et y soustrait le nombre de fois que des comptes se sont désabonnés. Valeurs `breakdowns` possibles : `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Cet indicateur est en cours de développement.
`page_messages_engagement`	Nombre de fois où des utilisateur·ices ont interagi avec les messages sur la Page de votre entreprise, en appuyant sur un bouton call-to-action. Cet indicateur n’inclut que les données des messages marketing. Valeurs `breakdowns` possibles : `messaging_channel` `recurring_notifications_topic` Cet indicateur est en cours de développement.
`page_messages_sent`	Nombre de messages envoyés à un ou une client·e par la Page de votre entreprise. Cet indicateur n’inclut que les données des messages marketing. Valeurs `breakdowns` possibles : `messaging_channel` `recurring_notifications_topic` Cet indicateur est en cours de développement.
`page_messages_read_ratio`	Nombre de messages lus divisé par le nombre de messages envoyés à partir de votre Page. Il peut arriver que certaines lectures de messages ne soient pas comptabilisées, par exemple lorsque les client·es ont désactivé les confirmations de lecture. Cet indicateur n’inclut que les données des messages marketing. Valeurs `breakdowns` possibles : `messaging_channel` `recurring_notifications_topic` Cet indicateur est en cours de développement.
`page_messages_order_count`	Nombre de fois où vous avez créé une commande dans des conversations par messages, ou dans des applications ou des sites web tiers utilisés pour gérer des conversations par messages. Cet indicateur est en cours de développement.
`page_messages_paid_order_earnings`	Montant approximatif de l’argent gagné grâce à des commandes créées via des conversations par messages, ou via des applications ou des sites web tiers utilisés pour gérer des conversations par messages. Les revenus effectifs peuvent être différents en raison des conversions de devises. Cet indicateur est en cours de développement.
`page_messages_with_business_outcomes`	Nombre de connexions par messages avec au moins une commande créée. Cet indicateur est en cours de développement.
`page_messages_blocked_conversations_unique`	Nombre de conversations avec la Page qui ont été bloquées.
`page_messages_new_conversations_unique`	Nombre de conversations par messages sur Messenger qui ont commencé avec des personnes qui n’avaient encore jamais échangé de messages avec votre entreprise.
`page_messages_reported_conversations_unique`	Nombre de conversations provenant de votre Page qui ont été signalées par des internautes pour diverses raisons (spam ou contenu inapproprié, par exemple).
`page_messages_total_messaging_connections`	Nombre de personnes auxquelles votre entreprise peut envoyer des messages. Cet indicateur donne le nombre de personnes qui ont déjà envoyé un message à votre entreprise sur Messenger, en excluant les personnes qui ont bloqué ou signalé votre entreprise sur Messenger. Votre capacité à envoyer des messages à des contacts peut être restreinte, par exemple par une limitation du nombre de messages que vous pouvez envoyer au cours d’une période donnée. De plus, cet indicateur ne comprend que les contacts établis depuis octobre 2016, date à laquelle les données sont devenues disponibles.

Propriétés des réponses

Propriété	Description
`data` tableau d’objets	Liste d’objets d’indicateurs.
`name` chaîne	Nom de l’indicateur.
`period` chaîne	Période pendant laquelle les données ont été collectées.
`values` tableau d’objets	Liste de données pour un indicateur.
`value` tableau d’objets	Décompte par jour pour l’indicateur demandé. Pour les indicateurs associés à une répartition par type, un objet contenant le décompte pour chaque type est renvoyé.
`end_time` horodatage unix	Horodatage UTC de l’heure de fin pour l’indicateur.

Voir aussi

Pour plus d’informations sur l’utilisation de l’API Messaging Insights, consultez le Guide d’utilisation de l’API Messaging Insights.