Локализованный каталог для объявлений из каталога Advantage+

Обзор

С помощью этого руководства вы можете настроить свой локализованный каталог для объявлений из каталога Advantage+.

Ваш каталог представляет собой объект (или контейнер) с информацией о ваших товарах. В него можно загрузить ваш ассортимент.

Как это работает

Meta предлагает функции для работы с локализованным каталогом, благодаря чему вы можете настроить свой каталог для показа товаров в рекламных объявлениях или их покупки в разных странах. Как правило, локализуются валюта, цена, наименование и описание товаров. Вы также можете указать локализованные URL, чтобы покупатель мог перейти на сайт, где ваши товары представлены для определенной страны или на определенном языке. Подробнее о том, как настроить свой локализованный каталог, см. в этой статье.

Создание шаблона для объявлений из каталога Advantage+

При создании шаблона для объявлений из каталога Advantage+ можно настроить варианты креатива на разных языках. Например, тем, кто говорит на другом языке, можно показывать другой заголовок рекламы.

Помимо других полей в шаблоне креатива (в object_story_spec), в поле customization_rules_spec можно задать массив настроек, каждая из которых имеет следующий формат:

Имя поляОписаниеПринимает параметры шаблона?

customization_spec

Тип: объект

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

Определяет язык настройки. Подробнее о том, как создать объявления из каталога Advantage+ для нескольких языков и стран, см. в Справочном центре по рекламе.

Пример: {'language' => 'en_XX'}

Нет

message

Тип: строка

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

Рекламное сообщение, отображаемое в Instagram.

Пример: Test {{product.name | titleize}}

Да

link

Тип: строка

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

Ссылка на ваш сайт, которая используется в качестве подписи к объявлению. Это значение всегда заменяется значением link из ленты продуктов, а заданная ссылка используется только для последней карточки кольцевой галереи. Нельзя использовать URL на сайте Facebook.com.

Пример: //link.com


Для рекламы с подборкой в параметре link можно указать документ Instant Experiences, как описано в статье Реклама с подборкой.

Пример: https://fb.com/canvas_doc/CANVAS_ID

Нет

name

Тип: строка

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

Название или заголовок объявления, отображаемые в Instagram.

Пример: Headline {{product.price}}

Да

description

Тип: строка

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

Описание объявления. Не отображается в Instagram.

Пример: Description {{product. description}}

Да

template_url_spec

Тип: объект

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

Позволяет указать глубокую ссылку на сайт, как описано в разделе Отслеживание кликов и шаблоны. Примечание. Мы поддерживаем только глубокие ссылки на сайты.

Пример: {'web' => {'url' => DEEP_LINK}}
Пример: {'web' => {'url' => 'example://link/?id={{product. retailer_id}}'}}

Да

video_id

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

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

Только для рекламы с подборкой: в параметре video_id можно указать видео, которое будет главным файлом подборки. Процедура описана в статье Реклама с подборкой.

Пример: 1234

Нет

picture

Тип: строка

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

Только для рекламы с подборкой: в параметре picture можно указать изображение, которое будет главным файлом подборки. Процедура описана в статье Реклама с подборкой.

Пример: https://url/image.jpg

Нет

Поле customization_spec без других полей можно задать только в одной настройке в массиве. В нем задается язык по умолчанию для текста в template_data.

Язык визуализации рекламы выбирается на основании языка интерфейса пользователя и других свойств. Кроме того, используются свойства продукта на языке отображения из ленты каталога (если они доступны).

См. также статьи Создание шаблона креатива, Поддерживаемые поля для объявлений из каталога Advantage+ и Поддерживаемые форматы ленты для объявлений из каталога Advantage+.

Шаблон для рекламы с подборкой

Как и для многоязычных объявлений из каталога Advantage+, при создании рекламы с подборкой можно настроить варианты креатива с помощью поля customization_rules_spec.

Ограничения

  • Параметр link для рекламы с подборкой создается с помощью шаблона "Быстрая электронная витрина" (прежнее название — "Продажа товаров, сетка (1932289657009030)").
  • Шаблон для рекламы с подборкой демонстрируется только через место размещения в Ленте Facebook для мобильных устройств.

Примеры

Предварительный просмотр объявлений из каталога Advantage+ для нескольких языков или стран на другом языке или для другой страны

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'dynamic_customization={
       "language": "fr_XX",
       "country": "FR"
     }' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews

Создание шаблона для объявлений из каталога Advantage+ с кольцевой галереей на нескольких языках

curl -X POST \
  -F 'name="Dynamic Ad Template Creative Sample"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "message": "English Test {{product.name | titleize}}",
         "link": "http://www.example.com/englishurl",
         "name": "English Headline {{product.price}}",
         "description": "English Description {{product.description}}",
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "message": "French Test {{product.name | titleize}}",
             "link": "http://www.example.com/frenchurl",
             "name": "French Headline {{product.price}}",
             "description": "French Description {{product.description}}",
             "template_url_spec": {
               "web": {
                 "url": "http://www.example.com/frenchdeeplink"
               }
             }
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'template_url_spec={
       "web": {
         "url": "http://www.example.com/englishdeeplink"
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Создание рекламы с подборкой с медиафайлом главного изображения на нескольких языках

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "picture": "<IMAGE_URL>",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Создание рекламы с подборкой с медиафайлом главного видео на нескольких языках

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "video_id": "<VIDEO_ID>",
         "image_url": "<IMAGE_URL>",
         "title": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE",
           "value": {
             "link": "<CANVAS_LINK>"
           }
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "video_id": "<VIDEO_ID_FR>",
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Создание рекламы с подборкой с медиафайлом главного динамического видео на нескольких языках

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "format_option": "collection_video",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives