Anúncios de clique para o Messenger

Anúncios de clique para o Messenger

Para fornecer o criativo do anúncio de clique para o Messenger, envie uma solicitação POST ao ponto de extremidade /act_ad_account_id/adcreatives, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

• access_token
• name
• object_story_spec com um objeto *_data que define o tipo de mídia

Referência rápida sobre anúncio com imagem

Exemplo de solicitação de anúncio com imagem

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

Referência rápida sobre anúncio em vídeo de clique para o Messenger

Exemplo de solicitação de anúncio em vídeo

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

Anúncio que usa um fluxo de mensagens configurado em um app parceiro.

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

Para saber mais sobre fluxos de mensagens em apps, consulte Welcome message flows na documentação da plataforma do Messenger.

Clique para assinar

Os anúncios de clique para assinar (CTS, pelas iniciais em inglês) são anúncio de clique para o Messenger que incluem uma matriz de objetos object_story_spec.page_welcome_message com um modelo de mensagem de notificação. Ao clicar no botão Receber mensagens no anúncio, a pessoa concorda em receber mensagens de marketing da sua empresa.

Para fornecer um criativo do anúncio com clique para assinar, envie uma solicitação POST ao ponto de extremidade /act_ad_account_id/adcreatives, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

• access_token
• name
• object_story_spec com

  • um objeto *_data que define o tipo de mídia
  • a matriz page_welcome_message que define a solicitação de aceitação de mensagens de marketing. Precisa incluir landing_screen_type definido como marketing_messages e o anexo da mensagem payload.template_type definido como nofitication_messages

Exemplo de solicitação de anúncio com imagem

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

Anúncios de lead em conversas

Com os anúncios do Messenger para leads, você pode gerar leads no Messenger usando um modelo de bate-papo automatizado. É possível fazer perguntas específicas às pessoas que estão interessadas na sua empresa diretamente da sua plataforma de mensagens favorita, além de coletar as preferências dos clientes e fazer perguntas personalizadas para priorizar os leads mais qualificados.

Requisitos do modelo de mensagem

• Uma mensagem de boas-vindas que exibe uma saudação às pessoas após elas tocarem no seu anúncio e informa o que sua empresa tem a oferecer.
• Perguntas que coletam as informações necessárias para saber se a pessoa pode ser convertida em um lead. Podem ser perguntas sobre interesses, localização e informações de contato, como email e número de telefone.
• Uma mensagem de confirmação em que você agradece às pessoas pelas respostas e informa quais são os próximos passos. Você encontrará os novos leads no seu Gerenciador de Anúncios, na ferramenta de publicação da sua Página ou no CRM.
• Uma Política de Privacidade, já que você coletará informações dos clientes.

Limitações

• Os modelos de mensagem não podem ser editados nem excluídos depois de criados.

Criar um modelo de mensagem

Para criar um modelo de mensagem, envie uma solicitação POST ao ponto de extremidade /page_id/messenger_lead_forms, sendo page_id a identificação da Página do Facebook da sua empresa. A solicitação precisa incluir:

• access_token
• privacy_url
• A matriz step_list com message, reply_type, step_id e step_type
• template_name
• reminder_text

O modelo de mensagem a seguir inclui o template_name, o privacy_url, a step_list com uma mensagem de boas-vindas em step_id: 0, perguntas em step_id: 1 a 4, uma mensagem de confirmação em step_id: 5 e uma mensagem de desqualificação em step_id: 6.

Referência rápida para modelos de mensagem

Exemplo de modelo de mensagem para leads

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

Caso ela seja bem-sucedida, o app receberá um objeto JSON com a identificação do modelo.

{
  "id": "your_messenger_lead_gen_template_id"
}

Um fblead_form também é criado e associado ao modelo de mensagem como parte deste processo.

Obter uma lista de formulários

Para obter uma lista dos modelos de formulários para geração de leads do Messenger, envie uma solicitação GET ao ponto de extremidade /page_id/messenger_lead_forms. Também é possível obter informações sobre um modelo específico enviando uma solicitação GET ao ponto de extremidade /Your_messenger_lead_gen_template_id.

Exemplos de criativo do anúncio

Para fornecer o criativo do anúncio de lead, envie uma solicitação POST ao ponto de extremidade /act_ad_account_id/adcreatives, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

• access_token
• name
• object_story_spec com um objeto *_data que define o tipo de mídia (imagem ou vídeo) e inclui:

  • o parâmetro *_data.page_welcome_message definido como o par chave-valor

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

Exemplo de criativo com imagem em anúncios do Messenger para leads

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

Exemplo de criativo com vídeo em anúncios do Messenger para leads

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