Marketing API

Реклама с номером телефона

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

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

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

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

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

Рекомендации

Задайте рабочие часы своей компании в настройках страницы Facebook.

При тестировании вызова API можно добавить параметр access_token и задать в нем маркер доступа. Однако при выполнении безопасных вызовов из приложения следует использоваться класс маркера доступа.

Ограничения

  • Целевая аудитория должна иметь возраст от 18 лет.
  • Номер телефона, указанный в призыве к действию, должен относиться к той же стране, что и целевая аудитория.

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

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

  • name;
  • objective — задайте одну из следующих поддерживаемых целей:
    • OUTCOME_AWARENESS;
    • OUTCOME_ENGAGEMENT;
    • OUTCOME_LEADS;
    • OUTCOME_SALES;
    • OUTCOME_TRAFFIC;
  • special_ad_categories.

Пример запроса

Для удобства чтения применено форматирование. Замените выделенный жирным шрифтом и курсивом текст, например ad_account_id, собственными значениями.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

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

{
  "id": "campaign_id"
}

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

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

  • bid_amount;
  • billing_event — задайте значение IMPRESSIONS;
  • campaign_id;
  • daily_budget;
  • destination_type — задайте значение PHONE_CALL;
  • name;
  • optimization_goal — для рекламы с номером телефона задайте значение QUALITY_CALL;
  • targeting.

Пример запроса

Для удобства чтения применено форматирование. Замените выделенный жирным шрифтом и курсивом текст, например ad_account_id, собственными значениями.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

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

{
  "id": "adset_id"
}

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

С помощью рекламного креатива вы можете добавить объекты в свою рекламу. Поддерживаются кольцевые галереи, только текст и видеообъявления.

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

  • name;
  • object_story_spec;
  • object_story_spec с объектом link_data, определяющим call_to_action (задайте для параметра type значение CALL_NOW и укажите номер телефона вашей компании в качестве значения value).

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

Для удобства чтения применено форматирование. Замените выделенный жирным шрифтом и курсивом текст, например page_access_token, собственными значениями.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

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

{
  "id": "ad_creative_id"
}

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

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

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

Для удобства чтения применено форматирование. Замените выделенный жирным шрифтом и курсивом текст, например ad_account_id, собственными значениями.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

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

{
  "id": "ad_id"
}

Дальнейшие действия

Ознакомьтесь с руководством по началу работы и узнайте, как отправить рекламу на проверку.

Дополнительная информация

Узнайте больше о Marketing API и дополнительных параметрах рекламы с номером телефона.

Справочный центр для бизнеса

Marketing API