Расширенный таргетинг

К расширенному таргетингу относятся:

Эти типы таргетинга можно комбинировать при создании пользовательских и похожих аудиторий. По умолчанию комбинации соединяются с помощью операторов ORs. Подробнее о базовом и основном таргетинге см. в этой статье.

Если используется flexible_spec, в поле targeting также необходимо указать один из следующих параметров:

  • geo_locations (географический таргетинг по стране, региону, городу или почтовому индексу);
  • custom_audiences;
  • product_audience_specs;
  • dynamic_audience_ids.

Ограничения

  • Если рекламодатель находится в США или настроил таргетинг на эту страну, а реклама связана с недвижимостью, трудоустройством или кредитованием, то варианты таргетинга будут ограничены. См. статью об особой категории рекламы.
  • Если использовать radius при таргетинге по нескольким местоположениям, это может привести к ошибке с кодом 100 и подкодом 1815946. Рекомендуем создать объявление для каждого местоположения или не использовать параметр radius в вызове.
  • Подробнее об ограничениях см. в руководстве.

Мобильные устройства

Этот вид таргетинга удобен в случае рекламы для установки мобильного приложения.

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"]}, 
    "user_device": ["Galaxy S6","One m9"], 
    "user_os": ["android"] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Вы можете использовать сочетания категорий, например "iPod ИЛИ iPad ИЛИ iPhone".

Эти категории не являются взаимоисключающими. Если выбрать iOS, таргетинг будет проводиться на все устройства на базе iOS (в том числе iPhone и iPod) без указания параметра user_device.

В рекламе, направленной на повышение узнаваемости бренда, нельзя использовать таргетинг по типу мобильных устройств, например, выбрав кнопочные телефоны, устройства Samsung или устройства с определенной версией iOS. Можно выбрать либо Android, либо iOS, либо все мобильные телефоны.

Доступные поля

Поле Описание

user_os

Тип: массив

Обязательный параметр.

Одно или несколько значений из таблицы операционных систем (см. ниже). Допустимые значения можно получить с помощью Targeting Search API (параметры type=adTargetingCategory и class=user_os). В таргетинг нельзя добавить одновременно устройства на одной платформе с ОС не ниже определенной версии и устройства на другой платформе, однако можно добавить обе платформы без указания минимальной версии.


Допустимые варианты:
 — ['iOS', 'Android']
 — ['iOS']
 — ['Android_ver_4.2_and_above']
 — ['iOS_ver_8.0_to_9.0']
Недопустимые варианты:
 — ['Android', 'iOS_ver_8.0_and_above']
 — ['iOS', 'Android_ver_4.0_and_above']

user_device

Тип: массив

Необязательный параметр.

Устройства должны соответствовать значению, указанному в параметре user_os. Допустимые значения можно получить с помощью API Targeting Search (параметры type=adTargetingCategory и class=user_device).

excluded_user_device

Тип: массив

Необязательный параметр.

Устройства, которые нужно исключить. Устройства должны соответствовать значению, указанному в параметре user_os. Допустимые значения можно получить с помощью API Targeting Search (параметры type=adTargetingCategory и class=user_device).

wireless_carrier

Тип: массив

Необязательный параметр.

Допустимое значение — Wifi. Вы можете добавить в таргетинг пользователей, которые в данный момент подключены к сетям Wi-Fi.

Поддерживаемые операционные системы

Поле Описание

iOS

Тип: строка

Устройства iOS, в том числе iPhone, iPad и iPod.

iOS_ver_x.x_and_above

Тип: строка

Устройства iOS с версией ОС не ниже x.x.


Возможные варианты: 2.0, 3.0, 4.0, 4.3, 5.0, 6.0, 7.0, 8.0, 9.0. Пример:iOS_ver_4.0_and_above.


Для рекламы приложений Meta:

  • группы объявлений SKAdNetwork и "Измерение на основе агрегированных данных о событиях" (Meta) поддерживают только диапазон версий от iOS_ver_14.5_and_above;
  • группы объявлений, отличные от SKAdNetwork и "Измерение на основе агрегированных данных о событиях" (Meta), поддерживают только диапазон версий iOS от iOS_ver_2.0_to_14.4;

iOS_ver_x.x_to y.y

Тип: строка

Устройства iOS с версией ОС от x.x до y.y.


Возможные варианты: 2.0, 3.0, 4.0, 4.3, 5.0, 6.0, 7.0, 8.0, 9.0.

Пример:iOS_ver_8.0_to_9.0, где значение x.x должно быть меньше y.y.

Android

Тип: строка

Устройства Android

Android_ver_x.x_and_above

Тип: строка

Устройства Android с версией ОС не ниже x.x.


Возможные варианты: 2.0, 2.1, 2.2, 2.3, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 4.3, 4.4, 5.0, 5.1, 6.0, 7.0, 7.1 и 8.0.

Пример:Android_ver_4.0_and_above.

Android_ver_x.x_to y.y

Тип: строка

Устройства Android с версией ОС от x.x до y.y.


Возможные варианты: 2.0, 2.1, 2.2, 2.3, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2., 4.3, 4.4, 5.0, 5.1, 6.0, 7.0, 7.1 и 8.0.

Пример:Android_ver_4.2_to_8.0, где значение x.x должно быть меньше y.y.

Расширенный таргетинг по демографическим данным

Этот вид таргетинга основан на сведениях о родственных отношениях, образовании, финансовом положении и событиях из жизни.

Примеры

Сначала выполните запрос для получения параметров life_events:

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=life_events' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/search

Добавьте эти параметры в targeting_spec:

curl -X POST \
  -F 'name="My First AdSet"' \
  -F 'daily_budget=10000' \
  -F 'bid_amount=300' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'optimization_goal="REACH"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'targeting={
       "facebook_positions": [
         "feed"
       ],
       "age_max": 24,
       "age_min": 20,
       "behaviors": [
         {
           "id": 6002714895372,
           "name": "All travelers"
         }
       ],
       "device_platforms": [
         "mobile"
       ],
       "genders": [
         1
       ],
       "geo_locations": {
         "countries": [
           "US"
         ],
         "regions": [
           {
             "key": "4081"
           }
         ],
         "cities": [
           {
             "key": 777934,
             "radius": 10,
             "distance_unit": "mile"
           }
         ]
       },
       "interests": [
         {
           "id": "<INTEREST_ID>",
           "name": "<INTEREST_NAME>"
         }
       ],
       "life_events": [
         {
           "id": 6002714398172,
           "name": "Newlywed (1 year)"
         }
       ],
       "publisher_platforms": [
         "facebook",
         "audience_network"
       ]
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Теперь таргетинг проводится по таким параметрам:

  • Местоположение: Япония или США — Менло-Парк (+10 миль), Калифорния, или США — Техас
  • Возраст: 20–24
  • Пол: мужской
  • Интересы: футбол
  • Поведение: все часто путешествующие
  • События из жизни: молодожены (до 1 года)
  • Владение домом или квартирой: съемщики

Вот ещё один пример таргетинга по местоположению, демографическим данным, семейному положению и интересам:

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={ 
    "age_max": 43, 
    "age_min": 18, 
    "genders": [1], 
    "geo_locations": { 
      "regions": [{"key":"3847"}], 
      "cities": [ 
        { 
          "key": "2430536", 
          "radius": 12, 
          "distance_unit": "mile" 
        } 
      ] 
    }, 
    "interests": [{"id":6003139266461,"name":"Movies"}], 
    "relationship_statuses": [ 
      2, 
      3, 
      4 
    ] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Возможные варианты

Имя Описание

relationship_statuses

Тип: массив

Массив целых чисел, обозначающих семейное положение.

1: без пары

2: в отношениях

3: в браке

4: обручен(а)

6: не указано


По умолчанию:ALL, если указано значение Null или значение отсутствует.

Ограничения: не используйте значение 0.

life_events

Тип: массив

Массив объектов с полем id и необязательным полем name: [{'id': 123, 'name': 'foo'}, {'id': 456}, 789].

industries

Тип: массив

Массив объектов с полем id и необязательным полем name.

income

Тип: массив

Массив объектов с полем id и необязательным полем name.

family_statuses

Тип: массив

Массив объектов с полем id и необязательным полем name.

Образование и работа

Для получения всех доступных вариантов используйте API Targeting Search.

Имя Описание

education_schools

Тип: массив

Школы, вузы и учебные заведения.


Ограничение: до 200 учебных заведений.

Пример:[{id: 105930651606, 'name': 'Harvard University'}, {id: 105930651607}, 105930651608].

education_statuses

Тип: массив

Массив целых чисел для таргетинга по образованию.

1: HIGH_SCHOOL

2: UNDERGRAD

3: ALUM

4: HIGH_SCHOOL_GRAD

5: SOME_COLLEGE

6: ASSOCIATE_DEGREE

7: IN_GRAD_SCHOOL

8: SOME_GRAD_SCHOOL

9: MASTER_DEGREE

10: PROFESSIONAL_DEGREE

11: DOCTORATE_DEGREE

12: UNSPECIFIED

13: SOME_HIGH_SCHOOL

college_years

Тип: массив

Массив целых чисел. Год выпуска из вуза.


Ограничение: нельзя указывать год до 1980.

education_majors

Тип: массив

Основные предметы специализации.


Пример:[{'id': 123, 'name': 'Computer Science'}, {'id': 456}, 789].

Ограничение: 200.

work_employers

Тип: массив

Компания, организация или место работы.


Пример:[{'id':'50431654','name':'Microsoft'}, {'id':50431655}, 50431656].

Ограничение: 200.

work_positions

Тип: массив

Должность (заданная самостоятельно).


Пример:[{'id':105763692790962, 'name':'Contractor'}, {'id':105763692790963}, 105763692790964].

Ограничение: 200.

Пользовательские аудитории

Вы можете создать пользовательскую аудиторию и добавить в нее пользователей. Аудитории используются в таргетинге как для добавления, так и для исключения пользователей. Можно указать до 500 пользовательских аудиторий в параметре custom_audiences и до 500 — в параметре excluded_custom_audiences.

Параметр excluded_custom_audiences в спецификациях targeting_specs отличается от параметра excluded_custom_audiences в пользовательской аудитории APP_COMBINATION.

Поле Описание

custom_audiences

Тип: массив

Массив ID аудиторий или объектов аудиторий. Задается только поле 'id' ([123, 456]) либо пары [{'id': 123}, {'id': 456}].

excluded_custom_audiences

Тип: массив

Массив ID аудиторий или объектов аудиторий. Задается только поле 'id' ([123, 456]) либо пары [{'id': 123}, {'id': 456}].

targeting:{
     "geo_locations":{
       "countries":["US"],
     },
     "age_min":25,
     "age_max":40,
     "custom_audiences":[{"id":6004192254512}]}
     "excluded_custom_audiences":
       [{"id":6004192252847}],
 }

Локали

Вы можете уточнить таргетинг, указав локаль.

Поле Описание

locales

Тип: массив

Локали (см. раздел Поиск для таргетинга: локали). Индексы во вложенном массиве locales. Можно таргетировать рекламу на аккаунты, язык которых отличается от стандартного языка в этом местоположении. Укажите ID языка (например, 5 для немецкого). Ограничение: 50. Чтобы понять, как виртуальные локали связаны с наборами языков, воспользуйтесь поиском для таргетинга (локали) с параметром type=adlocale.

Пользовательский таргетинг по широким категориям

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

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"]}, 
    "user_adclusters": [ 
      {"id":6002714885172,"name":"Cooking"}, 
      {"id":6002714898572,"name":"Small Business Owners"} 
    ] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

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

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={ 
    "exclusions": { 
      "user_adclusters": [ 
        {"id":6002714885172,"name":"Cooking"}, 
        {"id":6002714898572,"name":"Small Business Owners"} 
      ] 
    }, 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

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

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"]}, 
    "relationship_statuses": [2], 
    "user_adclusters": [{"id":6002714886772,"name":"Food & Dining"}] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Доступны следующие параметры:

Имя Описание

user_adclusters

Тип: массив

Массив пар "ID — имя" для кластеров широких категорий. Инструкции по получению широких категорий см. ниже. Ограничение: 50 пар "ID — имя".

Чтобы отправить этот запрос таргетинга для рекламного аккаунта, выполните запрос HTTP GET:

https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/broadtargetingcategories

Ответ представляет собой массив пар "ключ — значение" в формате JSON:

Имя Описание

id

Тип: длинное целое

ID широкой категории для использования в спецификациях таргетинга объявлений.

name

Тип: строка

Имя широкой категории.

parent_category

Тип: строка

Родительская категория широкой категории.

size_lower_bound

Тип: целое число

Нижняя граница размера аудитории широкой категории.

size_upper_bound

Тип: целое число

Верхняя граница размера аудитории широкой категории.

type

Тип: целое число

6=BCT (широкая категория).

type_name

Тип: строка

BCT (широкая категория).