Consignation des évènements grâce à l’API Events pour l’envoi de messages aux entreprises

Ce guide décrit comment consigner les évènements d’application et de Pages Facebook pour analyser la façon dont les utilisateurs et utilisatrices interagissent avec leur expérience Messenger.

Avant de commencer

Vous aurez besoin des éléments suivants :

• l’autorisation page_events

  • L’accès Avancé sera automatiquement accordé à cette autorisation lorsque vous envoyez votre application au Contrôle app si cet accès lui a déjà été accordé pour l’autorisation pages_messaging et si elle n’a fait l’objet d’aucune infraction à nos politiques au cours des 90 derniers jours
• un token d’accès de Page demandé par une personne autorisée à effectuer la tâche ANALYZE sur la Page interrogée.

Limites

Cette API n’est actuellement pas disponible pour les entreprises ou les clients et clientes se trouvant en Europe ou au Japon.

Politique et conditions générales

• Conditions applicables aux outils Facebook Business
• Politiques relatives aux évènements, aux groupes et aux Pages

Consignation des évènements

Les évènements sont consignés en soumettant une requête POST à l’arête page_activities d’une application :

https://graph.facebook.com/

Exemple de requête :

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>

Le tableau suivant décrit les propriétés et les valeurs qui doivent être fournies au point de terminaison pour consigner les évènements Messenger :

Signalement des prospects à l’aide de l’API Messaging Event

Les applications peuvent désormais commencer à signaler les envois de prospects sur les fils de discussion. L’évènement lead_submitted permet aux applications d’automatiser le signalement des fils de discussion considérés comme des prospects commerciaux (l’utilisateur·ice a par exemple partagé ses coordonnées et a demandé à être contacté·e à propos de la vente).

L’évènement est particulièrement utile pour identifier certain·es utilisateurs·ices en tant que prospects potentiels, ce qui devrait aider les entreprises à donner la priorité à ces fils de discussion. Par exemple, une entreprise peut configurer un flux automatique destiné à qualifier un·e utilisateur·ice en tant que prospect potentiel, puis déclencher cet évènement lorsque l’utilisateur·ice termine ce flux pour le marquer en tant que fil de discussion à haut potentiel à l’intention d’un agent en direct.

Cette fonctionnalité est alors disponible dans une version bêta ouverte et comme les rapports du Gestionnaire de publicités sont intégrés, les données des prospects seront incluses dans l’interface du Gestionnaire de publicités.

Exemple d’appel d’API permettant de signaler un évènement de prospect détecté sur un fil de discussion :

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>

Signalement des prospects à l’aide de l’API Ads Insights

L’évènement de prospect signalé peut être visualisé à l’aide de l’API Ads Insights. À l’aide de cette API, vous pouvez créer un tableau de bord analytique avancé qui vous permettra de visualiser le prospect attribué aux campagnes CTX.

Conditions requises

Avant d’utiliser cette API, assurez-vous que l’application a été soumise au Contrôle app pour l’autorisation ads_read et pour obtenir un accès Avancé.

Exécution

Voici un exemple d’appel insight au niveau de la campagne publicitaire :

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

L’API Insight peut être appelée au niveau du compte publicitaire, de la campagne et de l’ensemble de publicités en fonction du niveau de granularité souhaité.

Voici l’appel pour obtenir le prospect :

• Prospects (attribués)

  • /<OBJECT_ID>/insights?fields=actions
  • En conséquence, action_type=onsite_converstion.lead_grouped

Pour une définition détaillée des types d’actions mentionnés ci-dessus, consultez la Référence sur les statistiques des actions publicitaires.

Recommandations pour la classification des prospects

1. L’annonceur est dans l’un des secteurs classiques de génération de prospects (automobile, services professionnels, services financiers, B2B, éducation, santé).
2. L’annonceur demande des coordonnées telles que le numéro de téléphone et l’adresse e-mail, et l’utilisateur·ice les lui fournit.
3. Les questions relatives au numéro de téléphone ou à l’adresse e-mail sont précédées d’une sorte de qualification (par exemple, 1-2 questions supplémentaires).
4. Si vous proposez des modèles de génération de prospects dans votre application, ajoutez ce signal à la fin des flux de génération de prospects par défaut.

Vérification de la consignation d’un évènement

Si vous êtes admin d’une application ou d’une Page, vous pouvez vérifier la pertinence de votre configuration en consultant vos évènements dans le Gestionnaire de publicités.

Considérations particulières pour l’analyse sur Messenger

• Une même application peut consigner les interactions de plusieurs Pages. Dans ce cas, les évènements issus des interactions avec toutes les Pages sont visibles dans l’application.
• Plusieurs applications peuvent être liées à une même Page. Dans ce cas, lorsque la Page est bloquée, toutes les applications liées à la Page recevront un évènement fb_messenger_bot_stopped.
• Le nombre de conversations avec le bot Messenger supprimées peut être supérieur au nombre d’activités d’un nouvel utilisateur ou d’une nouvelle utilisatrice. Conversation avec le bot Messenger supprimée correspond au nombre de fois qu’un utilisateur ou une utilisatrice supprime un fil de discussion. La Page peut lancer une conversation supplémentaire après qu’un utilisateur ou une utilisatrice a supprimé un fil de discussion. Les fils de discussion supplémentaires peuvent être supprimés par les utilisateurs et utilisatrices, ce qui augmente le nombre de Conversations avec le bot Messenger supprimées.

Utilisation pour les opérateurs de plateforme

Cible de consignation

Les plateformes qui permettent au public de créer des expériences Messenger par le biais d’interfaces visuelles utilisent généralement une application centrale pour alimenter toutes les pages associées. Pour permettre à votre clientèle de voir leurs propres évènements, vous devez les connecter à leurs Pages en définissant logging_target sur page ou app_and_page.

Interface d’utilisation

Pour les éditeurs visuels, vous pouvez proposer un bloc mobile qui permet de choisir un évènement et de définir des paramètres supplémentaires. Cela permet aux admins de la Page d’élaborer le flux Messenger avec des évènements appropriés. Idéalement, les utilisateurs et utilisatrices devraient pouvoir sélectionner un nom d’évènement standard dans une liste déroulante, car seuls les évènements standard sont signalés dans le Gestionnaire de publicités et disponibles pour le ciblage et l’optimisation publicitaires (le cas échéant). Si aucun nom d’évènement standard ne correspond à l’action de l’utilisateur ou de l’utilisatrice et si aucun rapport publicitaire n’est nécessaire, vous pouvez proposer un champ libre pour permettre la saisie d’un nom d’évènement et de paramètres personnalisés.

Autorisations

L’autorisation page_events requise doit être obtenue durant le flux Facebook Login de votre application. Vous devez l’ajouter au périmètre d’autorisation demandé du Bouton Login, à l’appel du SDK Facebook pour JavaScript ou à votre flux de connexion créé manuellement, comme indiqué dans ce guide.

Ressources supplémentaires

• Guide des recommandations sur les App Events : inclut des recommandations pour savoir quels évènements utiliser en fonction du type d’application choisi.