Таргетинг по местам размещения

Узнайте, как показывать рекламу в определенных местах размещения, например только в Ленте на ПК или в Ленте на мобильных устройствах, а также в качестве видео с вознаграждением для Audience Network. В зависимости от цели кампании можно использовать не все места размещения. Дополнительные сведения см. в статье о кампаниях, целях и местах размещения.

Доступны следующие платформы и позиции: device_platforms, publisher_platforms, facebook_positions, audience_network_positions, instagram_positions и messenger_positions. Дополнительные сведения см. в разделе об устройствах, издателях и позициях.

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "facebook"
       ],
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets


Если значение для определенного места размещения не указано, Facebook может использовать все возможные позиции по умолчанию для этого поля. Например, если задать для поля publisher_platforms значение facebook, но не задать никакого значения для поля facebook_positions, Facebook может использовать все варианты по умолчанию для позиций Facebook, такие как feed, right_hand_column и т. д. Если же значение publisher_platforms не указано, Facebook может использовать все варианты publisher_platforms по умолчанию. Facebook также может автоматически учитывать новые позиции и платформы по мере их появления.

В Audience Network можно ограничить круг издателей, которые демонстрируют ваши объявления. Вы можете исключить издателей на основе категорий или создать собственный список с URL в каталоге прилож��ний или URL доменов, которые требуется исключить.

Для видеорекламы, рекламы с подборкой и рекламы на холсте в качестве места размещения нельзя использовать только right_hand_column.

Фильтр контента позволяет контролировать отображение рекламы рядом с контентом различного типа для рекламы в контенте (видеореклама In-Stream на Facebook, реклама в Facebook Reels и реклама в Instagram Reels), рекламы в Audience Network и рекламы в лентах (Лента Facebook, Лента Instagram, Лента Facebook Reels и Лента Instagram Reels). Дополнительные сведения об этих категориях контента см. в статье о фильтре контента в Справочном центре для бизнеса. Для рекламы в контенте, рекламы Audience Network и рекламы в ленте можно выбирать разные значения. Возможные варианты: Expanded, Moderate и Limited. Подробные сведения см. в описании поля brand_safety_content_filter_levels ниже.

Имя Описание

brand_safety_content_filter_levels

Массив <string>

Для рекламы в контенте (реклама In-Stream Facebook и реклама в Facebook Reels) допускаются следующие значения:

  • EXPANDED: FACEBOOK_RELAXED;
  • MODERATE: FACEBOOK_STANDARD;
  • LIMITED: FACEBOOK_STRICT.

Для Audience Network допускаются следующие значения:

  • EXPANDED: AN_RELAXED;
  • MODERATE: AN_STANDARD;
  • LIMITED: AN_STRICT.

Для рекламы в лентах (Лента Facebook, Лента Instagram, Лента Facebook Reels и Лента Instagram Reels) допускаются следующие значения:

  • EXPANDED: FEED_RELAXED;
  • MODERATE: FEED_STANDARD;
  • LIMITED: FEED_STRICT.

Пример: "brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

Примечание. Если фильтр применяется на уровне рекламного аккаунта, на уровне кампании будут доступны только более жестко ограничивающие параметры. Например, если в аккаунте задано значение MODERATE, пользователь сможет выбрать для кампании только значения MODERATE или LIMITED. Менее ограниченные варианты (в этом примере — EXPANDED) будут недоступны.

excluded_publisher_categories

Массив <string>

Содержит: dating и gambling.

excluded_publisher_list_ids

Массив <числовые строки>

Каждая строка представляет собой ID списка исключений. Собственные списки можно создавать в Ads Manager или с помощью инструкций из статьи о списке блокировки издателей в справке по Marketing API.


Пример:
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

Например, вот так можно использовать brand_safety_content_filter_levels:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets

Для Audience Network и видеорекламы In-Stream также можно исключать издателей по категориям:

Имя Описание

excluded_publisher_categories

Массив <string>

Содержит:

  • debated_social_issues;
  • mature_audiences;
  • tragedy_and_conflict.

Пример:
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

Устройство, издатель и позиции

Имя: варианты Описание

device_platforms: mobile, desktop

Необязательный параметр.
Вариант по умолчанию: все.
Типы устройств пользователей, на которых отображается ваша реклама.

publisher_platforms: facebook, instagram, messenger, audience_network

Необязательный параметр.
Вариант по умолчанию: все.
Канал публикации вашей рекламы. Позиции в канале публикации можно задать в параметрах facebook_positions, instagram_positions, audience_network_positions и messenger_positions.

facebook_positions: feed, right_hand_column, marketplace, video_feeds, story, search, instream_video, facebook_reels, profile_feed

Необязательный параметр.
Вариант по умолчанию: все.


Примечания

  • Если параметр publisher_platforms указан, он должен содержать значение facebook (в противном случае его вообще не следует указывать, и тогда по умолчанию используются все доступные платформы).
  • Значение feed подразумевает Ленту на ПК и на мобильных устройствах.
  • Для кампаний с таргетингом на США (US), Великобританию (GB), Францию (FR), Испанию (ES), Германию (DE), Мексику (MX), Индию (IN) и Таиланд (TH) для целей VIDEO_VIEWS и POST_ENGAGEMENT можно использовать instream_video без feed. Для цели CONVERSIONS вариант instream_video не поддерживается.
  • Если выбран вариант story, необходимо использовать feed для Facebook или story для Instagram и device_platforms: mobile, так как истории на Facebook предназначены только для мобильных устройств.
  • Если выбран вариант marketplace, search или profile_feed, необходимо использовать feed.
  • Начиная с версии 3.0 вариант right_hand_column доступен только для формата одного изображения, одного видео и кольцевой галереи, если выбрана цель TRAFFIC, CONVERSIONS или PRODUCT_CATALOG_SALES.

instagram_positions: stream, story, explore, explore_home, reels, profile_feed, ig_search, profile_reels

Необязательный параметр.
Вариант по умолчанию: все.
Для вариантов stream, story и ig_search в Instagram в качестве объекта для таргетинга можно использовать кольцевые галереи Instagram. Если вы используете креатив с кольцевой галереей с автопоказом в историях, выбрать оба варианта для одной группы объявлений нельзя.
Объявления, в которых используется story, будут отображаться в ленте Instagram на ПК и в мобильном браузере.

audience_network_positions: classic, rewarded_video

Необязательный параметр.
Вариант по умолчанию: все.
По умолчанию мы не возвращаем effective_audience_network_positions, когда вы считываете спецификации таргетинга для группы объявлений. Такое поведение может отличаться от поведения, заданного параметром audience_network_positions. Если вы укажете позицию, которая не поддерживается для этой цели, она отобразится в списке настроенных позиций, но ее не будет в списке фактических позиций.

messenger_positions: messenger_home, sponsored_messages, story

Необязательный параметр.
Вариант по умолчанию: messenger_home, story.


Примечания

  • Если выбран вариант messenger_home, также необходимо выбрать publisher_platform и feed Facebook для facebook_positions.
  • Вариант messenger_home доступен для одиночных изображений и кольцевых галерей, если задана цель LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLS или PRODUCT_CATALOG_SALES, направленная на привлечение трафика на сайты, в приложения и в Messenger.
  • Если выбран вариант story, необходимо использовать feed Facebook или story Instagram и device_platforms: mobile, так как истории в Messenger предназначены только для мобильных устройств. Вариант story можно использовать для форматов одного изображения или видео в рекламных кампаниях с целями CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESS и APP_INSTALLS для привлечения трафика на сайты и в приложения.
  • Значение sponsored_messages нельзя использовать с другими местами размещения, в том числе messenger_home и местами размещения на Facebook.

Логика

  • Варианты для одного параметра объединяются с помощью логического оператора OR.
    Например, publisher_platforms=['facebook','instagram'] означает показ рекламы и на Facebook, и в Instagram.
  • Разные параметры объединяются с помощью логического оператора AND.
    Например, publisher_platforms=['facebook']&device_platforms=['mobile'] означает показ рекламы только на Facebook для мобильных устройств.
  • Если в таргетинг по результатам применения логики ничего не добавлено, например publisher_platforms=['instagram']& device_platforms=['desktop'], отобразится ошибка.

Ограничения

  • Использовать только Audience Network нельзя, поэтому выбрать только вариант publisher_platforms: audience_network невозможно.
  • Место размещения audience_network в сочетании с целью кампании VIDEO_VIEWS необходимо использовать с целью оптимизации THRUPLAYS.
  • Выбрать только story для facebook_positions нельзя. Если выбран вариант story для параметра facebook_positions, необходимо также выбрать feed для Facebook или story для Instagram.
  • Выбрать только story для messenger_positions нельзя. Если для параметра messenger_positions выбран вариант story, необходимо также выбрать feed для Facebook или story для Instagram.
  • В рекламе, которая показывается в ленте веб-версии Instagram, в качестве места размещения используется stream, и она проверяется на соответствие, чтобы она могла показываться как на ПК, так и на мобильных устройствах. Совместимые цели: BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWS и CONVERSIONS.

Примеры

Истории

Использование историй на Facebook в качестве места размещения:

curl \
  -F 'name=My Ad Set' 
  -F 'optimization_goal=CONVERSIONS' 
  -F 'billing_event=IMPRESSIONS' 
  -F 'bid_amount=2' 
  -F 'daily_budget=1000' 
  -F 'campaign_id=<AD_CAMPAIGN_ID>' 
  -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' 
  -F 'status=ACTIVE'
  -F 'access_token=<ACCESS_TOKEN>' 
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Видеореклама In-Stream

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

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Audience Network

Использование видео с вознаграждением Audience Network в качестве места размещения:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=40000' \
  -F 'campaign_id=<AD_CAMPAIGN_ID>' \
  -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \
  -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets

Возвращаемый результат:

{
  "targeting": {
    "audience_network_positions": [
      "classic",
      "rewarded_video"
    ],
    "effective_audience_network_positions": [
      "classic",
      "rewarded_video"
    ]
  },
  "id": "<AD_SET_ID>"
}

Видео Reels

Использование Facebook Reels в качестве места размещения:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Главный экран раздела "Интересное" в Instagram

Создание группы объявлений с местом размещения explore_home и таргетингом на поддерживаемую страну (например, US):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "explore",
         "explore_home"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

Результаты поиска Instagram

Создание группы объявлений с местом размещения ig_search и таргетингом на поддерживаемую страну (например, US):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "ig_search"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

Фактическое место размещения при таргетинге

Вы указываете определенные места размещения в спецификациях таргетинга для своих групп объявлений, но не всегда бывает известно, действительно ли ваша реклама была показана на платформах Facebook в заданных местах размещения. Это связано с тем, что выбранное место размещения может не соответствовать указанной цели рекламы. Благодаря API фактических мест размещения для таргетинга можно определить, в каких местах размещения будет демонстрироваться ваша реклама с учетом параметров таргетинга, и вы будете получать подтверждающие сообщения, помогающие понять, почему те или иные места размещения не попали в список. Если таргетинг настраиваете не вы, вы всё равно можете определить фактическое место размещения с помощью группы объявлений или настроек кампании.

Чтобы узнать фактическое место размещения с учетом ваших параметров таргетинга, поставьте перед именем поля места размещения слово effective_. Пример:

curl -G \
  -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/<AD_SET_ID>

Чтобы понять, почему те или иные места размещения были отфильтрованы, используйте поле recommendation:

curl -G \
  -d "fields=recommendations" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/23842573364570019

Фактические места размещения позволяют определить, где именно будет показана ваша реклама, исходя из следующих параметров группы объявлений: billing_event, optimization_goal, promoted_object, buying_type и objective. Параметры /ad_campaign_placement:

  • account_id и маркер доступа;
  • параметры billing_event например IMPRESSIONS;
  • закупочный тип, например AUCTION;
  • цели, например POST_ENGAGEMENT;
  • цель оптимизации, например POST_ENGAGEMENT (необязательный параметр);
  • продвигаемый объект, например PIXEL_ID.

Все параметры, кроме promoted_object и optimization_goal, обязательны. Если вы настроили таргетинг, фактическое место размещения можно определить с помощью Marketing API на основании разрешенных для ваших настроек мест размещения (см. раздел Фактические места размещения с таргетингом). Пример:

curl -G \
-d 'account_id=<ACCOUNT_ID>' \
-d 'billing_event=IMPRESSIONS' \
-d 'buying_type=AUCTION' \
-d 'objective=PAGE_LIKES' \
-d 'optimization_goal=IMPRESSIONS' \
https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>

Этот вызов возвращает следующее:

{
   "effective_device_platforms": [
      "mobile",
      "desktop"
   ],
   "effective_facebook_positions": [
      "feed",
      "right_hand_column"
   ],
   "effective_publisher_platforms": [
      "facebook"
   ],
   "recommendations": [
      {
         "title": "Placement Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.",
         "code": 1815609,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      },
      {
         "title": "Device Platform Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support connected_tv.",
         "code": 1815610,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      }
   ],     
   }
}

Чтобы выяснить причину, добавьте поле code из этого результата в вызов к /ad-recommendation. Например, при этом можно получить следующую информацию:

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

Подробнее см. в справке по рекомендациям для рекламы и в разделе Фактическое место размещения с таргетингом.