Сегментированная кастомизация креативов

Это решение позволяет настроить рекламные креативы согласно типам таргетинга по геолокации. Сведения о том, как настроить креативы в зависимости от места размещения, см. в статье Кастомизация креативов по месту размещения.

Сегментированная кастомизация креативов — один из трех API, использующих правила кастомизации креативов. См. Правила кастомизации креативов.

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

Начало работы

Прежде чем начинать, ознакомьтесь с ограничениями для этого продукта. Если в вашем случае выполняются все наши условия, переходите к следующим этапам:

Шаг 2. Добавление рекламного креатива

Варианты кастомизации

Объявление можно настроить по геолокации. Для этого нужно создать правило с параметрами кастомизации. Поддерживаемые типы кастомизации:

Формат для каждого из этих типов аналогичен формату для базового таргетинга (см. статью Таргетинг).

Создание правил кастомизации креативов

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

При создании правил для каждого из них можно задать приоритет. В противном случае мы назначаем приоритет в соответствии с положением правила в приведенном списке. Например, первое правило в списке получает приоритет 1.

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

  • Создайте пустой объект customization_spec. В конце правила добавьте открывающую и закрывающую фигурные скобки {}.
  • Задайте для правила минимальный приоритет. Он должен равняться общему количеству правил, включая правило по умолчанию. Например, если у вас есть 10 правил и еще одно правило по умолчанию, приоритет правила по умолчанию будет быть 11.

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

Остальные правила должны охватывать большую часть вашей целевой аудитории.

Настройка параметров ленты креативов

Создайте объект asset_feed_spec и добавьте правила кастомизации в поле asset_customization_rules. Можно добавить до 50 правил.

Для каждого правила потребуется указать свойства customization_spec и priority, а также ярлыки объектов. Параметр customization_specне должен содержать более 50 условий для одного правила.

Пример настройки ленты объектов:

curl \
-F 'object_story_spec={
       "page_id": "<YOUR_PAGE_ID>",
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>"
    }' \
-F 'asset_feed_spec={
 "images": [
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image1"}]}, 
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image2"}]}
 ], 
 "bodies": [
   {"text":"Motor City Mission Corps", "adlabels":[{"name":"body1"}]}
 ], 
 "titles": [
   {"text":"Link title 1 goes here", "adlabels":[{"name":"title1"}]}, 
   {"text":"Link title 2 goes here", "adlabels":[{"name":"title2"}]},
   {"text":"Link title 3 goes here", "adlabels":[{"name":"title3"}]}
 ], 
 "call_to_action_types":[
   "LEARN_MORE"
 ],
 "descriptions": [
   {"text":"Begin Your Adventure"}
 ], 
 "ad_formats": [
   "SINGLE_IMAGE"
 ], 
 "link_urls": [
   {"website_url":"https://www.example.com/"}
 ],
 "asset_customization_rules": [
   { 
     "customization_spec": {
        "geo_locations": {
          "countries": ["US"]
        }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title1"},
     "priority": 1
   },
   {
     "customization_spec": {
       "geo_locations": {
          "countries": ["GB"]
        }
     }, 
     "image_label": {"name": "image1"},
     "title_label": {"name": "title2"},
     "priority": 2
   },
   {
     "customization_spec": {
       "geo_locations": {
         "cities": [
           {"key": "2481714"},
           {"key": "2481868"}
         ]
       }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title3"},
     "priority": 4
   },
   {
     "customization_spec": {}, 
     "image_label": {"name":"image2"},
     "title_label": {"name":"title1"},
     "priority": 5
  }]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

См. все доступные варианты параметров ленты объектов. Следующие шаги см. в статье о правилах кастомизации креативов.

Шаг 3 (Необязательно). Предпросмотр рекламы

Проверьте в режиме предпросмотра разные варианты своего объявления в зависимости от правил таргетинга с помощью конечной точки /generatepreview. Также можно добавить поле dynamic_asset_label с указанием номера приоритета правила, чтобы посмотреть вариант для определенного языка.

Например, вот так можно выполнить предпросмотр правила с приоритетом 1:

curl -G --data-urlencode 
'creative={ 
  "object_story_spec": { 
    "page_id": "<PAGE_ID>" 
  },
  "asset_feed_spec": {
    ...
    "asset_customization_rules": [
      { 
        "customization_spec": { 
          "geo_locations": { 
          "countries": ["US"] 
          } 
        },
        "image_label": {
          "name": "image1"
        },
        "title_label": {
          "name": "title1"
        },
        "priority": 1
    },
    ...
    ]
  }
}' 
-d 'ad_format=DESKTOP_FEED_STANDARD' 
-d 'dynamic_asset_label=1'
-d 'access_token=<ACCESS_TOKEN>' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Ограничения

Особая категория рекламы — К находящимся в США или таргетирующим рекламу на США рекламодателям, использующим рекламу жилья, работы и кредитов, применяются другие наборы ограничений. Эти рекламодатели должны придерживаться ограничений для Особой категории рекламы asset_feed_spec. См. подробнее об Особой категории рекламы.

Кампания, проверка целиAPP_ENGAGEMENT не поддерживается.

Поддерживаемые места размещения: поддерживаются все места размещения.

Закупочный тип: охват и частота или AUCTION.

Кастомизация по месту размещения: если в каком-либо правиле содержится кастомизация по месту размещения, ее нужно указать во всех правилах.

Применяются те же ограничения для asset_feed_spec, что и для объявлений с использованием ленты объектов без правил кастомизации. Исключения.

  • К каждому изображению или видео должен быть прикреплен ярлык.
  • Для каждого правила asset_customization_rule можно использовать только одно изображение или видео.
  • Форматы рекламы: поддерживаются два формата ad_formatsSINGLE_IMAGE и SINGLE_VIDEO. В одной ленте объектов разрешается использовать только один формат ad_format.
  • В call_to_actions_types можно указать только один элемент.
  • Для каждого варианта таргетинга по месту размещения для группы объявлений нужно указать по крайней мере одно правило asset_customization_rule.