Часто задаваемые вопросы по расширению Meta Business

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

No, please see the updated Developer Documentation for the latest permissions.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

Установите флажок "Включить каталог" на вкладке Панель разработчика > Настройка в панели приложений.

Компании и продавцы могут настраивать бизнес-функции в представлении для управления, однако не могут обновлять связанные с FBE ресурсы, такие как аккаунт Business Manager, рекламный аккаунт, Страница, пиксель, каталог и т. п. Компании и продавцы также могут изменять параметры в рамках процесса настройки FBE для подключения различных объектов.

В зависимости от потребностей вашей компании вы можете настроить один или несколько из описанных ниже процессов, задав соответствующее значение в разделе Настройка > Канал.

• Процесс по умолчанию (параметр канала не требуется) — продавцы могут настраивать пиксель Facebook, Страницу Facebook, рекламный аккаунт и каталог для динамической рекламы.
• COMMERCE — процесс, позволяющий продавцам создавать коммерческие аккаунты в канале Facebook Магазина и Instagram Shopping с оформлением заказов на сайте. В рамках этого процесса также можно выбирать офлайн-магазины.
• COMMERCE_OFFSITE — процесс, позволяющий продавцам создавать коммерческие аккаунты с Facebook Магазинами и Instagram Shopping офлайн.
• FEED — процесс, позволяющий ритейлерам синхронизировать обновления своих каталогов. Этот вариант рекомендуется только для партнеров с доступом к функциям ленты или каталога, которые при этом не занимаются хостингом сайта.
• MARKETPLACE — этот процесс предназначен специально для магазинов, которые интегрируются с FBE. Он рекомендуется партнерам, которым в процессе настройки FBE необходимы только этапы, связанные со Страницей и Business Manager, после чего они смогут настроить партнерскую рекламу через представление для управления FBE.
• SIGNALS — процесс, позволяющий пользователям инициировать срабатывание пикселя Facebook и событий API Conversions. Он не позволяет использовать каталог Facebook в качестве объекта. Этот вариант рекомендуется только для партнеров, которые занимаются хостингом сайта и при этом не имеют доступа к функциям каталога.

Ниже описаны распространенные ситуации, которые могут сложиться при выборе Страниц во время входа в FBE от имени компании. Обратите внимание: причина, по которой вы не можете выбрать тот или иной объект, объясняется в подсказках в процессе FBE (она может зависеть от конкретного сценария).

Страницу можно будет выбрать, если выполняются следующие условия:

• выбранная Страница не принадлежит ни одному аккаунту Business Manager (в этом случае права на нее будут заявлены выбранным аккаунтом Business Manager);
• выбранная Страница принадлежит другому аккаунту Business Manager и не является его основной страницей (при этом она будет передана выбранному аккаунту Business Manager).

Страница нельзя будет выбрать, если выполняются следующие условия:

• Страница принадлежит другому аккаунту Business Manager и является его основной Страницей;
• Страница принадлежит аккаунту Business Manager, который был отключен (например, за нарушения политики).

Партнер может запросить для своего приложения доступ к функции Page Public Metadata Access, чтобы оно могло запрашивать содержимое общедоступных полей Страницы. Подробнее об этой функции можно узнать из этого и этого разделов.

Если поле instagram_profiles отсутствует, это означает, что в маркер доступа не включено разрешение Instagram (например, instagram_basic) и (или) компания не связала FBE ни с одним бизнес-профилем Instagram. Подробнее об API FBE Installation см. в этом документе.

Это означает, что у приложения отсутствуют некоторые разрешения. Обратите внимание, что основным разрешением, необходимым для действий, связанных с Business Manager, является business_management.

Мы поддерживаем большинство валют из этого списка, кроме JMD, BGN, BYN, UAH, KIP и LKR.

Внимание! Если в настройках конфигурации URL входа указаны неподдерживаемые валюты, установить FBE не удастся. Мы рекомендуем партнерам проверять, поддерживаются ли валюты, используемые их продавцами, прежде чем разрешать запуск FBE.

Убедитесь, что в дополнение к административному доступу к Странице Facebook компании или бизнес-профилю Instagram у вас также имеется доступ с правами администратора в аккаунте Facebook Business Manager, связанном с текущим подключением к FBE. Инструкции по добавлению администратора в Facebook Business Manager см. в этом разделе.

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

Please reach out to your partner manager or engineering contact.

This is a closed beta. Please reach out to your Meta partner manager for more information.

Чтобы получать информацию об ассортименте компании, в расширении Facebook Business (FBE) версии 2 используется каталог. Он нужен для работы с различными функциями, например динамической рекламой, Магазинами и карточками с актуальными услугами. Каталог не обязателен для интеграции, но требуется для этих функций.

Сведения о реализации и поддерживаемых полях см. в документации по API каталога для FBE.

Для начала работы вам потребуется одобренное разрешение на доступ к каталогу (catalog_management), которое можно запросить в рамках проверки приложения.

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

Вы можете отправить запрос на проверку приложения, когда у вас будет готовая рабочая демонстрация (в виде скринкаста), из которой будет ясно, как:

• в процессе подключения запрашиваются разрешения на работу с каталогом;
• ассортимент отправляется в подключенный каталог;
• после синхронизации каталога становятся доступны использующие его функции.

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

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

Возможность выбора объектов зависит от множества факторов, и они могут не соответствовать требованиям по целому ряду причин. Вот лишь некоторые из них:

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

В FBE 2.0 Страница Facebook или Instagram-профиль компании можно подключить к нескольким партнерским платформам (с использованием ID приложения). Однако один профиль можно подключить к каждой партнерской платформе только один раз.

Нет. Партнерские платформы могут включить чат Messenger, установив параметр messenger_chat объекта business_config в настройках входа от имени компании. Магазины на Странице после миграции включаются компаниями или продавцами в представлении для управления.

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

Нет. Эти два плагина в представлении для управления FBE упразднены. По состоянию на 2021 год поддерживается только плагин чата Messenger.

В доменах из разрешенного списка Messenger должен использоваться протокол HTTPS. Партнеры должны убедиться, что URL поля domains содержит соответствующий префикс протокола, т. е. https://.

Подробнее о настройке объекта FBEMessengerChatConfigData.

Обычно партнерам проще проверить работоспособность домена Messenger, избавив компании и продавцов от необходимости настраивать домены. Партнер может задать в объекте business_config для входа от имени компании FBE параметр messenger_chat.domains и установить messenger_chat.enabled=false.

Затем компания или продавец сможет активировать плагин Messenger в представлении для управления, либо партнер может предоставить компании или продавцу возможность сделать это на своей платформе через API Feature Configuration.

Проверка интеграции — это процесс, в рамках которого Facebook проверяет вашу интеграцию с FBE. После того как приложение пройдет проверку интеграции, оно станет доступно пользователям (т. е. компаниям и продавцам).

Запросить проверку интеграции можно на вкладке Панель разработчика > Обзор в FBE приложения, когда в нем будут реализованы все требования. Чтобы ускорить процесс проверки, вам нужно будет предоставить нашим проверяющим или своему представителю в Facebook полную видеодемонстрацию того, как используются реализованные вами функции FBE.

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

• Подробнее об ограничениях панели разработчиков FBE см. в этом разделе.

Please reach out to your Meta partner manager, or submit a new integration review.

Да, FBE поддерживается в мобильных браузерах и запускается через функцию веб-просмотра в нативных приложениях Android и iOS. Подробнее о запуске FBE на мобильном устройстве см. в этом разделе.

Для вызова API Graph необходимы маркеры доступа. Различные виды маркеров доступа описаны в этом разделе.

Вы можете вызвать вход через Facebook, чтобы получить access_token перед запуском представления для управления, а затем использовать этот access_token для вызова API Feature Configuration.

Пример кода:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

Для использования платформы Instagram Shopping для работы с офлайн- и онлайн-магазинами необходим бизнес-аккаунт Instagram. Личный аккаунт Instagram для этого не подходит. Если ваш бизнес-аккаунт Instagram не представлен надлежащим образом или не продает соответствующие товары, у него может отсутствовать право на использование этой платформы. Запросить повторную проверку можно через 6 (шесть) месяцев. Ознакомьтесь с квалификационными требованиями.

Коммерческому аккаунту могут принадлежать либо офлайн-, либо онлайн-магазины. Также можно превращать онлайн-магазины в офлайн и наоборот. Если вашей компании нужны как офлайн-, так и онлайн-магазины, потребуется дважды запустить процесс подключения с разными объектами.

Возможность выбора объектов зависит от множества факторов, и они могут не соответствовать требованиям по целому ряду причин. Вот некоторые из них:

• пользователь не является администратором в компании, которой принадлежит Страница;
• Страница связана с другим аккаунтом Business Manager.

Для обращения за помощью непосредственно к нашей команде используйте инструмент прямой поддержки в Business Manager.

• Партнерам по бронированию, резервированию и заказу пищи необходимо обратиться к теме "Расширение Facebook Extension для сферы обслуживания".
• Коммерческим партнерам необходимо обратиться к теме "Партнер по маркетингу: техническая поддержка" или непосредственно к своему менеджеру по работе с партнерами.

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

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

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.