Реклама с переходом в Messenger

Реклама с переходом в Messenger

Чтобы создать рекламный креатив для рекламы с переходом в Messenger, отправьте запрос POST к конечной точке /act_ad_account_id/adcreatives, где ad_account_id — ID вашего рекламного аккаунта Meta. Запрос должен содержать следующие параметры:

• access_token;
• name
• object_story_spec с объектом *_data, определяющим тип медиафайла.

Краткая справка по рекламным изображениям

Пример запроса для рекламного изображения

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

Краткая справка по видеообъявлениям с переходом в Messenger

Пример запроса для видеообъявления

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

Реклама с использованием потока сообщений, настроенная в партнерском приложении

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

Дополнительную информацию о потоках сообщений в приложении см. в документации по платформе Messenger.

Реклама с переходом к подписке

Реклама с переходом к подписке — это разновидность рекламы с переходом в Messenger, где object_story_spec.page_welcome_message представляет собой массив объектов с шаблоном сообщения-уведомления. Когда пользователь нажимает кнопку Получать сообщения в вашем объявлении, он соглашается получать маркетинговые сообщения от вашей компании.

Чтобы создать рекламный креатив для рекламы с переходом к подписке, отправьте запрос POST к конечной точке /act_ad_account_id/adcreatives, где ad_account_id — ID вашего рекламного аккаунта Meta. Запрос должен содержать следующие параметры:

• access_token;
• name;
• object_story_spec с:

  • объектом *_data, определяющим тип медиафайла;
  • массивом page_welcome_message, который задает предложение согласиться на получение маркетинговых сообщений (он должен содержать параметр landing_screen_type со значением marketing_messages и вложение в сообщение payload.template_type со значением nofitication_messages).

Пример запроса для рекламного изображения

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

Реклама для лидов в переписках

С помощью рекламы в Messenger для лидов вы можете генерировать лиды в Messenger с использованием шаблона автоматического чата. Вы можете задавать определенные вопросы людям, которые интересуются вашей компанией, прямо на выбранной вами платформе для обмена сообщениями, собирать информацию о предпочтениях клиентов и создавать пользовательские вопросы, позволяющие сосредоточить внимание на самых качественных лидах.

Требования к шаблонам сообщений

• Приветственное сообщение, которое пользователь видит, нажав ваше объявление, и которое объясняет ему, что может предложить ваша компания.
• Вопросы для сбора информации, позволяющие определить, является ли этот пользователь лидом. Это могут быть вопросы о его интересах, местоположении и контактных данных, таких как электронная почта и номер телефона.
• Сообщение с подтверждением, позволяющее поблагодарить человека за его ответы и объяснить ему, что произойдет дальше. Ваш новый лид появится в Ads Manager, в инструменте для публикации вашей Страницы или в вашей CRM.
• Политика конфиденциальности, которая необходима, так как вы собираете информацию клиентов.

Ограничения

• После создания шаблон сообщения нельзя отредактировать или удалить.

Создание шаблона сообщения

Чтобы создать шаблон сообщения, отправьте запрос POST к конечной точке /page_id/messenger_lead_forms, где page_id — ID Страницы Facebook вашей компании. Запрос должен содержать следующие параметры:

• access_token;
• privacy_url;
• массив step_list, содержащий message, reply_type, step_id и step_type;
• template_name;
• reminder_text.

Следующий шаблон сообщения содержит значения template_name, privacy_url, step_list с приветственным сообщением в параметре step_id: 0, вопросы в параметрах с step_id: 1 по 4, сообщение с подтверждением в параметре step_id: 5, а также сообщение об исключении в параметре step_id: 6.

Краткая справка по шаблонам сообщений

Пример шаблона сообщения для лидов

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

В случае успеха приложение получит объект JSON, содержащий ID вашего шаблона.

{
  "id": "your_messenger_lead_gen_template_id"
}

В рамках этого процесса также создается объект fblead_form, который связывается с вашим шаблоном сообщения.

Получение списка форм

Чтобы получить список шаблонов форм для генерации лидов в Messenger, отправьте запрос GET к конечной точке /page_id/messenger_lead_forms. Чтобы получить информацию об определенном шаблоне, также можно отправить запрос GET к конечной точке /Your_messenger_lead_gen_template_id.

Примеры рекламных креативов

Чтобы создать рекламный креатив, отправьте запрос POST к конечной точке /act_ad_account_id/adcreatives, где ad_account_id — ID вашего рекламного аккаунта Meta. Запрос должен содержать следующие параметры:

• access_token;
• name
• object_story_spec с объектом *_data, который определяет тип медиафайла (изображение или видео) и содержит:

  • параметр *_data.page_welcome_message, в котором указана пара "ключ-значение".

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id

Пример рекламного креатива для рекламы в Messenger для лидов с изображением

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

Пример рекламного креатива для рекламы в Messenger для лидов с видео

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