Руководство по миграции с расширения Facebook Business версии 1 на версию 2

В этом руководстве описаны изменения, которые необходимо внести для переноса существующих продавцов с расширения Facebook Business версии 1 на версию 2.

Изменения

Так как вторая версия расширения Facebook Business сильно отличается от первой в смысле технических аспектов реализации, при развертывании и использовании расширения настоятельно рекомендуем следовать руководствам для расширения Facebook Business версии 2.

Вход от имени компании

При запуске входа от имени компании в расширении Facebook Business версии 2 укажите merchant_settings_id в объекте настройки. merchant_settings_id в расширении Facebook Business версии 1 передается в сообщении с помощью параметра set merchant settings (справка) и должен уже храниться на стороне партнера, чтобы всплывающее представление расширения Facebook Business версии 1 правильно отображалось для возвращающихся пользователей.

Через URL

https://facebook.com/dialog/oauth?client_id=<YOUR_FB_APP_ID>
&display=<popup|window|page>
&redirect_uri=<REDIRECT_URI> // e.g. "https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension,catalog_management
&extras={
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", // e.g. "foo-123"
        "timezone": "<BUSINESS_TIMEZONE>", // e.g. "America/Los_Angeles"
        "currency": "<BUSINESS_SERVICES_CURRENCY>", // e.g. "USD"
        "business_vertical": "ECOMMERCE"
        "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>",
     },
     ...
}

Через SDK

function launchFBE() {
        FB.login(function (response) {
            if (response.authResponse) {
                // returns a User Access Token with scopes requested
                const accessToken = response.authResponse.accessToken;
                const message = {
                    'success':true,
                    'access_token':accessToken,
                };
                // store access token for later  
            } else {
              console.log('User cancelled login or did not fully authorize.');
            }
        }, {
            scope: 'catalog_management,manage_business_extension',
          // refer to the extras object table for details
            extras: {
                "setup":{
                  "external_business_id":"<external_business_id>",
                  "timezone":"America\/Los_Angeles",
                  "currency":"USD",
                  "business_vertical":"ECOMMERCE",
                  "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>",
                },
                ...
            }
        });
    }

merchant_settings_id следует передавать через вход от имени компании, только если пользователь ещё не перешел на расширение Facebook Business версии 2. При передаче merchant_settings_id мы получаем выбранные объекты пользователя в расширении Facebook Business версии 1 и упрощаем процесс миграции для него.

Если вы указали merchant_settings_id в процессе настройки расширения Facebook Business, пользователю будет предложено выбрать один из следующих способов миграции:

• Если у пользователя есть права администратора для всех объектов из расширения Facebook Business версии 1 и соответствующих аккаунтов Business Manager, пользователю будет предложено выполнить миграцию на одном экране, как на рисунке слева. При таком способе миграции заранее выбранный аккаунт Business Manager копирует Business Manager пикселя, так как пиксель невозможно перенести в другой аккаунт.

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

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