Migrations-Leitfaden: FBE, v1 zu FBE, v2

In diesem Migrations-Leitfaden werden die Änderungen beschrieben, die notwendig sind, um bestehende Händler von FBE, v1 zu FBE, v2 zu migrieren.

Änderungen

Das sich FBE, v2 in der technischen Implementierung erheblich von FBE, v1 unterscheidet, raten wir dir, dich für die Implementierung und Best Practices unbedingt an die FBE, v2-Leitfäden zu halten.

Unternehmens-Login

Gib beim Launch von Unternehmens-Login für FBE, v2 die merchant_settings_id im Einrichtungs-Objekt an. Die merchant_settings_id in FBE, v1 wird mit der Nachrichtenübergabe über set merchant settings (Referenz) gesendet und sollte bereits auf der Website des Partners gespeichert sein, damit Nutzer*innen von FBE, v1 eine korrekte FBE-Ansicht angezeigt wird.

Via 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>",
     },
     ...
}

Via 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 sollte idealerweise nur dann an das Unternehmens-Login übergeben werden, wenn der*die Nutzer*in noch nicht erfolgreich zu FBE, v2 migriert hat. Wenn die merchant_settings_id übergeben wird, rufen wir die ausgewählten Assets des*der Nutzer*in unter FBE, v1 ab und vereinfachen so den Migrationsprozess für die*die Nutzer*in.

Wenn du die merchant_settings_id im FBE-Einrichtungsablauf angibst, wird der*die Nutzer*in zur Eingabe der folgenden Migrationspfade aufgefordert:

• Hat ein*e Nutzer*in Zugriff auf alle Assets aus FBE, v1 und die dazugehörigen Business Manager, wird der*die Nutzer*in aufgefordert, eine One-Screen-Migration durchzuführen, wie auf der linken Seite dargestellt. Bei dieser Migration folgt ein vorausgewählter Business Manager dem Business Manager des Pixels, da das Pixel nicht zu einem anderen Business Manager migriert werden kann.

• Hat ein*e Nutzer*in Administratorzugriff auf alle Assets aus FBE, v1, gehört das Pixel jedoch keinem Business Manager, wird der*die Nutzer*in aufgefordert, eine One-Screen-Migration durchzuführen, wie auf der linken Seite dargestellt. Dabei muss er*sie jedoch die Bearbeiten-Funktionalität verwenden. In diesem Szenario können Nutzer*innen einen vorhandenen Business Manager verwenden oder eine neuen erstellen.

• Ohne Administratorzugriff auf alle Assets und die dazugehörigen Business Manager werden Nutzer*innen an einen Fehlerbildschirm weitergeleitet, wie auf der rechten Seite angezeigt. In dieser Migration müssen sie einen normalen Einrichtungsablauf befolgen und jedes Asset auswählen.