마이그레이션 가이드: FBE v1에서 FBE v2로 마이그레이션

이 마이그레이션 가이드에서는 FBE v1에서 FBE v2와 호환되도록 기존 판매자를 마이그레이션하는 데 필요한 변경 사항에 관해 설명합니다.

변경 사항

FBE v2는 기술 구현 측면에서 FBE v1과 상당히 다르기 때문에 구현과 모범 사례는 FBE v2 가이드를 참고하시기 바랍니다.

FBE, v1FBE v2

시작 화면

비즈니스 로그인을 사용하여 인증하고 설정합니다. 관리 보기는 별도로 시작됩니다.

픽셀

픽셀에 대한 구현과 유사하지만 서버측 API가 추가되었습니다.

카탈로그

구현은 유사하지만 풀(피드) 방식보다는 푸시(API 사용) 방식을 적극 권장합니다. 자세한 내용은 FBE v2.0 카탈로그 문서를 참조하세요.

메시지 전달

사용 중단되었습니다. 비즈니스 정보를 가져오는 옵션은 Webhooks와 FBE 설치 엔드포인트, 이렇게 두 가지가 있습니다.

비즈니스 로그인

FBE v2용 비즈니스 로그인을 시작할 때 setup 개체에서 merchant_settings_id를 지정하세요. FBE v1의 merchant_settings_idset merchant settings(참고 자료)를 통해 전달되는 메시지로 전송되며, 파트너 측에 이미 저장되어 있으므로 FBE v1의 재방문 사용자를 위한 적절한 FBE 보기가 팝업으로 표시됩니다.

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는 사용자가 아직 완전히 FBE v2로 마이그레이션하지 않은 경우에만 비즈니스 로그인에 전달되는 것이 좋습니다. merchant_settings_id가 전달되면 FBE v1에서 사용자가 선택한 자산을 가져와 사용자의 마이그레이션 프로세스를 간소화합니다.



FBE 설정 플로에서 merchant_settings_id를 제공할 때 사용자에게 다음 마이그레이션 경로가 표시됩니다.

  • 사용자가 FBE v1의 모든 자산과 각 비즈니스 관리자에 대한 관리자 액세스 권한이 있을 경우, 왼쪽과 같이 사용자에게 한 화면으로 마이그레이션 메시지가 표시됩니다. 이 마이그레이션에서 사전에 선택된 비즈니스 관리자는 픽셀의 비즈니스 관리자를 따릅니다. 픽셀은 다른 비즈니스 관리자로 마이그레이션할 수 없기 때문입니다.

  • 사용자가 FBE v1의 모든 자산에 대한 관리자 액세스 권한이 있지만 비즈니스 관리자가 픽셀을 소유하지 않을 경우, 왼쪽과 같이 사용자에게 한 화면으로 마이그레이션 메시지가 표시됩니다(편집 기능 포함). 이 경우 사용자는 기존 비즈니스 관리자를 선택하거나 새 비즈니스 관리자를 생성할 수 있습니다.

  • 모든 자산과 각 비즈니스 관리자에 대한 관리자 액세스 권한이 없는 사용자는 오른쪽과 같이 오류 화면으로 리디렉션됩니다. 이 마이그레이션에서는 일반적인 FBE 설정 플로를 따르고 각 자산을 선택해야 합니다.