Marketing API

Правила кастомизации креативов

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

Мы предлагаем три API, которые используют правила кастомизации креативов:

Для всех объявлений, в которых используется параметр asset_feed_spec, нужно указать не менее двух правил кастомизации. Если креатив содержит поле asset_feed_specи менее двух правил, вы не сможете создать объявление.

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

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

Для использования правил кастомизации объектов можно создать стандартную кампанию со следующими ограничениями:

API Поддерживаемые цели кампании

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

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Кастомизация креативов для мест размещения

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LEAD_GENERATION, LINK_CLICKS, REACH, VIDEO_VIEWS.

Многоязычные объявления

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Для группы объявлений используйте стандартную конечную точку группы объявлений и задайте для параметра is_dynamic_creative значение false.

Вот как можно создать группу объявлений в кампании со значением conversions для параметра optimization_goal:

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Если вы используете поле asset_feed_spec для группы объявлений, оптимизированной для цели APP_INSTALLS, нужно указать link_url, например http://www.abc.com. Значение link_urlдолжно совпадать со значениемobject_store_url в promoted_object. В поле asset_feed_spec нужно указать только один параметр link_url.

Поле asset_feed_spec предоставляет креатив для динамических креативов, кастомизации креативов для мест размещения, многоязычных объявлений и сегментированной кастомизации креативов. Формат параметров уникален для каждого решения.

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

Предоставьте креатив с помощью ленты объектов (параметра asset_feed_spec). Лента объектов — это подборка разных элементов, из которых состоят креативы: изображений, заголовков, текстов и т. д. Для каждого типа объекта можно указать несколько рекламных креативов.

Создайте ленту asset_feed_spec, используя /adcreative. Чтобы применить настройки кастомизации, задайте asset_customization_rules для asset_feed_spec.

После настройки подтвердите asset_feed_spec:

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

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

curl 
  -F 'name=Asset Custom Rule Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

После создания: