Реклама мест назначения: каталог и лента

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

Загрузка файлов .csv или .xml для лент мест назначения

Создать каталог мест назначения и управлять им можно в Commerce Manager.

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

1. Создайте каталог мест назначения.
2. Загрузите ленту на Facebook.
3. Создайте на основе каталога группы товаров.
4. Свяжите каталог с источниками событий

Лента мест назначения: загрузка мест назначения на Facebook

Лента мест назначения — это файл со всеми местами назначения, которые вы хотите продвигать. Каждая строка или элемент в этом файле представляет собой одно место назначения. Вы можете использовать одну или несколько лент мест назначения при условии, что все ленты вместе содержат все места назначения, которые вы хотите продвигать.

Поддерживаемые форматы лент мест назначения

CSV: пример и описание

Пример файла .csv | Пример файла .tsv (упрощенный) | Пример файла .tsv (стиль JSON)

• Первая строка должна содержать список выбранных имен полей в том порядке, в котором будут указаны значения. В последующих строках будут представлены соответствующие значения для каждого места назначения.
• Поля, содержащие пробелы или запятые, должны заключаться в двойные кавычки ("").
• Вложенные поля или поля со множественными значениями, например address, neighborhood или image, могут представляться с использованием значений в кодировке JSON либо в виде группы "упрощенных" столбцов с простым текстом, обозначенных с помощью синтаксиса пути JSON (например, address.city, neighborhood[0], image[0].url, image[0].tag[0], image[0].tag[1]). Оба способа записи можно использовать в одном и том же файле.

XML: пример и описание

Пример файла XML

• Корневой узел XML <listings> заключает в себе группу узлов <listing>, каждый из которых представляет место назначения.
• Файл должен начинаться с допустимого тега объявления <?xml.

Поддерживаемые поля для мест назначения

Для позиций, добавляемых в каталог товаров, поддерживаются перечисленные ниже поля.

Поля, поддерживаемые для локализованных каталогов, см. в этом разделе.

Глубокие ссылки на товары

Укажите глубокие ссылки в ленте согласно спецификации App Links. Информация о глубоких ссылках в ленте имеет приоритет над всеми данными, которые Facebook собирает веб-краулером с помощью метаданных App Links.

Если у вас уже есть информация о глубоких ссылках из App Links, указывать ее не нужно. Facebook использует информацию из App Links для правильного отображения глубоких ссылок. Подробные сведения об отображении глубоких ссылок в рекламе см. в этой статье.

Параметры объектов image

Параметры объектов address

Следующие разделы относятся только к управлению каталогами через этот API.

Создание каталога мест назначения с помощью API

Каталог мест назначения — это контейнер для всех мест назначения, которые вы хотите продвигать. Чтобы использовать API, убедитесь, что у вас есть нужный уровень доступа к API Marketing и вы приняли Пользовательское соглашение при создании первого каталога в Business Manager.

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

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

Загрузка лент мест назначения через API

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

Фильтрация каталога мест назначения для создания групп туристических направлений

Группа туристических направлений — это подмножество элементов в вашем каталоге. Для использования рекламы мест назначения необходима хотя бы одна такая группа. Поэтому ее нужно создать.

Для создания группы туристических направлений используются фильтры в каталоге мест назначения. Например, можно создать группу со всеми местами назначения, на которые предлагается большая скидка. Обратите внимание: создать группу туристических направлений можно и без фильтров. В этом случае группа туристических направлений будет содержать все места назначения из каталога.

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$destination_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

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