В этом руководстве рассказывается, как создавать и публиковать рекламу с переходом в несколько мест назначения с помощью Marketing API.
В такой рекламе люди, нажавшие объявление, перенаправляются в переписку с вашей компанией в приложениях для обмена сообщениями (Messenger, Instagram или WhatsApp), из которых они, скорее всего, предпочтут ответить. Используйте ее, чтобы масштабировать охват и обеспечивать персонализированное высококачественное обслуживание.
Реклама с несколькими метами назначения может перенаправлять пользователей в любую комбинацию мест назначения: чат в Messenger, Instagram и WhatsApp.
Если вы хотите создать рекламу, которая перенаправляет пользователя только в одно место назначения, обратитесь к этим статьям:
В этом документе перечислены действия, которые нужно выполнить, чтобы настроить интеграцию для рекламы с переходом в несколько мест назначения. Вам потребуется:
Это руководство написано с расчетом, что:
Начните с создания рекламной кампании. Для этого отправьте запрос POST
к конечной точке /act_<AD_ACCOUNT_ID>/campaigns
и укажите в качестве <AD_ACCOUNT_ID>
ID своего аккаунта Meta. Запрос должен содержать следующие параметры:
Имя | Описание |
---|---|
Строка | Обязательный параметр. |
Перечисление | Обязательный параметр. |
Список<Object> | Обязательный параметр. |
Перечисление | Необязательный параметр. |
curl -X POST \
-F 'name=Click to Multi Destination Campaign' \
-F 'objective=OUTCOME_ENGAGEMENT' \
-F 'status=ACTIVE' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/campaigns
В случае успеха приложение получит ответ JSON, содержащий ID созданной кампании.
{ "id": "<AD_CAMPAIGN_ID>" }
Чтобы обновить кампанию, выполните запрос POST
к конечной точке /<AD_CAMPAIGN_ID>
.
Чтобы убедиться, что кампания с переходом в несколько мест назначения создана, выполните запрос GET
к конечной точке /<AD_CAMPAIGN_ID>
. Полный список доступных параметров см. в справке по рекламным кампаниям.
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_CAMPAIGN_ID>
{ "name": "Click to Multi Destination Campaign", "status": "ACTIVE", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_CAMPAIGN_ID>" }
После создания кампании нужно создать группу объявлений. Для этого отправьте запрос POST
к конечной точке /act_<AD_ACCOUNT_ID>/adsets
и укажите в качестве <AD_ACCOUNT_ID>
ID своего аккаунта Meta. Запрос должен содержать следующие параметры:
Имя | Описание |
---|---|
32-разрядное целое число без знака | Обязательный параметр, если для bid_strategy выбрано значение |
Перечисление | Необязательный параметр. |
Перечисление | Обязательный параметр. |
Строка цифр или целое число | Обязательный параметр. |
64-разрядное целое число | Обязательный параметр, если не задан параметр |
Строка | Обязательный параметр.
Примечание. Если вы добавляете место назначения WhatsApp, убедитесь, что к вашей Странице подключен номер телефона WhatsApp компании. Если вы добавляете место назначения Instagram, убедитесь, что к вашей странице подключен бизнес-аккаунт Instagram. |
Дата и время | Обязательный параметр, если указан параметр |
64-разрядное целое число | Обязательный параметр, если не задан параметр |
Строка | Обязательный параметр. |
Перечисление | Обязательный параметр. |
| Обязательный параметр.
Подробнее см. в статье Продвигаемый объект группы объявлений. |
Дата и время | Необязательный параметр. |
Перечисление | Необязательный параметр. |
Объект таргетинга | Обязательный параметр. |
Дата и время | Необязательный параметр. |
Дата и время | Обязательный параметр, если указан параметр |
Полный список доступных параметров см. в справке по группам объявлений рекламного аккаунта.
curl -X POST \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
-F 'billing_event=IMPRESSIONS' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'daily_budget=<DAILY_BUDGET>' \
-F 'destination_type=<DESTINATION_TYPE>' \
-F 'name=<AD_SET_NAME>' \
-F 'optimization_goal=CONVERSATIONS' \
-F 'promoted_object={
"page_id": "<PAGE_ID>"
}' \
-F 'status=ACTIVE' \
-F 'start_time=<START_TIME>' \
-F 'targeting={
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"]
}' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/adsets
В случае успеха приложение получит ответ JSON, содержащий ID созданной группы объявлений.
{ "id": "<AD_SET_ID>" }
Чтобы обновить группу объявлений, выполните запрос POST
к конечной точке /<AD_SET_ID>
.
Чтобы убедиться, что группа объявлений с переходом в несколько мест назначения создана, выполните запрос GET
к конечной точке /<AD_SET_ID>
. Полный список доступных параметров см. в справке по группам объявлений.
curl -X GET -G \
-d 'fields=name,destination_type,optimization_goal,bid_strategy' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_SET_ID>
{ "name": "<AD_SET_NAME>", "destination_type": "<DESTINATION_TYPE>", "optimization_goal": "CONVERSATIONS", "bid_strategy": "LOWEST_COST_WITHOUT_CAP'" "id": "<AD_SET_ID>" }
С помощью рекламного креатива вы можете добавить объекты в свою рекламу. Чтобы создать рекламный креатив, отправьте запрос POST
к конечной точке /act_<AD_ACCOUNT_ID>/adcreatives
и укажите в качестве <AD_ACCOUNT_ID>
ID своего аккаунта Meta. Запрос должен содержать следующие параметры:
Имя | Описание |
---|---|
| Обязательный параметр. Обязательные параметры:
Messenger { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } } { "type": "WHATSAPP_MESSAGE", "value": { "app_destination": "WHATSAPP", "link": "https://api.whatsapp.com/send" } } { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } |
Строка | Обязательный параметр. |
| Обязательный параметр. Обязательные параметры:
Необязательные параметры:
|
| Необязательный параметр. |
Полный список доступных параметров см. в справке по рекламному креативу.
По умолчанию пользователь видит сообщение "Здравствуйте! Можно получить дополнительную информацию об этом?". Вы можете сделать свою рекламу с переходом в несколько мест назначения более удобной для пользователей, настроив приветственное сообщение, вводные фразы и автозаполнение сообщений в page_welcome_message
поле в object_story_spec
.
Добавление вводных фраз и приветственного сообщения
"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 -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
"page_id": "438346666550309",
"link_data": {
"name": "<AD_HEADLINE>",
"message": "<AD_PRIMARY_TEXT>",
"image_hash": "<IMAGE_HASH>"
"link": "https://fb.com/messenger_doc/",
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": {
"app_destination": "MESSENGER"
}
}
}
}' \
-F 'asset_feed_spec={
"optimization_type": "DOF_MESSAGING_DESTINATION",
"call_to_actions": [
{
"type": "MESSAGE_PAGE",
"value": {
"app_destination": "MESSENGER",
"link": "https://fb.com/messenger_doc/"
}
},
{
"type": "WHATSAPP_MESSAGE",
"value": {
"app_destination": "WHATSAPP",
"link": "https://api.whatsapp.com/send"
}
},
{
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT",
"link": "https://www.instagram.com"
}
}
]
}' \
-F 'degrees_of_freedom_spec={
"creative_features_spec": {
"standard_enhancements": {
"enroll_status": "OPT_IN"
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/adcreatives
В случае успеха приложение получит ответ JSON, содержащий ID созданного рекламного креатива.
{ "id": "<AD_CREATIVE_ID>" }
Чтобы обновить рекламный креатив, выполните запрос POST
к конечной точке /<AD_CREATIVE_ID>
.
Чтобы убедиться, что рекламный креатив с переходом в несколько мест назначения создан, выполните запрос GET
к конечной точке /<AD_CREATIVE_ID>
. Полный список доступных параметров см. в статье Рекламный креатив.
curl -X GET -G \
-d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_CREATIVE_ID>
{ "name": "<CREATIVE_NAME>", "object_story_spec": { "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": "Sample greeting message", "ice_breakers": [ { "title": "Sample icebreaker" }, { "title": "Sample icebreaker" }, { "title": "Sample icebreaker" } ] } } } }, "asset_feed_spec": { "optimization_type": "DOF_MESSAGING_DESTINATION", "call_to_actions": [ { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } }, { "type": "WHATSAPP_MESSAGE", "value": { "app_destination": "WHATSAPP", "link": "https://api.whatsapp.com/send" } }, { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } ] }, "id": "<AD_CREATIVE_ID>" }
Объявления позволяют связать информацию рекламного креатива с группами объявлений. Чтобы создать объявление, отправьте запрос POST
к конечной точке /act_<AD_ACCOUNT_ID>/ads
и укажите в качестве <AD_ACCOUNT_ID>
ID своего аккаунта Meta. Запрос должен содержать следующие параметры:
Имя | Описание |
---|---|
Строка | Обязательный параметр. |
Строка цифр или целое число | Обязательный параметр. |
| Обязательный параметр. |
Перечисление | Обязательный параметр. |
curl -X POST \
-F 'name=<AD_NAME>' \
-F 'adset_id=<AD_SET_ID> \
-F 'creative={
"creative_id": "<AD_CREATIVE_ID>"
}' \
-F 'status=ACTIVE \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/act_<AD_ACCOUNT_ID>/ads
В случае успеха приложение получит ответ JSON, содержащий ID созданного объявления.
{ "id": "<AD_ID>" }
Чтобы обновить объявление, выполните запрос POST
к конечной точке /<AD_ID>
.
Чтобы убедиться, что объявление с переходом в несколько мест назначения создано, выполните запрос GET
к конечной точке /<AD_ID>
. Полный список доступных параметров см. в справке по объявлениям.
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0
/<AD_ID>
{ "status": "ACTIVE", "adset_id": "<AD_SET_ID>", "id": "<AD_ID>" }