Расширение Facebook Business: подключение пользовательских аудиторий

Пользовательские аудитории в расширении Facebook Business (FBE) позволяют компаниям оптимизировать таргетинг своей рекламы, создав аудиторию из клиентов, посетителей веб-сайтов, пользователей мобильных приложений или похожих на них пользователей. В рамках процесса подключения пользовательских аудиторий к расширению Facebook Business компании могут настраивать и интегрировать следующие компоненты и функции:

Business Manager;
Страница Facebook;
рекламный аккаунт.

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

Пример: процесс подключения с платформы партнера (вход от имени компании)

Прежде чем начать

Ваше приложение должно принадлежать аккаунту Business Manager, который связан с подтвержденной компанией. Узнайте, как подтвердить свою компанию.
Требуется приложение Facebook со следующими уровнями доступа, функциями и разрешениями:
- расширенный доступ;
- функция стандартного доступа к управлению рекламой;
- общедоступное разрешениеads_management;
- частное разрешение manage_business_extension; для получения этого разрешения ваш представитель в Facebook должен добавить ваше приложение в список разрешенных.
Настройте аутентификацию через вход от имени компаний (на платформе партнера) или Бизнес-приложения (на Facebook) с соответствующей конфигурацией и запустите процесс подключения к расширению Facebook Business.

Необходимые настройки

extras

Поле Тип Описание

Поле	Тип	Описание
`setup`	setup	Обязательный параметр. Настройки Facebook для продавца, например его уникальный идентификатор (`external_business_id`) или валюта каталога (`currency`). См. подробные сведения об объекте setup.
`business_config`	business_config	Обязательный параметр. Объект конфигурации, который используется расширением Facebook Business для настройки соответствующего рабочего процесса. См. подробные сведения об объекте `business_config`.
`repeat`	Логическое значение	Обязательный параметр. Установите значение `false`.

setup

setup

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

Настройки Facebook для продавца, например его уникальный идентификатор (external_business_id) или валюта каталога (currency). См. подробные сведения об объекте setup.

business_config

business_config

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

Объект конфигурации, который используется расширением Facebook Business для настройки соответствующего рабочего процесса. См. подробные сведения об объекте business_config.

repeat

Логическое значение

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

Установите значение false.

Настройка

Этот объект используется для настройки параметров присутствия конечного пользователя на Facebook.

Поле	Описание
`external_business_id` Тип: строка	Обязательный параметр. Уникальный ID, представляющий компанию вашего клиента. Мы используем это значение в качестве уникального идентификатора. Например, если компания называется Fubar, значение `external_business_id` для нее может равняться fubar-123.
`timezone` Тип: строка	Обязательный параметр. Часовой пояс, в котором расположена компания. См. возможные значения часовых поясов.
`currency` Тип: строка	Обязательный параметр. Трехбуквенный ISO-код валюты по умолчанию для каталога продуктов компании. См. поддерживаемые коды валют.
`business_vertical` Тип: перечисление	Обязательный параметр. Отрасль, с которой связана компания. Значения: `CUSTOM_AUDIENCE`
`channel` Тип: перечисление	Обязательный параметр. Позволяет партнеру настроить процесс расширения Facebook Business. Для пользовательской аудитории используйте значение `CUSTOM_AUDIENCE`. `CUSTOM_AUDIENCE` — процесс, позволяющий конечным пользователям создавать или выбирать аккаунты Business Manager, рекламные аккаунты и Страницы Facebook. Настроив эти объекты, конечный пользователь может создать пользовательскую аудиторию на Facebook через стороннюю платформу.
`business_manager_id` Тип: строка	Необязательный параметр. ID существующего аккаунта Business Manager пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`ad_account_id` Тип: строка	Необязательный параметр. ID существующего рекламного аккаунта пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`page_id` Тип: строка	Необязательный параметр. ID существующей Страницы Facebook пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.

business_config

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

Поле	Описание
`business` Тип: FBEBusinessPropertiesConfigData	Обязательный параметр. Информация для компании конечного пользователя.

Дальнейшие действия

Настройте уведомления Webhooks о компаниях, которые устанавливают и удаляют расширение Facebook Business.
Инициируйте события пикселя для каждой компании, которая использует FBE на вашей платформе.
Добавьте точку входа в представление для управления функциями со своей платформы.
Разрешите компаниям удалять расширение Facebook Business.
Отправьте приложение на проверку интеграции расширения Facebook Business. После утверждения интеграции оно станет доступно обычным пользователям.