Publicités clic vers Messenger

Publicités clic vers Messenger

Pour créer un contenu publicitaire pour une publicité clic vers Messenger, envoyez une requête POST au point de terminaison /act_ad_account_id/adcreatives où ad_account_id est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

• access_token
• name
• object_story_spec avec un objet *_data qui définit le type de contenu multimédia

Référence rapide sur l’image publicitaire

Exemple de requête pour une image publicitaire

curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"page_access_token",
           "name":"Your_CTM_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": { 
               "page_welcome_message": "Your_welcome_message",
               "image_hash": "Your_image_hash", 
               "link": "Your_image_URL", 
               "call_to_action": {
                 "type":"LEARN_MORE",
                 "value":{ "app_destination":"MESSENGER" }
               }   
             }
           }
         }'          

Référence rapide sur la publicité vidéo clic vers Messenger

Exemple de requête pour une publicité vidéo

curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTM_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "video_data": { 
               "call_to_action": {
                 "type": "LEARN_MORE",
                 "value": { "app_destination": "MESSENGER" }
               },
               "link_description": "Your_link_description",
               "image_url": "Your_thumbnail_URL", 
               "page_welcome_message": "Your_welcome_text",
               "video_id": "video_id"
             } 
           }
         }'

Publicité qui utilise un flux de messages configuré sur une application partenaire

curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTM_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "link_data": { 
               "image_hash": "your_image_hash",
               "link": "your_image_URL",
               "call_to_action": {
                 "type": "MESSAGE_PAGE",
                 "value": { "app_destination":"MESSENGER" }
               }   
             }
           },
           "asset_feed_spec": {
             "additional_data": {
               "partner_app_welcome_message_flow_id": "FLOW-ID"
             }
           }
         }'

Pour plus d’informations sur les flux d’applications de messagerie, reportez-vous à la section sur les flux de messages de bienvenue dans la documentation de la plateforme Messenger.

Clic pour s’abonner

Les publicités clic pour s’abonner sont des publicités clic vers Messenger dans lesquelles object_story_spec.page_welcome_message est un tableau d’objets avec un modèle de message de notification. Lorsqu’une personne clique sur le bouton Recevoir des messages dans votre publicité, elle accepte de recevoir des messages marketing de votre entreprise.

Pour créer un contenu publicitaire pour une publicité clic pour s’abonner, envoyez une requête POST au point de terminaison /act_ad_account_id/adcreatives où ad_account_id est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

• access_token
• name
• object_story_spec avec

  • un objet *_data qui définit le type de contenu multimédia ;
  • le tableau page_welcome_message qui définit la requête d’abonnement aux messages marketing. Doit inclure landing_screen_type défini sur marketing_messages et la pièce jointe au message payload.template_type définie sur nofitication_messages

Exemple de requête pour une publicité avec image

curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "page_access_token",
           "name": "Your_CTS_image_ad_name",
           "object_story_spec": {
             "page_id": "your_page_id",
             "link_data": { 
               "image_hash": "Your_image_hash", 
               "link": "Your_image_URL", 
               "call_to_action": {
                 "type": "LEARN_MORE",
                 "value":{ "app_destination": "MESSENGER" }
               }
               "page_welcome_message": "{
                 "landing_screen_type": "marketing_messages",
                 "media_type": "image",
                 "image_format": {
                   "customer_action_type": "buttons",
                   "message": {
                     "text": "Your_welcome_message",
                     "attachment": {
                       "type": "template",
                       "payload":{
                         "template_type":"notification_messages",
                         "elements": [{
                             "title": "Your_CTS_title",
                             "subtitle": "Your_CTS_subtitle",
                             "image_url": "Your_image_URL",
                             "app_id": "Your_Meta_app_ID",
                             "buttons": [{
                               "type": "postback",
                               "payload": "Data_to_include_in_webhook_notification",
                               "title": "Get messages"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'          

Publicités à formulaire dans les conversations

Les publicités Messenger de génération de prospects vous permettent de générer des prospects dans Messenger via un modèle de chat automatisé. Vous pouvez adresser des questions spécifiques aux personnes qui s’intéressent à votre entreprise, directement sur votre plateforme de messagerie favorite, recueillir les préférences de clients et clientes et poser des questions personnalisées pour identifier les prospects les plus prometteurs.

Exigences relatives au modèle de message

• Un message de bienvenue pour saluer les personnes qui appuient sur votre publicité et leur expliquer ce que votre entreprise peut leur offrir.
• Des questions pour déterminer si la personne est un prospect. Ces questions peuvent porter sur les centres d’intérêt de la personne, son adresse et ses coordonnées, par exemple adresse e-mail et numéro de téléphone.
• Un message de confirmation pour remercier la personne d’avoir répondu et lui expliquer la suite. Votre nouveau prospect apparaît dans le Gestionnaire de publicités, dans l’outil de publication de votre Page et dans votre système CRM.
• Une politique de confidentialité puisque vous allez recueillir des informations sur la clientèle.

Limites

• Vous ne pouvez pas modifier ni supprimer les modèles de message après leur création.

Créer un modèle de message

Pour créer un modèle de message, envoyez une requête POST au point de terminaison /page_id/messenger_lead_forms où page_id est l’ID de la Page Facebook de votre entreprise. Votre requête doit inclure :

• access_token
• privacy_url
• Un tableau step_list incluant message, reply_type, step_id et step_type
• template_name
• reminder_text

Le modèle de message suivant inclut votre template_name, votre privacy_url, le tableau step_list avec un message de bienvenue dans step_id: 0, des questions dans step_id: 1 à 4, un message de confirmation dans step_id: 5 et un message de disqualification dans step_id: 6.

Référence rapide des modèles de message

Exemple de modèle de message de génération de prospects

curl -X POST "https://graph.facebook.com/v21.0/your_page_ID/messenger_lead_forms"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token",
           "privacy_url": "Your_privacy_policy_URL",
           "reminder_text": "Your_reminder_text",
           "template_name": "Your_template_name",
           "step_list": [
             {
               "step_id": "0",
               "message": "Your_welcome_message",
               "step_type": "INTRO",
               "reply_type": "NONE",
               "next_step_ids": "1"
             },
             {
               "step_id": "1"
               "message": "Are_you_interested_in_our_products_or_services?",
               "step_type": "QUESTION",
               "reply_type": "QUICK_REPLIES",
               "answers": ["Yes", "Not now", "Maybe"],
               "next_step_ids": [2,6,2],
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "2",
               "message": "What city do you live in?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "CITY",
               "next_step_ids": "3",
               "allow_to_skip": true
             },
             {
               "step_id": "3",
               "message": "What is your phone number?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "PHONE",
               "next_step_ids": "4",
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "4",
               "message": "What is your email address?",
               "step_type": "QUESTION",
               "reply_type": "PREFILL",
               "prefill_type": "EMAIL",
               "next_step_ids": "5",
               "allow_to_skip": false,
               "answer_validation_enabled": true
             },
             {
               "step_id": "5",
               "message": "Your_confirmation_message",
               "step_type": "CONFIRMATION",
               "reply_type": "NONE"
             },
             {
               "step_id": "6",
               "message": "Your_disqualification_message",
               "step_type": "DISQUALIFY",
               "reply_type": "NONE"
             }
           ]
        }'

Si la requête aboutit, votre application reçoit un objet JSON contenant l’ID du modèle.

{
  "id": "your_messenger_lead_gen_template_id"
}

Un fblead_form est également créé et associé au modèle de message dans le cadre de ce processus.

Obtenir la liste des formulaires

Pour obtenir une liste des modèles de formulaire de génération de prospects Messenger, vous pouvez envoyer une requête GET au point de terminaison /page_id/messenger_lead_forms. Vous pouvez également obtenir des informations sur un modèle spécifique en envoyant une requête GET au point de terminaison /Your_messenger_lead_gen_template_id.

Exemples de contenu publicitaire

Pour créer un contenu publicitaire pour une publicité à formulaire, envoyez une requête POST au point de terminaison /act_ad_account_id/adcreatives où ad_account_id est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

• access_token
• name
• object_story_spec avec un objet *_data qui définit le type de contenu multimédia, image ou vidéo, et contient :

  • le paramètre *_data.page_welcome_message défini sur la paire clé-valeur

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

Exemple de contenu publicitaire pour une publicité Messenger de génération de prospects avec image

curl -X POST "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/adcreatives"
    -H "Content-Type: application/json" 
    -d '{
          "access_token": "Your_page_access_token",
          "degrees_of_freedom_spec": {
            "creative_features_spec": {
              "standard_enhancements": { "enroll_status": "OPT_IN" }
            }
          },
          "name": "Your_lead_ad_image_ad_name",
          "object_story_spec": {
            "page_id": "Your_page_id",
            "link_data": {
              "call_to_action": {
                "type": "MESSAGE_PAGE",
                "value": { "app_destination": "MESSENGER" }
              },
              "description": "Sample_description",
              "image_hash": "Your_image_hash", 
              "message": "Sample_message_for_Creative",
              "page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }"
            }
          }
       }' 

Exemple de contenu publicitaire pour une publicité Messenger de génération de prospects avec vidéo

curl -X POST "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/adcreatives"
    -H "Content-Type: application/json" 
    -d '{
          "access_token": "Your_page_access_token",
          "degrees_of_freedom_spec": {
            "creative_features_spec": {
              "standard_enhancements": { "enroll_status": "OPT_IN" }
            }
          },
          "name": "Your_lead_ad_video_ad_name",
          "object_story_spec": {
            "page_id": "your_page_id",
            "video_data": { 
              "call_to_action": {
                "type": "MESSAGE_PAGE",
                "value":{ "app_destination": "MESSENGER" }
              },
              "image_url": "Your_thumbnail_url", 
              "link_description": "Your_link_description ",
              "message": "Sample message for Creative ",
              "page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }",
              "video_id": "Your_video_id" 
            }
          }
       }'