Подключение пикселя и API Conversions для расширения MBE

Процесс подключения пикселя и API Conversions для расширения Meta Business (MBE) позволяет пользователям создавать или выбирать свои Business Manager, Страницу и пиксель Meta. Этот процесс рекомендуется партнерам, которые занимаются хостингом сайтов. Через пиксель, возвращенный по завершении этого процесса, партнеры могут отправлять события в Facebook от имени своих клиентов через браузер или API Conversions. Для этого процесса не предусмотрены функции работы с каталогом.

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

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

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

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` перечисление	Обязательный параметр. Отрасль, с которой связана компания. Значение: `ECOMMERCE`.
`merchant_settings_id` строка	Необязательный параметр. Используется при переходе с расширения Facebook Business версии 1. Если вы переходите с версии 1 на версию 2, обратитесь к своему представителю в Facebook.
`domain` строка	Обязательный параметр для каналов COMMERCE и COMMERCE_OFFSITE Домен, используемый для утверждения вручную в Instagram. Пример: `https://exampleshop.partnersite.com`.
`channel` перечисление	Обязательный параметр. Позволяет партнеру настроить процесс API Conversions расширения MBE. Для процесса API Conversions это значение должно иметь вид `CONVERSIONS_API`. `CONVERSIONS_API` — процесс, позволяющий конечным пользователям создавать или выбирать объекты Business Manager, рекламного аккаунта и пикселя Meta. Эти объекты создаются, чтобы конечный пользователь мог отправлять события со своего сайта в Facebook через API Conversions или пиксель браузера.
`business_manager_id` Строка	Необязательный параметр. ID существующего аккаунта Business Manager пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`ad_account_id` строка	Необязательный параметр. ID существующего рекламного аккаунта пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`page_id` строка	Необязательный параметр. ID существующей Страницы Facebook пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`ig_profile_id` строка	Необязательный параметр. ID существующего профиля компании Instagram пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`pixel_id` строка	Необязательный параметр. ID существующего пикселя пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`catalog_id` строка	Необязательный параметр. ID существующего каталога пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.

Конфигурация компании

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

Поле	Описание
`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`.