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/v19.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/v19.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/v19.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 fazer assinatura

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/v19.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 cadastro em conversas

Com os anúncios do Messenger para cadastros, você pode gerar cadastros 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 cadastros 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 cadastro. 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 cadastros 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, a 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 cadastros

curl -X POST "https://graph.facebook.com/v19.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 cadastros 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 cadastro, 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 cadastros

curl -X POST "https://graph.facebook.com/v19.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 cadastros

curl -X POST "https://graph.facebook.com/v19.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" 
            }
          }
       }' 

Mensagens patrocinadas

As mensagens patrocinadas são um tipo de anúncio que pode ser enviado a qualquer conta da Central de Contas que tiver uma conversa aberta com a Página do Facebook da sua empresa no Messenger. É possível incluir critérios de direcionamento, dados demográficos e geográficos, públicos personalizados ou interesses. Requisitos Não use Públicos Personalizados para impedir que usuários recebam mensagens patrocinadas. targeting.publisher_platforms deve ser messenger. targeting.messenger_positions deve ser sponsored_messages. targeting.device_platforms devem ser mobile e desktop. promoted_object precisa ser a identificação da Página do Facebook da sua empresa. É necessário especificar uma carga ou a URL do botão. Você precisa fornecer opções para recusar o recebimento de mensagens ou bloquear mensagens em dispositivos móveis e desktop. Limitação Só há compatibilidade para CPM com billing_event=IMPRESSIONS e optimization_goal=IMPRESSIONS. O lance mínimo varia conforme o país. Saiba mais. Apenas texto ou imagens com botões ou respostas rápidas são compatíveis.

Para fornecer o criativo do anúncio de mensagem patrocinada, a solicitação deve incluir o parâmetro object_id definido como a identificação da Página do Facebook, o object_type definido como SHARE, o objeto messenger_sponsored_message com o parâmetro message.text definido como o texto do anúncio e o objeto message.attachment com os seguintes parâmetros:

Referência rápida sobre anexo de mensagem patrocinada no Messenger

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

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "attachment":{
                 "type":"template",   
                 "payload":{
                   "template_type":"generic", 
                   "elements":[{
                     "title":"Your_image_text",
                     "image_hash":"Your_image_hash",
                     "buttons":[{
                       "type":"web_url", 
                       "title":"Your_button_text", 
                       "url":"Your_destination_URL"
                     }]
                   }]
                 }
               }
             }
           }
         }'

Exemplo de solicitação de criativo de anúncio com resposta rápida

Para criar uma mensagem patrocinada com resposta rápida, especifique o objeto messenger_sponsored_message.message com text definido como a pergunta ou diretiva, além de uma matriz quick_replies com cada opção de resposta rápida.

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "quick_replies":[
                 {
                   "content_type": "text",
                   "title": "Your_reply_first_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_1_is_selected"
                 },
                 {
                   "content_type": "text",
                   "title": "Your_reply_second_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_2_is_selected"
                 }
               ]              
             }
           }'