Подключение ленты в расширении Meta Business

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

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

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

  1. Ваше приложение должно принадлежать аккаунту Business Manager, связанному с подтвержденной компанией. Узнайте, как подтвердить свою компанию.
  2. Необходимо приложение Meta, прошедшее проверку (в особенности это касается приложений, связанных с управлением лентой), со следующими разрешениями:
    • catalog_management (чтобы управлять рекламой продавца от лица клиента, можно также запросить разрешение ads_management).

Необходимые конфигурации

extras

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

setup

setup

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

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

business_config

business_config

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

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

repeat

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

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

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

setup

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

external_business_id
Тип: строка

Обязательный параметр.
Уникальный ID, представляющий компанию вашего клиента. Мы используем это значение в качестве уникального идентификатора. Например, если компания называется Fubar, значение external_business_id для нее может равняться fubar-123.

timezone
Тип: строка

Обязательный параметр.
Часовой пояс, в котором расположена компания. См. возможные значения часовых поясов.

currency
Тип: строка

Обязательный параметр.
Трехбуквенный ISO-код валюты по умолчанию для каталога продуктов компании. См. поддерживаемые коды валют.

business_vertical
Тип: перечисление

Обязательный параметр.
Отрасль, с которой связана компания.
Значение: ECOMMERCE.

merchant_settings_id
Тип: строка

Необязательный параметр.
Используется при переходе с расширения Meta Business версии 1. Если вы переходите с версии 1 на версию 2, обратитесь к своему партнеру в Meta.

domain
Тип: строка

Обязательный параметр для каналов COMMERCE и COMMERCE_OFFSITE.
Домен, используемый для утверждения вручную в Instagram. Пример: https://exampleshop.partnersite.com.

channel
Тип: перечисление

Обязательный параметр.
Позволяет партнеру проявить намерение для пользователя в отношении функций, требующих дополнительных действий или ограничений.
Значение: FEED.
FEED — поток, позволяющий продавцам синхронизировать свои каталоги (исключая такой объект, как пиксель). Этот вариант рекомендуется только для партнеров с доступом к функциям ленты/каталога, у которых при этом нет доступа к функциям размещения сайта.

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_config

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

business
FBEBusinessPropertiesConfigData

Обязательный параметр.
Информация для компании конечного пользователя.

catalog_feed_scheduled
FBECatalogFeedConfigData

Необязательный параметр.
Указывает, должно ли расширение Facebook Business использовать метод ленты, в рамках которого элементы каталога извлекаются с помощью feed_url.

FBECatalogFeedConfigData

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

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

enabled
Тип: логическое значение

Обязательный параметр.
Флаг включения и отключения функции.

feed_url
Тип: строка

Обязательный параметр.
URL размещенного в общем доступе файла, содержащего ассортимент компании (файл должен иметь формат .csv, .tsv или .xml).