Расширение Meta Business

Подключение расширения Meta Business для коммерции

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

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

Разница между офлайн- и онлайн-магазином заключается в том, что для оформления заказа в офлайн-магазине посетитель перенаправляется на сайт продавца, а для онлайн-магазина эта процедура выполняется в приложении Facebook или Instagram.

В рамках процесса подключения для коммерции компании могут настраивать и интегрировать следующие компоненты и функции:

  • пиксель Meta;
  • каталог;
  • рекламный аккаунт;
  • магазин на Странице Facebook;
  • магазин в Instagram;
  • чат Messenger (необязательно);
  • Business Manager;
  • Commerce Manager.

Чтобы использовать платформу Instagram Shopping для работы с офлайн- и онлайн-магазинами, необходим бизнес-аккаунт Instagram. Этот аккаунт должен отвечать квалификационным требованиям.

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


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

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

  1. Зарегистрируйтесь в качестве разработчика Meta. Создавайте собственные приложения для Facebook, используя наши инструменты для разработчиков.
  2. Создайте приложение Facebook, если вы ещё не сделали этого.
  3. Ваше приложение Facebook должно принадлежать аккаунту подтвержденной компании в Business Manager. Узнайте, как подтвердить свою компанию.
  4. Создайте тестовое приложение на основе рабочей версии своего приложения, которое вы будете использовать для разработки и тестирования новых возможностей.
  5. Получите частное разрешение manage_business_extension (для получения этого разрешения ваш представитель в Facebook должен добавить ваше приложение в список разрешенных). Когда ваше приложение получит доступ к этой возможности, вы увидите панель разработчика FBE в разделе Продукты.

  6. Запросите следующие разрешения в рамках проверки приложения для своего приложения Facebook:

    • catalog_management — позволяет пользователям с правами администратора создавать, считывать, обновлять и удалять каталоги продукции своих компаний. Вы также можете запросить разрешение ads_management, если собираетесь управлять рекламой от имени продавцов, использующих ваше приложение.
    • business_management — требуется для управления активами компании с помощью API Business Manager.
    • Instagram_basic — требуется при использовании Instagram Shopping. Разрешение instagram_basic позволяет вашему приложению просматривать информацию профиля и медиафайлы аккаунта Instagram.
    • pages_read_engagement — потребуется позже для создания маркера доступа к Странице.
    • [Для онлайн-магазинов] commerce_manage_accounts (чтение/запись) или commerce_account_read_settings (только чтение) — эти точные разрешения предоставляются в рамках проверки приложений для управления коммерческим аккаунтом.
    • [Для онлайн-магазинов] commerce_account_manage_orders (чтение/запись) или commerce_account_read_orders (только чтение) — эти точные разрешения необходимы для получения списка, просмотра и обновления заказов через коммерческий аккаунт.
    • [Для онлайн-магазинов] commerce_account_read_reports — позволяет вашему приложению просматривать данные о финансовой отчетности, чтобы создавать пользовательские отчеты о налогах, выверке денежных средств и компенсации для торгового аккаунта.

  7. Для платформы Instagram Shopping может потребоваться подтверждение домена, если домен продавца ещё не подтвержден. Узнайте, как подтвердить свой домен.

  8. Настройте аутентификацию с необходимыми параметрами и запустите процесс подключения расширения Facebook Business через вход от имени компании или Facebook App Store.

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

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
строка

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

domain
строка

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

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

Обязательный параметр.
Позволяет партнеру проявить намерение для пользователя в отношении функций, требующих дополнительных действий или ограничений: COMMERCE и COMMERCE_OFFSITE.

  • COMMERCE — позволяет продавцу создать коммерческий аккаунт с Магазином на Странице и в канале Instagram Shopping с онлайн-оформлением заказов (в этом процессе также можно выбрать офлайн-вариант оформления заказов).
  • COMMERCE_OFFSITE — процесс, позволяющий продавцам создавать коммерческие аккаунты с Facebook Магазинами и Instagram Shopping офлайн.

Примечание. Партнеры должны запрашивать разрешение instagram_basic для всех коммерческих процессов (COMMERCE и COMMERCE_OFFSITE). Разрешение instagram_basic необходимо приложению в соответствии с политикой доступа при подключении и для продавцов в Instagram. Для получения этого разрешения необходимо пройти проверку приложения.

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

Этот объект используется для настройки параметров компании конечного пользователя (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_url и cta_button_text.

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