Панель разработчика расширения Meta Business

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

Открытие панели разработчика расширения Meta Business

  1. Откройте панель приложений и нажмите название приложения, которое вы хотите настроить. Если же вы ещё этого не сделали, создайте приложение Meta, выбрав в качестве типа бизнес-приложение.
  2. В панели приложений нажмите Добавить продукт.
  3. В списке продуктов найдите расширение Meta Business (возможно, для этого потребуется нажать Посмотреть другие продукты).
  4. На карточке продукта нажмите Настроить.
  5. Панель разработчика расширения Meta Business будет добавлена в левую часть панели приложений. На ее вкладках вы найдете контрольный список и список действий, которые нужно выполнить для настройки: обеспечение соответствия требованиям, настройка каталога, выбор функций и т. д.
  6. Пройдите подготовительные шаги, а затем перейдите на вкладку Настройка (меню слева) и заполните остальную информацию.
  7. Отправьте свою интеграцию на проверку: воспользуйтесь вкладкой Проверка интеграции на панели разработчика расширения Meta Business. Когда интеграция будет одобрена, вы получите доступ к вкладке Статус запуска, с которой можно запустить приложение для всех пользователей. Подробнее о проверке интеграции см. в этом разделе.

Не можете найти расширение Meta Business в списке продуктов?

  • Если расширения Meta Business нет в вашем списке продуктов, возможно, приложению требуется частное разрешение manage_business_extension. Свяжитесь со своим партнером Meta и попросите его добавить ваше приложение в список разрешений и сообщить вам об этом.
  • Для доступа к панели разработчика расширения Meta Business ваше приложение должно иметь тип Бизнес-приложение.

Вкладка "Обзор"

В контрольном списке на вкладке "Обзор" перечислено всё, что вам необходимо выполнить, собрать и проверить в рамках интеграции расширения Meta Business, чтобы передать приложение на проверку нашей команде.

Это простое и понятное руководство, с которым вы ничего не упустите. По мере выполнения соответствующих действий на вкладке Настройка пункты в контрольном списке автоматически помечаются как "Не выполнено", "Необязательно", "С ошибками" и "Выполнено".

Вкладка "Настройка"

На вкладке Настройка настраивается и проверяется большая часть интеграции. Перед началом работы подумайте о вариантах использования, инструментах аутентификации и функциях, которые ваше приложение будет предлагать компаниям. Это обеспечит правильную настройку конфигурации и построение нужных инструментов.

  • Какие сценарии использования (отрасли) обслуживает ваше приложение? Примеры: запись на прием, коммерция, бронирования в ресторанах и т. д. Полный список поддерживаемых в расширении Meta Business сценариев использования см. в этом разделе.
  • Доступ к каким функциям вы хотите предоставить компаниям через свое приложение? Пример: призывы к действию в Instagram, чат Messenger и т. д.

В каждом разделе этой вкладки предлагается проверить определенные моменты, чтобы понять, есть ли в вашей текущей интеграции ошибки, которые нужно исправить, прежде чем предоставлять компаниям доступ к ней. Например, при реализации входа для компаний или URL аутентификации недействительные или недопустимые значения параметров конфигурации (неподдерживаемая валюта, неправильно заданный объект extras, неполные настройки функций и т. д.) приведут к возникновению ошибок при нажатии кнопки Сохранить, и соответствующей карточке будет присвоен статус "С ошибками".

Пример

Webhooks

Чтобы настроить Webhooks или изменить их конфигурацию используйте карточку Webhooks. Система проверит указанный в ней URL обратного вызова и маркер подтверждения. После проверки Webhooks fbe_install будет автоматически подписан. Подписку можно активировать и отменить с помощью переключателя внизу карточки.


Символы подстановки в доменах

Символы подстановки в доменах можно использовать для общей проверки пикселя. Проверка пикселя также используется для поиска компаний, которые могут получить выгоду от использования расширения Meta Business. Укажите все возможные варианты URL компании на вашей платформе.


Примеры

  • https://www.example.com
  • https://www.example.com/*
  • Если у компании могут быть поддомены:
    • https://www.*.example.com
  • Если у компании должны быть обязательные пути:
    • https://www.example.com/some_mandatory_path/*
    • https://www.example.com/*/some_mandatory_path/*

Вопросы о пикселе

Используйте вопросы о пикселе, чтобы продумать реализацию пикселя. Эти вопросы можно найти на карточке настройки пикселя на вкладке "Настройка". Чтобы ответить на вопросы, нажмите кнопку "Настроить". При проверке интеграции мы на основании ваших ответов стараемся понять, как реализовано срабатывание вашего пикселя.

Вкладка "Проверка интеграции"

На этой вкладке можно запустить проверку интеграции. Интеграцию можно отправить на проверку после выполнения всех обязательных пунктов контрольного списка на вкладке "Обзор".

Вкладка "Статус запуска"

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

Вкладка "Отладчик"

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

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

Ошибки, связанные с неправильной настройкой приложения

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

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

Пример


Как устранять обнаруженные ошибки?

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

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

Наиболее распространенные примеры:

  • Поле currency в объекте setup имеет неправильный формат. Это означает, что Facebook не поддерживает значение валюты, которое вы отправляете в объекте extras для некоторых компаний.

  • Поле ig_cta в объекте business_config содержит недействительные значения. Это означает, что поля или значения, используемые для реализации призыва к действию в Instagram, не соответствуют ожидаемым для объекта ig_cta.

Отладчик расширения Meta Business

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