Este guia descreve as alterações necessárias para migrar vendedores existentes da FBE 1.0 para a FBE 2.0 de forma compatível.
A FBE 2.0 é diferente da 1.0 em relação à implementação técnica. Recomendamos que você siga os guias da FBE 2.0 para saber mais sobre a implementação e boas práticas.
FBE 1.0 | FBE 2.0 |
---|---|
Usa o Login de empresa para autenticação e configuração. A Visualização do gerenciamento é iniciada separadamente. | |
Implementação semelhante do pixel, com a inclusão da API no lado do servidor. | |
Implementação semelhante. A abordagem Push (via API) é recomendada no lugar da Pull (Feed). Veja mais informações na documentação sobre o catálogo da FBE 2.0. | |
OBSOLETO. Há duas opções para localizar informações da empresa: Webhook e ponto de extremidade de instalações da FBE. |
Ao iniciar o Login de empresa na FBE 2.0, especifique o merchant_settings_id
no objeto setup. O merchant_settings_id
na FBE 1.0 é enviado na transmissão de mensagens via set merchant settings
(referência) e já deve estar armazenado pelo parceiro para mostrar a visualização adequada da FBE aos usuários que retornam à versão 1.0.
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>", }, ... }
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>", }, ... } }); }
Preferencialmente, o merchant_settings_id
só deve ser transmitido no Login de Empresa quando o usuário ainda não tiver feito a migração para a FBE 2.0. Quando o merchant_settings_id
é transmitido, localizamos os ativos do usuário selecionados na FBE 1.0 e simplificamos o processo de migração.
Quando você fornece o merchant_settings_id
no fluxo de configuração da FBE, o usuário é orientado a seguir estes caminhos de migração:
Se tiver acesso de administrador a todos os ativos da FBE 1.0 e aos respectivos Gerenciadores de Negócios, o usuário deverá seguir a migração em uma única tela, como mostrado à esquerda. Nesse processo, o Gerenciador de Negócios pré-selecionado segue o do pixel, já que não é possível migrar o pixel para outro Gerenciador de Negócios.
Se tiver acesso de administrador a todos os ativos da FBE 1.0, mas o pixel não pertencer a um Gerenciador de Negócios, o usuário deverá seguir a migração em uma única tela, como mostrado à esquerda, mas com a funcionalidade Editar. Nesse caso, os usuários podem selecionar um Gerenciador de Negócios existente ou criar um novo.
Sem acesso de administrador a todos os ativos da FBE 1.0 e aos respectivos Gerenciadores de Negócios, os usuários serão redirecionados a uma tela de erro, como mostrado à direita. Nessa migração, eles deverão seguir o fluxo normal de configuração de FBE e selecionar cada ativo.