Inserzioni che rimandano a Messenger

Inserzioni che rimandano a Messenger

Per creare una creatività dell'inserzione per un'inserzione che rimanda a Messenger, invia una richiesta POST all'endpoint /act_ad_account_id/adcreatives in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

• access_token
• name
• object_story_spec con un oggetto *_data che definisce il tipo di contenuto multimediale

Riferimento rapido per le immagini dell'inserzione

Esempio di richiesta dell'inserzione con immagine

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" }
               }   
             }
           }
         }'          

Riferimento rapido per le inserzioni video che rimandano a Messenger

Esempio di richiesta dell'inserzione video

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"
             } 
           }
         }'

Inserzione che utilizza un flusso di messaggi configurato su un'app partner

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"
             }
           }
         }'

Per ulteriori informazioni sui flussi delle app di messaggistica, consulta Flussi di messaggi di benvenuto nella documentazione della Piattaforma Messenger.

Clic che rimandano all'iscrizione

Le inserzioni che rimandano all'iscrizione (CTS) sono inserzioni che rimandano a Messenger in cui object_story_spec.page_welcome_message corrisponde a un array di oggetti con un modello di messaggio di notifica. Quando una persona clicca sul pulsante Ricevi messaggi nell'inserzione, accetta di ricevere messaggi di marketing dalla tua azienda.

Per creare una creatività dell'inserzione per un'inserzione che rimanda all'iscrizione, invia una richiesta POST all'endpoint /act_ad_account_id/adcreatives in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

• access_token
• name
• object_story_spec con

  • un oggetto *_data che definisce il tipo di contenuto multimediale
  • l'array page_welcome_message che definisce la richiesta di iscrizione per i messaggi di marketing. Deve includere landing_screen_type impostato su marketing_messages e l'allegato del messaggio payload.template_type impostato su nofitication_messages

Esempio di richiesta dell'inserzione con immagine

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"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'          

Inserzioni per acquisizione contatti nelle conversazioni

Le inserzioni che rimandano a Messenger per acquisizione contatti ti consentono di generare contatti su Messenger tramite un modello di chat automatizzato. Puoi porre domande specifiche alle persone interessate alla tua azienda direttamente nella tua piattaforma di messaggistica preferita, raccogliere le preferenze dei clienti e fare domande personalizzate per dare priorità ai contatti più qualificati.

Requisiti del modello di messaggio

• Un messaggio di benvenuto che saluta chi tocca la tua inserzione e fa sapere loro cosa offre la tua azienda
• Domande che raccolgono informazioni sul fatto che la persona sia un contatto. In tale ambito possono essere incluse domande su interessi, posizione e informazioni di contatto come e-mail e numero di telefono.
• Un messaggio di conferma che ti consente di ringraziare le persone per le loro risposte e informarle dei passaggi successivi. Puoi trovare il tuo nuovo contatto in Gestione inserzioni, nello strumento di pubblicazione della tua Pagina o nel tuo CRM.
• Un'Informativa sulla privacy poiché raccoglierai informazioni sui clienti.

Limitazioni

• I modelli di messaggi non possono essere modificati o eliminati dopo la creazione

Creazione di un modello di messaggio

Per creare un modello di messaggio, invia una richiesta POST all'endpoint /page_id/messenger_lead_forms in cui page_id corrisponda all'ID per la Pagina Facebook della tua azienda. La richiesta deve includere:

• access_token
• privacy_url
• Array step_list che includa message, reply_type, step_id e step_type
• template_name
• reminder_text

Il seguente modello di messaggio include template_name, privacy_url, step_list con un messaggio di benvenuto in step_id: 0, le domande in step_id: 1 fino a 4, un messaggio di conferma step_id: 5 e un messaggio per la mancata idoneità in step_id: 6.

Riferimento rapido per il modello di messaggio

Esempio di modello di messaggio per l'acquisizione di contatti

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"
             }
           ]
        }'

In caso di azione eseguita correttamente, l'app riceverà un oggetto JSON contenente l'ID per il modello.

{
  "id": "your_messenger_lead_gen_template_id"
}

Come parte di questa procedura viene anche creato un fblead_form e associato al modello di messaggio.

Acquisizione di una lista di moduli

Per ottenere una lista dei modelli per la generazione di contatti su Messenger, puoi inviare una richiesta GET all'endpoint /page_id/messenger_lead_forms. Puoi anche ottenere informazioni su un modello specifico inviando una richiesta GET all'endpoint /Your_messenger_lead_gen_template_id.

Esempi di creatività dell'inserzione

Per creare una creatività dell'inserzione per le inserzioni per acquisizione contatti, invia una richiesta POST all'endpoint /act_ad_account_id/adcreatives in cui ad_account_id corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

• access_token
• name
• object_story_spec con un oggetto *_data che definisce il tipo di contenuto multimediale, immagine o video, e contenente:

  • il parametro *_data.page_welcome_message impostato sulla coppia chiave-valore

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

Esempio di creatività dell'inserzione per le inserzioni che rimandano a Messenger per acquisizione contatti con un'immagine

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" }"
            }
          }
       }' 

Esempio di creatività dell'inserzione per le inserzioni che rimandano a Messenger per acquisizione contatti con un video

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" 
            }
          }
       }'