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

Узнайте, как показывать рекламу в определенных местах размещения, например только в Ленте на ПК или в Ленте на мобильных устройствах, а также в качестве видео с вознаграждением для 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/v19.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 и в рекламе Audience Network. Дополнительные сведения об этих категориях контента см. в статье о фильтре контента в Справочном центре для бизнеса. Вы можете выбрать одно значение для объявлений In-Stream на Facebook и одно значение для рекламы Audience Network. Возможные варианты: Full, Standard и Limited. Подробные сведения см. в описании поля brand_safety_content_filter_levels ниже.

Имя Описание

brand_safety_content_filter_levels

Массив <string>

Для объявлений In-Stream на Facebook допускаются следующие значения:


  • FULL: FACEBOOK_RELAXED;
  • STANDARD: FACEBOOK_STANDARD;
  • LIMITED: FACEBOOK_STRICT.

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


  • FULL: AN_RELAXED;
  • STANDARD: AN_STANDARD;
  • LIMITED: AN_STRICT.

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

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

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/v19.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/v19.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”},]

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