Marketing API

Видеореклама и реклама с кольцевой галереей

Вы можете легко создавать и оптимизировать видеорекламу и рекламу с кольцевой галереей на Facebook, а также отслеживать их показатели с помощью API. См. статью Facebook for Business: реклама с кольцевой галереей. Поддерживаемые форматы видео см. в этой статье Справочного центра для рекламодателей.

Видеореклама

Справочная документация

Чтобы создать видеорекламу для цели VIDEO_VIEWS и оптимизировать ставки для максимизации охвата, выполните следующие действия:

Шаг 1. Предоставление рекламных креативов

Создайте объявление, используя ID существующего видео и видео, загруженное на Facebook.

Вам понадобятся:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Слайд-шоу

Если вам нужно распространить кампании бренда на классические телефоны с базовым набором функций на развивающихся рынках (или запустить их там) либо создать простое видео, воспользуйтесь слайд-шоу изображений (нужно как минимум 3 изображения). Загрузите изображения в объект видео. Пример:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

См. статьи Рекомендации по созданию видеокреатива и Справка: видеореклама.

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

Задайте для цели значение VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views 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
  
Open In Graph API Explorer

См. статьи Справка: кампания, Цели рекламы в PHP и Цели рекламы в Python.

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

Если ваша цель — минимизация стоимости просмотра, используйте цель кампании "Просмотры видео" в сочетании с параметром optimization_goal=THRUPLAY группы объявлений. Для параметра bidding_event можно задать значение IMPRESSIONS или THRUPLAY в зависимости от того, собираетесь ли вы платить за показы или за просмотры видео. См. статью Ставки CPV.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Ставки при оплате за просмотры (CPV) для групп объявлений с целью optimization_goal=THRUPLAY ниже по сравнению со ставками CPV для охвата и частоты с оптимизацией для просмотров видео. Дата окончания должна быть в будущем. См. справку по группам объявлений.

Шаг 4. Создание рекламы

Используйте существующую группу объявлений и рекламный креатив:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Если для компании выбрана цель VIDEO_VIEWS, по умолчанию для объявления задаются подходящие параметры отслеживания, которые определяют, какие именно действия для рекламы необходимо отслеживать. Пример для просмотров видео:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

См. Ads Manager: мои кампании и справку по объявлениям.

Пример: узнаваемость бренда

Чтобы создать видеорекламу для повышения узнаваемости бренда, ознакомьтесь с публикацией в блоге об узнаваемости бренда.

Пример: охват и частота

Справочная документация

Чтобы охватить своим видео больше пользователей, задайте для кампании типа "Просмотры видео" цель Охват и частота. Необходимо создать прогноз, зарезервировать его и назначить группе объявлений.

Воспользуйтесь инструкциями по созданию кампании "Просмотры видео", но примените к своей группе объявлений параметры охвата и частоты. Укажите следующие дополнительные параметры:

-F "rf_prediction_id=<RESERVATION_ID>" \

Видео для прямого отклика

Чтобы конвертировать узнаваемость среди пользователей в конкретные действия с их стороны, ознакомьтесь со статьей Видеокреатив в формате кольцевой галереи.

  • Охватите людей, которые просмотрели видео. Узнайте, как перейти от узнаваемости к приверженности и рассмотрению. См. статью о ремаркетинге.
  • Создайте контакт с брендом и продукцией. Добавьте призыв зайти на определенную страницу на вашем сайте. См. статью о призывах к действию.

Ремаркетинг

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

Чтобы создать аудиторию для видео, необходимы разрешения рекламодателя для страницы, содержащей это видео.

Установите для аудитории параметр subtype=ENGAGEMENT. Затем составьте правила для аудитории, которую нужно создать. У каждого правила есть идентификатор object_id, например ID видео, а также имя события event_name. Параметр event_name может принимать следующие значения:

  • video_watched — количество просмотров видео в совокупности в течение как минимум 3 секунд или почти полностью (в зависимости от того, что произошло раньше);
  • video_completed — количество просмотров видео на 95 %, включая просмотры, когда человек прокрутил видео до этого момента;
  • video_view_10s — количество просмотров видео в совокупности в течение как минимум 10 секунд или почти полностью (в зависимости от того, что произошло раньше);
  • video_view_15s — количество просмотров видео в совокупности в течение как минимум 15 секунд или почти полностью (в зависимости от того, что произошло раньше);
  • video_view_25_percent — количество просмотров видео на 25 %, включая просмотры, когда человек прокрутил видео до этого момента;
  • video_view_50_percent — количество просмотров видео на 50 %, включая просмотры, когда человек прокрутил видео до этого момента;
  • video_view_75_percent — количество просмотров видео на 75 %, включая просмотры, когда человек прокрутил видео до этого момента.

Чтобы создать аудиторию на основе различных видео и действий, можно использовать комбинации. Например, аудитория может состоять из пользователей, просмотревших видео А в течение 3 секунд, а также тех, кто полностью просмотрел видео Б и В.

Следующий код позволяет создать аудиторию пользователей, которые за последние 14 дней смотрели видео 1 в течение не менее чем 3 секунд, а также пользователей, которые полностью просмотрели видео 2. Если задан параметр prefill=true, аудитория перед созданием автоматически заполняется зрителями.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Обратное заполнение поддерживается для просмотров видео после 16 октября 2015 г.

Призыв к действию

Видео с призывом к действию предлагают пользователям зайти на определенную страницу сайта, чтобы ознакомиться с более подробной информацией. Вы можете улучшить результаты, когда основная цель состоит в увеличении количества просмотров видео или повышении узнаваемости бренда, а дополнительная — в увеличении количества кликов вне сайта. Для дополнительной цели следует использовать видеорекламу со ссылками. Порядок отображения призыва к действию:

  • на мобильных устройствах и ПК он отображается как часть публикации, а при приостановке видео — рядом с кнопкой возобновления;
  • если пользователь нажимает видео на мобильном устройстве, чтобы посмотреть его в полноэкранном режиме, призыв к действию отображается в виде наложения на видео;
  • в публикациях со ссылками на внешние видео призыв к действию не отображается.

Видео с призывом к действию можно использовать только со следующими целями кампании:

См. статью о добавлении целей для видеорекламы. Этот код создает видеорекламу с призывом к действию GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Метрики для видео

Статистика видеопубликации: органическая реклама

Справочная документация

Узнайте о результативности своей видеорекламы на Facebook и принимайте более информированные решения в отношении видеоконтента. В настоящее время мы предлагаем метрики, только когда пользователь начинает просматривать видео. Они включают в себя количество просмотров видео (в том числе уникальных), среднюю продолжительность такого просмотра и показатель удержания аудитории. Вы можете узнать, на каком этапе зрители прерывают просмотр и какие фрагменты видео кажутся им наиболее интересными.

Статистика видеопубликации: оплаченная реклама

Используйте Ads Insights API. Соответствующий ответ содержит различные метрики видео.

Тип видео

Можно получить статистику видеорекламы с группировкой по типам видео (например, с автозапуском или без него). Добавьте параметр action_video_type в раздел action_breakdowns. Параметр action_video_type может принимать значения total, click_to_play и auto_play.

В настоящее время параметр action_video_type работает в режиме ограниченного тестирования. Для идентификации клиентов с разбивкой используйте параметр CAN_USE_VIDEO_METRICS_BREAKDOWN своего рекламного аккаунта.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

Ответ содержит объекты со значением video_view для параметра action_type и ключом action_video_type:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

См. Ads Insights API.

Добавьте креативную рекламу своей недвижимости в Ленту и привлекайте пользователей на свой сайт или в приложение, где они смогут совершить покупку. Рекламу с кольцевой галереей можно создать двумя способами:

Реклама с кольцевой галереей не поддерживается в историях на Facebook.

Параллельное создание

Создать публикацию Страницы с рекламой с кольцевой галереей можно при создании рекламного креатива. Задайте контент публикации Страницы в параметре object_story_spec. Будет создана неразмещенная публикация Страницы на базе adcreatives. См. статью о рекламных креативах. Пример:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

В ответе передается ID креатива:

{"id":"<CREATIVE_ID>"}

Создание публикации, а затем рекламы

Создайте неразмещенную публикацию Страницы. child_attachments — это массив объектов ссылок. В каждом объекте ссылки параметры picture, name и description являются необязательными. Для публикации от имени Страницы необходим маркер доступа к Странице.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Затем создайте рекламный креатив на базе неразмещенной публикации Страницы. Используйте id как object_story_id в рекламном креативе.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Создание рекламы с кольцевой видеогалереей

Реклама с кольцевой галереей видео может содержать "подпись" в качестве дочернего прикрепленного объекта, позволяющего настроить URL, отображаемый на экране конечного пользователя:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Чтобы получить данные дочерних прикрепленных объектов, используйте ID и сделайте вызов Graph API (справка по видео).

Создание рекламы мобильного приложения

Ограничения:

  • Объявления с кольцевой галереей можно использовать для рекламы только одного мобильного приложения.
  • В рекламе с кольцевой галереей для приложений должно быть как минимум 3 изображения (если рекламируется не приложение, достаточно двух).
  • В рекламе с кольцевой галереей для мобильных приложений должен быть призыв к действию.
  • Последняя карточка, которая обычно содержит фото профиля Страницы, в рекламе мобильных приложений не отображается. Примечание. Во всех параметрах child_attachment нужно использовать одну и ту же ссылку на магазин приложений. Повторять ее в call_to_action:{'value':{'link':... }}} не нужно.

Пример создания рекламы с кольцевой галереей для установки приложения:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Разместить публикацию можно только от имени Страницы Facebook, связанной с мобильным приложением. Также необходим маркер доступа к Странице.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Создайте объект AdCreative, используя id из ответа:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Спецификация полей

Это реклама с кольцевой галереей в iOS демонстрирует, как используются описанные поля.

Имя Описание

child_attachments

Тип: объект

Массив, содержащий от 2 до 10 объектов ссылок для рекламы с кольцевой галереей. Для оптимальных результатов следует использовать не менее трех объектов. Для облегченной интеграции можно использовать два объекта, однако в этом случае результаты кампании могут быть хуже.

child_attachments.link

Тип: строка

URL ссылки или URL магазина приложений, прикрепленный к публикации. Обязательный параметр.

child_attachments.picture

Тип: URL

Изображение для предварительного просмотра, связанное со ссылкой. Для оптимального отображения рекомендуется соотношение сторон 1:1 и размер не менее 458 × 458 пикселей. Необходимо указать picture или image_hash.

child_attachments.image_hash

Тип: строка

Хэш изображения для предварительного просмотра, связанного со ссылкой из вашей библиотеки изображений. Рекомендуется соотношение сторон 1:1 и разрешение не менее 458 × 458 пикселей. Необходимо указать picture или image_hash.

child_attachments.name

Тип: строка

Заголовок ссылки для предварительного просмотра. Если он не указан, используется заголовок страницы по этой ссылке. Обычно эта строка усекается до 35 символов. Необходимо задать уникальное имя (name), поскольку в отчетах в интерфейсе Facebook действия упорядочиваются по параметру name.

child_attachments.description

Тип: строка

Цена, скидка или домен сайта. Если этот параметр не указан, соответствующий контент извлекается из целевой страницы. Обычно эта строка усекается до 30 символов.

child_attachments.call_to_action

Тип: объект

Необязательный призыв к действию. См. статью о призывах к действию. Повторять ссылку в call_to_action:{'value':{'link':... }}} не нужно.

child_attachments.video_id

Тип: строка

ID видеорекламы. Может использоваться в любом дочернем объекте. Если этот параметр указан, также должен быть задан параметр image_hash или picture.

message

Тип: строка

Тело публикации (также называется статусом).

link

Тип: строка

URL ссылки "Ещё". Обязательный параметр.

caption

Тип: строка

URL, отображаемый в ссылке "Ещё". Не используется в рекламе мобильного приложения с кольцевой галереей.

multi_share_optimized

Тип: логическое значение

Если задано значение true, изображения и ссылки выбираются и упорядочиваются автоматически. В противном случае используется исходный порядок дочерних элементов. Значение по умолчанию — true.

multi_share_end_card

Тип: логическое значение

Если задано значение false, последняя карточка со значком страницы удаляется. Значение по умолчанию — true.

Статистика рекламы по товарам

Действия для рекламы с кольцевой галереей можно сгруппировать по товарам. Для этого используются параметры actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. У каждого объекта child_attachment имеется собственный ID карточки. Параметры action_carousel_card_id и action_carousel_card_name используются только для рекламы с кольцевой галереей.

Для каждой карточки можно получить следующую статистику:

  • website_ctr — доступно, если указан параметр fields=['website_ctr']
  • app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.* — доступно, если указан параметр fields=['actions']. Другие действия для разбивки по карточкам недоступны.
curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Ответ:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Чтобы получить разбивку затрат по типам действий, также можно запросить cost_per_action_type:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Пример ответа:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}
  • Метрики разбивки для кольцевой галереи для параметра action_report_time=impression до 20 июня 2015 г. являются неточными.
  • Метрики разбивки для кольцевой галереи для параметра action_report_time=conversion до 20 июля 2015 г. являются неточными.

Места размещения

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

Пример создания группы объявлений с единственным местом размещения right_hand_column:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Предоставление рекламного креатива с видео:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

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

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

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

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Если вы получите сообщение об ошибке, предоставьте поддерживаемый креатив или измените таргетинг.

См. также