Marketing API

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

В этом руководстве рассказывается, как создавать и публиковать рекламу с переходом в WhatsApp с помощью Marketing API.

Реклама с переходом в WhatsApp перенаправляет людей в переписку с вашей компанией в WhatsApp. Используйте ее, чтобы масштабировать охват и обеспечивать персонализированное высококачественное обслуживание.

Реклама с переходом в WhatsApp поддерживает объявления с изображениями, видео, кольцевой галереей и слайд-шоу. В рекламное объявление также можно добавить подсказки "Позвонить".

Если вы хотите создавать рекламу, которая перенаправляет людей в чаты Messenger или Instagram, ознакомьтесь со статьями Реклама с переходом в Messenger и Реклама с переходом в Instagram. Кроме того, можно создавать рекламу с переходом в место назначения, из которого пользователь предпочтет ответить с наибольшей вероятностью. Подробнее см. в статье Реклама с переходом в несколько мест назначения.

Обзор создания рекламы

В этом документе перечислены действия, которые нужно выполнить, чтобы настроить интеграцию для рекламы с переходом в WhatsApp.

Вам потребуется:

  1. Создать рекламную кампанию.
  2. Создать группу объявлений, которая связывает ваши объявления с рекламной кампанией.
  3. Создать рекламный креатив для типа рекламы с переходом в WhatsApp, которую вы хотите показывать.
  4. Создать рекламу, связав рекламный креатив с группой объявлений.
  5. Опубликовать свою рекламу на Facebook, в Instagram и Messenger.

Прежде чем начать

Это руководство написано с расчетом, что:

Для успешных вызовов к конечным точкам, упомянутым в этом руководстве, вам потребуются:

  • маркер доступа к Странице, запрошенный пользователем, который может выполнять действие ADVERTISE на этой Странице;
  • следующие разрешения, предоставленные человеком через ваше приложение:
    • ads_management;
    • pages_manage_ads;
    • pages_read_engagement;
    • pages_show_list.

Шаг 1. Создание рекламной кампании

Начните с создания рекламной кампании. Для этого отправьте запрос POST к конечной точке /act_<AD_ACCOUNT_ID>/campaigns и укажите в качестве <AD_ACCOUNT_ID> ID своего аккаунта Meta. Запрос должен содержать следующие параметры:

Параметры

ИмяОписание

name

Строка

Обязательный параметр.
Имя кампании с переходом в WhatsApp.

objective

Перечисление

Обязательный параметр.
Цель кампании.
Поддерживаются следующие цели: OUTCOME_ENGAGEMENT, OUTCOME_SALES и OUTCOME_TRAFFIC.
Примечание. Для кампаний с подсказкой "Позвонить" для параметра objective необходимо установить значение OUTCOME_ENGAGEMENT.

special_ad_categories

Список<Object>

Обязательный параметр.
Специальные категории рекламы, связанные с кампанией с переходом в WhatsApp. Подробнее см. в справке по рекламным кампаниям.

status

Перечисление

Необязательный параметр.
Допустимые значения: PAUSED и ACTIVE.
Если для этого статуса установлено значение PAUSED, все активные группы объявлений и объявления приостанавливаются и получают статус CAMPAIGN_PAUSED.

Стандартный запрос

curl -X POST \
  -F 'name=Click to WhatsApp Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Запрос на создание кампании

curl -X POST \
  -F 'name=Click to WhatsApp Calling Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Ответ

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

{
  "id": "<AD_CAMPAIGN_ID>"
}

Обновление

Чтобы обновить кампанию, выполните запрос POST к конечной точке /<AD_CAMPAIGN_ID>.

Чтение

Чтобы убедиться, что кампания с переходом в WhatsApp создана, выполните запрос GET к конечной точке /<AD_CAMPAIGN_ID>. Полный список доступных параметров см. в справке по рекламным кампаниям.

Запрос

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

Ответ

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Шаг 2. Создание группы объявлений

После создания кампании нужно создать группу объявлений. Для этого отправьте запрос POST к конечной точке /act_<AD_ACCOUNT_ID>/adsets и укажите в качестве <AD_ACCOUNT_ID> ID своего аккаунта Meta. Запрос должен содержать следующие параметры:

Параметры

ИмяОписание

bid_amount

32-разрядное целое число без знака

Обязательный параметр, если для bid_strategy выбрано значение LOWEST_COST_WITH_BID_CAP или COST_CAP.
Максимальная сумма, которую вы готовы заплатить за результат исходя из вашей optimization_goal.

bid_strategy

Перечисление

Необязательный параметр.
Задает для этой кампании стратегию ставок в соответствии с конкретными бизнес-целями. Подробнее см. в справке по рекламным кампаниям.
Значения:LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP

billing_event

Перечисление

Обязательный параметр.
Для рекламы с переходом в WhatsApp установите значение IMPRESSIONS. Meta взимает с вас плату за каждый показ вашей рекламы пользователям.

campaign_id

Строка цифр или целое число

Обязательный параметр.
Действительная кампания с переходом в WhatsApp, в которую нужно добавить это объявление.

daily_budget

64-разрядное целое число

Обязательный параметр, если не задан параметр lifetime_budget.
Дневной бюджет в валюте вашего аккаунта. Допускается только для групп объявлений с продолжительностью (разностью между end_time и start_time) более 24 часов.
Значение daily_budget или lifetime_budget должно быть больше 0.

destination_type

Строка

Обязательный параметр.
Для рекламы с переходом только в WhatsApp установите WHATSAPP.

end_time

datetime

Обязательный параметр, если указан параметр lifetime_budget.
Создавая группу объявлений с параметром daily_budget, укажите end_time=0 или оставьте это поле пустым, чтобы группа объявлений была бессрочной (без даты окончания).
Примеры:2015-03-12 23:59:59-07:00 или 2015-03-12 23:59:59 PDT. Метка времени UNIX в часовом поясе UTC.

lifetime_budget

64-разрядное целое число

Обязательный параметр, если не задан параметр daily_budget.
Бюджет группы объявлений на весь срок действия в валюте вашего аккаунта. Если он указан, необходимо также указать end_time.
Значение daily_budget или lifetime_budget должно быть больше 0.

name

Строка

Обязательный параметр.
Имя группы объявлений с переходом в WhatsApp.

optimization_goal

Перечисление

Обязательный параметр.
Цель оптимизации для группы объявлений. В зависимости от цели кампании группа объявлений может иметь разные цели оптимизации.


OUTCOME_ENGAGEMENT — цель "Вовлеченность". Возможна оптимизация для CONVERSATIONS и LINK_CLICKS.
OUTCOME_SALES — цель "Продажи". Возможна оптимизация для CONVERSATIONS, OFFSITE_CONVERSIONS, LINK_CLICKS, IMPRESSIONS и REACH.
OUTCOME_TRAFFIC — цель "Трафик". Возможна оптимизация для CONVERSATIONS, LANDING_PAGE_VIEWS, LINK_CLICKS, IMPRESSIONS, REACH и POST_ENGAGEMENT.

promoted_object

Обязательный параметр.
Объект, рекламируемый во всех объявлениях этой группы. В рекламе с переходом в WhatsApp для параметра promoted_object действуют следующие условия.

Обязательно:

  • page_id — обязательное поле, ID Страницы Facebook.

Необязательно:

  • whatsapp_phone_number — номер телефона WhatsApp, связанный с группой объявлений с переходом в WhatsApp.

Подробнее см. в статье Продвигаемый объект группы объявлений.

start_time

datetime

Необязательный параметр.
Время начала показа группы объявлений. Если значение не указано, по умолчанию устанавливается текущее время.
Примеры:2015-03-12 23:59:59-07:00 или 2015-03-12 23:59:59 PDT. Метка времени UNIX в часовом поясе UTC.

status

Перечисление

Необязательный параметр.
Статус группы объявлений. Может отличаться от фактического статуса в силу родительской кампании. Если значение не указано, по умолчанию устанавливается значение ACTIVE.
Значения:ACTIVE, PAUSED, DELETED, ARCHIVED

targeting

Объект таргетинга

Обязательный параметр.
Структура таргетинга рекламы с переходом в WhatsApp. Подробнее см. в статье Таргетинг.

time_start

datetime

Необязательный параметр.
Взаимозаменяем с start_time.

time_stop

datetime

Обязательный параметр, если указан параметр lifetime_budget.
Взаимозаменяем с end_time.

Полный список доступных параметров см. в справке по группам объявлений рекламного аккаунта.

Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "access_token":"<ACCESS_TOKEN>",
    "bid_amount":"<BID_AMOUNT>",
    "billing_event":"IMPRESSIONS",
    "campaign_id":"<CAMPAIGN_ID>",
    "daily_budget":"<DAILY_BUDGET>",
    "destination_type":"WHATSAPP",
    "name": "<AD_SET_NAME>",
    "optimization_goal": "IMPRESSIONS",
    "promoted_object": {
      "page_id": "<PAGE_ID>"
    },
    "status": "PAUSED",
    "start_time": "<START_TIME>",
    "targeting": { 
      "geo_locations": { "countries":["US","CA"] },
      "device_platforms": ["mobile", "desktop"]
    } 
  }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets"

Ответ

{
  "id": "<AD_SET_ID>"
}

Обновление

Чтобы обновить группу объявлений, выполните запрос POST к конечной точке /<AD_SET_ID>.

Чтение

Чтобы убедиться, что группа объявлений с переходом в WhatsApp создана, выполните запрос GET к конечной точке /<AD_SET_ID>. Полный список доступных параметров см. в справке по группам объявлений.

Запрос

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy,status' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>

Ответ

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_SET_ID>"
}

Шаг 3. Создание рекламного креатива

С помощью рекламного креатива вы можете добавить объекты в свою рекламу. Чтобы создать рекламный креатив, отправьте запрос POST к конечной точке /act_<AD_ACCOUNT_ID>/adcreatives и укажите в качестве <AD_ACCOUNT_ID> ID своего аккаунта Meta. Запрос должен содержать следующие параметры:

Параметры

ИмяОписание

name

Строка

Обязательный параметр.
Имя рекламного креатива.

object_story_spec

Обязательный параметр.
Объект, содержащий информацию о сообщении. Подробнее см. в этой статье.


Обязательно:

  • page_id — ID страницы Facebook.

Необязательно:

  • link_data — данные для публикации со ссылкой на Странице или в кольцевой галерее;
  • photo_data — данные для публикации с фото на Странице;
  • text_data — данные для текстовой публикации на Странице;
  • video_data — данные для публикации с видео на Странице.

degrees_of_freedom_spec

Необязательный параметр.
Подробнее см. в статье Стандартные улучшения в креативе Advantage+.

Полный список доступных параметров см. в справке по рекламному креативу.

Заполнение приветственного сообщения Страницы

По умолчанию пользователь видит сообщение "Здравствуйте! Можно получить дополнительную информацию об этом?". Вы можете сделать свою рекламу с переходом в WhatsApp более удобной для пользователей, настроив приветственное сообщение, вводные фразы и автозаполнение сообщений в поле page_welcome_message в object_story_spec.

Примечание. Если вы используете сообщение WhatsApp для запуска каких-либо процессов ботов, для обновления обязательно обратитесь к своему поставщику бизнес-решений и агентствам, чтобы работа процессов не нарушилась.

Пример

Добавление сообщения с автозаполнением и приветственным сообщением

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
  "media_type": "text",
  "text_format": {
    "customer_action_type": "autofill_message",
    "message": {
      "autofill_message": {
        "content": "<AUTOFILL_MESSAGE>"
      },
      "text": "<GREETING_MESSAGE>"
    }
  }
}

Добавление вводных фраз и приветственного сообщения

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
    "media_type": "text",
    "text_format": {
      "customer_action_type": "ice_breakers",
      "message": {
        "text": "<GREETING_MESSAGE>",
        "ice_breakers": [
          {
            "title": "<ICEBREAKER>"
          },
          {
            "title": "<ICEBREAKER>"
          },
          {
            "title": "<ICEBREAKER>"
          }
        ]
      }
    }
  }
}

Добавление сообщения с подсказкой "Позвонить"

curl \
  -F 'object_story_spec={
      "page_id": "<PAGE_ID>"
      "link_data": {
     "image_hash":<IMAGE_HASH>
            "call_to_action": {
              	"type": "WHATSAPP_MESSAGE",
              	"value": {
                  	"app_destination": "WHATSAPP"
             	 }
          },
          "link": "https://api.whatsapp.com/send",
          "name": <AD_HEADLINE>",
          "page_welcome_message":
       "type": "VISUAL_EDITOR",
        "version": 2,
        "landing_screen_type": "ctwa_call_prompt",
        "media_type": "text",
        "text_format": {
          "message": {
            "text": "<MESSAGE>"", 
            "call_prompt_data": {
              "call_prompt_message": "<CALL_PROMPT_MESSAGE>"
            }
          }
        },
        "user_edit": false
      },
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Ответ

{
  "id": "<AD_CREATIVE_ID>"
}

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

Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad creative",
        "object_story_spec": {
          "page_id": "<PAGE_ID>",
          "link_data": {
            "name": "<AD_HEADLINE>",
            "message": "<AD_PRIMARY_TEXT>",
            "description": "<AD_DESCRIPTION>",
            "image_hash": "<IMAGE_HASH>",
            "link": "https://api.whatsapp.com/send",
            "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
            "call_to_action": {
              "type": "WHATSAPP_MESSAGE",
              "value": {
                "app_destination": "WHATSAPP"
              }
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives"

Ответ

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

{
  "id": "<AD_CREATIVE_ID>"
}

Создание рекламных креативов с использованием контента Instagram

Для рекламных креативов можно использовать существующий контент Instagram.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "source_instagram_media_id": "<INSTAGRAM_MEDIA_ID>",
        "instagram_user_id": "<INSTAGRAM_USER_ID>",
        "object_id": "<PAGE_ID>",
        "call_to_action": {
          "type": "WHATSAPP_MESSAGE",
            "value": {
              "link": "https://api.whatsapp.com/send",
              "app_destination": "WHATSAPP"
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
  https://graph.facebook.com/latest-api-version />/act_<AD_ACCOUNT_ID>/adcreatives

Обновление

Чтобы обновить рекламный креатив, выполните запрос POST к конечной точке /<AD_CREATIVE_ID>.

Чтение

Чтобы убедиться, что рекламный креатив с переходом в WhatsApp создан, выполните запрос GET к конечной точке /<AD_CREATIVE_ID>. Полный список доступных параметров см. в статье Рекламный креатив.

Запрос

curl -X GET -G \
  -d 'fields=name,object_story_spec{link_data{call_to_action,page_welcome_message}}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Ответ

{
  "name": "Sample ad creative",
  "object_story_spec" {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "autofill_message",
        "message": {
          "autofill_message": {
            "content": "Sample autofill message"
          },
        "text": "Sample greeting message"
        }
      }
    }
  },
  "id": "<AD_CREATIVE_ID>"
}

Шаг 4. Создание объявления

Объявления позволяют связать информацию рекламного креатива с группами объявлений. Чтобы создать объявление, отправьте запрос POST к конечной точке /act_<AD_ACCOUNT_ID>/ads и укажите в качестве <AD_ACCOUNT_ID> ID своего аккаунта Meta. Запрос должен содержать следующие параметры:

Параметры

ИмяОписание

name

Строка

Обязательный параметр.
Имя объявления.

adset_id

Строка цифр или целое число

Обязательный параметр.
ID группы объявлений.

creative

Обязательный параметр.
Рекламный креатив, который будет использоваться в этом объявлении. Вы можете указать creative_id существующего рекламного креатива или создать новый, добавив все обязательные поля. Подробнее см. в статье Рекламный креатив.

status

Перечисление

Обязательный параметр.
Настроенный статус объявления.
Значения:ACTIVE, PAUSED, DELETED, ARCHIVED

Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad",
        "adset_id": "<AD_SET_ID>",
        "creative": {
          "creative_id": "<AD_CREATIVE_ID>"
        },
        "status": "PAUSED"
     }' \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads"

Ответ

{
  "id": "<AD_ID>"
}

Обновление

Чтобы обновить объявление, выполните запрос POST к конечной точке /<AD_ID>.

Чтение

Чтобы убедиться, что объявление с переходом в WhatsApp создано, выполните запрос GET к конечной точке /<AD_ID>. Полный список доступных параметров см. в справке по объявлениям.

Запрос

curl -X GET -G \
  -d 'fields=status,adset_id,campaign_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Ответ

{
  "status": "PAUSED",
  "adset_id": "<AD_SET_ID>",
  "campaign_id": "<AD_CAMPAIGN_ID>",
  "id": "<AD_ID>"
}

Шаг 5. Публикация рекламы

Проверьте свою рекламу в Ads Manager. Чтобы опубликовать изменения, выберите свою кампанию, группу объявлений для кампании и само объявление и нажмите кнопку Опубликовать.

Для публикации рекламы также можно использовать API. Отправьте запрос POST к конечной точке /<AD_ID>, установив для параметра status значение ACTIVE (<AD_ID> — это объявление, которое вы хотите опубликовать).

Meta проверит вашу рекламу (в это время она будет иметь статус PENDING_REVIEW). После утверждения реклама автоматически перейдет в статус ACTIVE и начнется ее показ.