Реклама авиарейсов: каталог и лента

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

1. Загрузка CSV- или XML-файлов с лентами авиарейсов.
2. Автоматическое заполнение каталога на основе событий.
3. Объединение ленты авиарейсов с автоматически генерируемыми данными об авиарейсах.

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

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

Лента авиарейсов: загрузка авиарейсов на Facebook

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

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

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

Пример файла CSV | Пример файла TSV (упрощенный)

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

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

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

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

Поддерживаемые поля: реклама авиарейсов

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

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

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

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

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

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

Автоматическая генерация данных об авиарейсах: автоматическое добавление маршрутов в каталог с использованием информации о событиях

Facebook может автоматически добавлять маршруты в каталог на основе обновления информации о событиях пикселя и в приложении. Каждый раз при получении события с маршрутом, которого ещё нет в каталоге, этот маршрут можно добавить в него автоматически. Это позволяет работать с рекламой авиарейсов без использования соответствующих лент.

Чтобы включить эту функцию, отправьте к своему каталогу авиарейсов запрос POST и задайте для параметра generate_items_from_events значение true.

curl \
  -F 'flight_catalog_settings={generate_items_from_events:1}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

У маршрутов, которые добавляются автоматически, нет изображения (которое демонстрировалось бы в объявлении). Таким образом, необходимо предоставить стандартное изображение, которое будет использоваться для всех автоматически добавляемых авиарейсов.

curl \
  -F 'fallback_image_url=http://example.com/some.image_1.jpg' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

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

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights

Объединенный вариант: использование лент авиарейсов в сочетании с автоматически генерируемыми данными об авиарейсах

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

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

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

Создание каталога авиарейсов через API

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

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

curl -X POST \
  -F 'name="Test Flight Catalog"' \
  -F 'vertical="flights"' \
  -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;

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

$flight_set->setData(array(
  ProductSetFields::NAME => 'Test Flight Set',
  ProductSetFields::FILTER => array(
    'origin_airport' => array(
      'eq' => 'LHR',
    ),
  ),
));

$flight_set->create();

from facebookads.adobjects.productset import ProductSet

flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
    'origin_airport': {
        'eq': 'SFO',
    },
}

flight_set.remote_create()

curl \
  -F 'name=Test Flight Set' \
  -F 'filter={"origin_airport":{"eq":"LHR"}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets

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