온보딩 통합

판매자를 Meta 커머스에 통합하도록 지원하려면 Shops 온보딩이 필수 절차입니다. 온보딩이 원활하면 판매자의 제품이 최신 상태로 유지되고, 주문 정보가 적절히 동기화되며, 분기 또는 연도별로 쉽게 조정할 수 있고, 은행 및 지급 정보가 적절히 설정되어 시기적절한 지급과 보고가 가능합니다.

요구 사항

Facebook Business 확장 도구(FBE)와 통합하고 판매자에게 다음을 가능하게 하여 Shops 통합 품질 기준을 준수해야 합니다.

• 플랫폼에서 Meta 통합을 쉽게 발견
• 3P 계정을 Meta 자산(비즈니스 관리자, 기존 카탈로그(해당할 경우), 기존 픽셀(해당할 경우), 페이지, Instagram 핸들)에 연결
• 사이트 내 Shop 설정(반품 설정, 법적 정보, 은행 계좌 정보, 세금 정보)을 설정하고 수정
• 추가 자산(페이지, Instagram 핸들)을 Shop에 링크
• 설정 수정
• 오프보딩

시작하기 전에

1. 인증된 비즈니스를 FBE에 통합합니다.
2. FBE를 앱에 추가하고 FBE 개발자 패널에 대한 액세스 권한을 얻습니다. 이 다이어그램을 보고 커머스를 위한 FBE 플로를 이해합니다.
3. FBE 설정 단계에 따르고 FBE 통합 검수를 위해 통합을 제출합니다. 여기에는 FBE 기능 관리 경험을 플랫폼 내에서 지원하여 비즈니스가 기능을 변경하거나 FBE 설정을 삭제하도록 지원하는 과정도 포함됩니다.

요구 사항 1: Facebook Business 확장 도구와 통합

Facebook Business 확장 도구(FBE)는 타사 사이트에서 플러그인으로 제공되는 Meta 소유의 팝업 기반 인터페이스이고 Meta와의 전반적 통합 프로세스를 단순화합니다. FBE를 사용하면 비즈니스가 Meta 픽셀, 카탈로그, Shops를 쉽게 설정할 수 있습니다. 그러면 비즈니스가 플랫폼에서 자신의 제품과 서비스를 Facebook 및 Instagram 채널과 연결하는 데 도움이 됩니다. 연결하고 나면 비즈니스가 다양하고 효과적인 기능을 사용하도록 지원할 수 있습니다.

간단히 말해 FBE 기반 통합에서는 책임이 아래와 같이 분리됩니다.

• Meta 소유: 연결된 자산을 확인하고 설치된 기능과 커머스 통합 상태를 관리하는 인터페이스, 인증, 연결 및 표면 [(FBE 관리 보기)](FBE 기능 관리 보기)
• 파트너 소유: 픽셀 설정, API를 통해 Facebook 카탈로그에 인벤토리 업로드

설정이 끝나면 비즈니스는 기존 자산을 사용하거나 새로운 자산을 만들거나 이 두 가지 방법을 결합하여 FBE 온보딩 플로를 시작할 수 있습니다.

1단계: FBE에 대한 진입점을 앱에 추가

사용자가 자산(예: 비즈니스, 카탈로그, Shops, 픽셀)을 선택, 관리 또는 생성할 수 있는 FBE에 대한 진입점을 만듭니다. 이 진입점은 다음 중 하나의 형식을 취할 수 있습니다.

• 비즈니스 로그인(일명 Facebook 로그인) – 비즈니스가 사이트에 있는 버튼을 사용하여 플랫폼에서 연결을 시작하도록 허용합니다.
• 비즈니스 앱 – 비즈니스가 Meta 표면에서 연결을 시작하도록 허용합니다. 이 플로를 지원하고 Meta 비즈니스 앱에 자신의 앱을 등록하려면 사이트에서 맞춤 인증 UI를 제공해야 합니다. 이 UI에서는 사용자가 자신의 비즈니스를 선택하면 선택된 정보와 함께 Meta 플로로 다시 리디렉션되도록 허용해야 합니다.

예

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   additionally use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "domain": "https://example-shop.partner-site.com/",
    "channel": "ECOMMERCE",
    "business_vertical": "ECOMMERCE"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "catalog_feed_scheduled": {
      "enabled": true,
      "feed_url": "https://partner-site.com/feed-url"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

선택한 설정에 따라 나중 단계에서 사용할 수 있는 비즈니스 액세스 토큰을 여러 가지 방법으로 받을 수 있습니다.

• 비즈니스 로그인 – 일반적인 Facebook 로그인과 마찬가지로 이 플로가 끝나면 access_token이 반환됩니다. 이 토큰을 사용하여 더 많은 자산(예: 픽셀 ID, 페이지 ID, Instagram 비즈니스 ID)을 가져옵니다.
• 비즈니스 앱 – Webhooks를 사용합니다.

2단계: FBE_install Webhooks 설정

Webhooks는 App Store에 등록하고자 하는 모든 파트너에게 필수입니다. 앱 스토어에 앱을 등록하지 않을 계획인 경우 이 섹션을 무시하거나 나중에 다시 돌아와서 수행할 수도 있습니다. Meta는 비즈니스가 FBE를 설치, 수정 또는 삭제할 때마다 Webhooks 이벤트를 실행합니다. Webhooks 이벤트를 수신할 때마다 앱에서 이 이벤트를 사용하고 비즈니스가 어떤 자산을 수정, 추가했거나 앱과의 연결에서 제거했는지 알 수 있습니다. 앱의 동작은 가장 최근에 연결된 자산을 기준으로 업데이트됩니다. Webhooks 구독을 구현하고 테스트하는 것이 좋습니다.

Webhooks를 설정하려면 다음 단계를 따르세요.

1. Meta의 요청을 적절히 처리할 수 있는 안전한 서버에 엔드포인트를 만듭니다.
2. 앱 대시보드에서 다음과 같이 FBE Webhooks 설명을 구성합니다.
1. FBE 섹션 > Webhooks 탭에 앱의 콜백 URL을 입력합니다.
2. 인증 토큰을 입력하고 엔드포인트를 검증합니다.

설정이 끝나면 fbe_install Webhooks가 자동으로 구독됩니다.

단계에 대한 자세한 내용은 Webhooks를 참조하세요.

알림

설치에 대한 Webhooks 알림을 받은 후 다음을 수행해야 합니다.

1. 액세스 토큰(및 토큰 유형)을 저장하고 앱에 액세스 권한이 부여된 자산을 기록합니다.
2. 액세스 권한이 부여된 자산에 따라 기능 세트를 활성화합니다.
3. 특정 기능에 필수적인 자산이 없을 경우 해당 기능만 비활성화합니다. 예를 들어 앱에 픽셀이 아닌 카탈로그에 대한 액세스 권한이 부여된 경우, 픽셀 기반 기능이 아니라 카탈로그 기반 기능만 구현하세요.
4. 액세스 권한이 부여된 자산에 따른 앱의 작동 방식에 대한 업데이트 정보를 사용자에게 알립니다.

기존 설치에 대한 업데이트를 받은 후 다음을 수행해야 합니다.

1. 액세스 토큰과 자신에게 부여된 자산 기록을 업데이트합니다.
2. 플랫폼에 허용된 자산에 따라 앱에서 판매자에 대해 활성화할 기능 세트를 업데이트합니다.
3. 액세스 권한이 부여된 자산에 따른 앱의 작동 방식에 대한 업데이트 정보를 사용자에게 알립니다.

삭제 알림을 받은 후 다음을 수행해야 합니다.

1. 앱이 판매자에 대해 구현한 기능을 비활성화합니다.
2. 판매자에게 구성 변경 사항에 대해 알립니다.

3단계: 반환된 토큰으로 자산 상세 정보 가져오기

다음의 방법 중 하나(또는 두 가지 모두)를 사용하여 FBE를 통해 플랫폼에 연결된 비즈니스 정보를 가져올 수 있습니다.

• Webhooks—App Store에 등록하고자 하는 모든 파트너에게 필수입니다. Webhooks를 설정하면 2단계의 Webhooks 설정에서 제공하는 Webhooks 페이로드를 통해 FBE를 사용한 비즈니스 온보딩 또는 수정에 대한 자세한 정보를 수신하게 됩니다.
• FBE 설치 API 엔드포인트—셀프 호스팅 비즈니스에 권장합니다. FBE를 설치한 비즈니스의 경우 fbe_installs 엔드포인트를 사용하여 기본 설치 정보를 쿼리할 수 있습니다. 비즈니스의 액세스 토큰과 외부 비즈니스 ID를 사용하면 FBE 설치 API 엔드포인트를 호출하여 설정에 대한 자세한 정보를 받을 수 있습니다.

예: FBE 설치 API 호출

curl -i -X GET \   "https://graph.facebook.com/<version>/fbe_business/fbe_installs?fbe_external_business_id=<external business id>&access_token=<access token sanitized>"

4단계: 시스템 사용자 토큰 가져오기

사용자가 FBE를 설치한 후 확장 도구에서 클라이언트 비즈니스 관리자에 직원 시스템 사용자를 생성합니다. 이 시스템 사용자는 더 이상 비즈니스 관리자에서 보이지 않고 백엔드에 존재합니다. {App Name} System User (FBE) 스키마에 따라 이 새로운 시스템 사용자에 이름을 지정합니다.

이를 위해 다음과 같이 API 호출을 보냅니다.

curl -X POST \
  -F 'app_id={app_id}' \
  -F 'scope=ads_management,catalog_management,manage_business_extension' \ 
  -F 'access_token={user_access_token}' \
  -F 'fbe_external_business_id={fbe_external_business_id}' \ 
https://graph.facebook.com/<API_VERSION>/<client_business_manager_id>/access_token

scope 필드의 경우 manage_business_extension 권한을 사용합니다. 사용 사례에 따라(5단계 참조) ads_management, catalog_management, pages_read_engagement, business_management, instagram_basic 및 manage_business_extension 권한도 필요할 수 있습니다.

• 앱에서 비즈니스의 광고 계정을 읽고 관리해야 하는 경우 ads_management 권한을 요청하세요. 이 권한을 사용하면 광고 캠페인을 만들고, 광고 지표를 가져오고, 광고 관리 도구를 빌드하는 등의 기능이 제공됩니다.
• 앱에서 비즈니스가 관리자 역할을 맡은 비즈니스 소유 제품 카탈로그를 만들거나, 읽거나, 업데이트하거나 삭제해야 할 경우 catalog_management 권한을 요청해야 합니다. 이 권한은 모든 앱에서 사용하는 것이 좋습니다. 그러면 앱에서 커머스 관련 다이내믹 광고와 인벤토리 관리 솔루션을 빌드할 수 있습니다.

5단계: 관리 보기 설정

비즈니스가 (설치 시점에 지정된 것보다) 더 많은 기능을 구성하도록 하려면 비즈니스를 플랫폼의 FBE 기능 관리 보기로 안내할 수 있습니다. JavaScript SDK 또는 URL을 사용해서 FBE 관리 보기를 시작하는 진입점을 추가할 수 있습니다. 두 방법 모두 클릭하면 FBE 관리 보기 창을 시작하는 버튼을 표시해야 합니다.

6단계: FBE 삭제 진입점 추가

비즈니스가 FBE를 삭제할 수 있는 진입점(예: 버튼)을 플랫폼에 추가해야 합니다. 이를 위해서는 적절한 엔드포인트에 DELETE 요청을 보내는 것이 좋습니다.

예: 삭제 엔드포인트 호출

curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

fbe_install Webhooks를 구현한 경우 사용자가 FBE를 삭제할 때 이벤트를 수신하게 됩니다.

더 알아보기

• Facebook Business 확장 도구(FBE)
• FBE 설정 단계
• FBE 개발자 패널
• FBE 삭제
• Webhooks