FBE: подключение Marketplace

С помощью расширения Facebook Business (FBE) ваши продавцы смогут легко демонстрировать рекламу во всем семействе приложений Facebook, подключив к этой платформе уже существующие объекты Facebook, такие как Страница или аккаунт Business Manager, либо создав новые. FBE позволяет продавцам Marketplace легко подключаться к решениям Meta.

Ниже описаны основные этапы процесса подключения для Marketplace. Рекомендуем руководствоваться этой последовательностью, а также основной документацией для разработчиков.

Процесс подключения FBE для Marketplace

Партнер: Marketplace

FBE: расширение Facebook Business (интерфейс, принадлежащий Facebook)

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

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

Частное разрешение
1. manage_business_extension (для получения этого разрешения ваш представитель в Meta должен добавить ваше приложение в список разрешенных).
Публичные разрешения (Marketplace должен запросить их в рамках проверки приложений).
1. business_management — необходимо для получения ID Business Manager, созданного через FBE, а также для управления объектами компании с помощью API Business Manager.
2. ads_management — необходимо для управления рекламой продавца от имени клиента.

Основные этапы для FBE и API партнерской рекламы

Продавец (компания) открывает всплывающее окно настройки FBE через веб-сайт Marketplace.
Продавец проходит процесс подключения FBE и выполняет настройку основных объектов (Business Manager, Страница и т. д.).
FBE возвращает ID объектов, настроенных продавцом (через API или Webhooks). После того как Marketplace получит соответствующие ID, можно создать и опубликовать сегмент каталога через API или пользовательский интерфейс (с помощью инструмента Collaboration Center в Business Manager).
Продавец запускает представление для управления FBE, где может отслеживать состояние созданного сегмента каталога и принять Пользовательское соглашение (если продавец впервые получает запрос сегмента каталога от Marketplace).
Marketplace запускает для продавца процесс создания рекламы (существующий процесс создания через Ads Manager и т. п.)

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

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.

Настройка

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

business_config

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

Поле	Описание
`business` FBEBusinessPropertiesConfigData	Обязательный параметр. Информация для компании конечного пользователя.
`messenger_chat` FBEMessengerChatConfigData	Необязательный параметр. Функции чата Messenger на Странице Facebook конечного пользователя, такие как `enabled` и `domains`.
`catalog_feed_scheduled` FBECatalogFeedConfigData	Необязательный параметр. Указывает, должно ли расширение Facebook Business использовать метод ленты, в рамках которого элементы каталога извлекаются с помощью `feed_url`.
`page_cta` FBEPageCtaConfigData	Необязательный параметр. Кнопка призыва к действию на странице конечного пользователя, например `cta_button_text`, `cta_button_url` и т. п.
`ig_cta` FBEIGCtaConfigData	Необязательный параметр. Параметры функции призыва к действию Instagram, такие как `enabled`, `cta_button_text`, `cta_button_url` и т. п.
`messenger_menu` FBEMessengerMenuConfigData	Необязательный параметр. Параметры функции постоянного меню в Messenger, такие как `cta_button-text` и `cta_button_url`.

После установки

Получите ID объектов, подтвердите уведомления Webhooks и события пикселей.
После получения ID объектов создайте и опубликуйте сегмент каталога через API или пользовательский интерфейс (с помощью инструмента Collaboration Center в Business Manager).
Создав сегмент каталога через API, ознакомьтесь с этими инструкциями по запуску всплывающего окна с представлением для управления FBE, где продавец может принять опубликованные сегменты каталога и завершить процесс подключения.

Когда настройка FBE завершена и ID объектов получены, откройте представление для управления FBE.