Meta Business 확장 도구 FAQ

Meta Business 확장 도구(MBE) 통합과 관련하여 자주 묻는 질문에 대한 답변입니다.

설치

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

앱 대시보드의 FBE 개발자 패널 > 설정 탭에 '카탈로그 활성화' 확인란이 활성화되었는지 확인하세요.

비즈니스/판매자는 관리 보기 에서 비즈니스 기능을 구성할 수 있지만 FBE에 연결된 Facebook 자산(예: 비즈니스 관리자, 광고 계정, 페이지, 픽셀, 카탈로그)을 업데이트할 수 없습니다. 또는 비즈니스/판매자가 FBE 설정 플로에서 설정을 편집하고 다른 자산과 연결할 수 있습니다.

비즈니스 요구 사항에 따라서 설정 > 채널에서 적절한 값을 구성하고 다음의 플로를 하나 이상 설정할 수 있습니다.

  • 기본 플로(채널에 매개변수 불필요) - 판매자가 Facebook 픽셀, Facebook 페이지, 광고 계정, 다이내믹 광고용 카탈로그를 설정하도록 허용합니다.
  • COMMERCE — 판매자가 사이트 내 결제를 포함해 Facebook Shop과 Instagram 쇼핑 채널을 생성하도록 허용하는 플로입니다. 플로 내에서 오프사이트 매장을 선택하는 옵션도 검증합니다.
  • COMMERCE_OFFSITE — 판매자가 오프사이트 Facebook Shop과 오프사이트 Instagram 쇼핑으로 상거래 계정을 만들 수 있는 플로입니다.
  • FEED - 리테일 업체가 카탈로그 업데이트를 동기화하는 플로입니다. 피드/카탈로그 기능이 있고 웹사이트 호스팅이 없는 파트너에게만 추천합니다.
  • MARKETPLACE - Marketplace와 FBE를 통합하기 위한 플로입니다. FBE 설정 플로에서 페이지와 비즈니스 관리자 단계만 필요하고 FBE 관리 보기에서 협력 광고를 설정해야 하는 파트너에게 추천합니다.
  • SIGNALS - 사용자가 Facebook 픽셀과 전환 API 이벤트를 실행하는 플로입니다. 이 플로는 Facebook 카탈로그를 자산으로 지원하지 않습니다. 웹사이트 호스팅 기능이 있고 카탈로그 기능이 없는 파트너에게만 추천합니다.

FBE 비즈니스 로그인 중에 페이지를 선택할 때 발생할 수 있는 일반적인 시나리오 몇 가지는 아래와 같습니다. FBE 플로의 툴팁에서 자산을 선택할 수 없는 정확한 이유를 설명합니다. 이유는 시나리오별로 다를 수 있습니다.

페이지를 선택할 수 있는 경우:

  • 선택한 페이지를 소유한 비즈니스 관리자가 없다면 플로에서 선택한 비즈니스 관리자에서 페이지를 소유하게 됩니다.
  • 선택한 페이지를 다른 비즈니스 관리자가 소유하지만 해당 비즈니스 관리자의 기본 페이지가 아닐 경우, 플로에서 선택한 비즈니스 관리자에게로 이전됩니다.

페이지를 선택할 수 없는 경우:

  • 페이지를 다른 비즈니스 관리자가 소유하고 해당 비즈니스 관리자의 기본 페이지인 경우
  • 정책 위반 등의 이유로 비활성화된 비즈니스 관리자가 페이지를 소유한 경우

파트너는 앱에 대해 Page Public Metadata Access 기능을 요청하고 앱에서 페이지 공개 필드를 쿼리할 수 있습니다. 이 기능에 대한 자세한 내용은 이 문서여기에서 참조하세요.

instagram_profiles 필드가 포함되지 않았다면 Instagram과 관련된 권한(예: instagram_basic)이 액세스 토큰에 포함되지 않았거나, 비즈니스가 FBE로 Instagram 비즈니스 프로필을 연결하지 않았다는 의미입니다. FBE 설치 API에 대한 자세한 내용은 이 문서를 참조하세요.

즉, 앱에서 일부 권한이 빠지게 됩니다. 비즈니스 관리자와 관련된 작업에 필요한 기본 권한은 business_management입니다.

JMD, BGN, BYN, UAH, KIP, LKR을 제외하고 이 리스트에 있는 통화 대부분을 지원합니다.

경고: 지원되지 않는 통화를 로그인 URL 구성 설정에 입력할 경우 FBE 설치가 실패합니다. 판매자는 FBE 시작을 허용하기 전에 판매자가 지원되는 통화를 사용하는지 확인하는 것이 좋습니다.

Facebook 비즈니스 페이지나 Instagram 비즈니스 프로필에 대한 관리자 액세스 권한뿐만 아니라 현재 FBE 연결과 관련된 Facebook 비즈니스 관리자에도 관리자 액세스 권한이 있어야 합니다. Facebook 비즈니스 관리자에 관리자를 추가하는 방법은 이 지침을 참조하세요.

테스트

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

  1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

  2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

문제 해결

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

일반

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

This is a closed beta. Please reach out to your Meta partner manager for more information.

카탈로그

Facebook Business 확장 프로그램(FBE) v2는 카탈로그를 사용하여 비즈니스 인벤토리를 가져옵니다. 이 기능은 여러 가지 기능(예: 다이내믹 광고, Shops, 페이지 서비스 카드)을 지원하는 데 사용합니다. 통합에서는 선택 가능한 부분이지만 특정 기능에는 필수입니다.

자세한 구현 정보와 지원되는 필드는 FBE 카탈로그 API 문서를 참조하세요.

앱은 라이브 모드로 전환하기 전에 앱 검수를 통해 카탈로그 권한(catalog_management)을 승인 받아야 합니다.

비즈니스 로그인 구현에서 범위 매개변수에 catalog_management 권한을 추가합니다. 그러면 앱에서 비즈니스 소유 카탈로그를 생성하고, 읽고, 업데이트하고, 삭제할 수 있습니다.

스크린캐스트에서 다음과 같은 방법을 보여주는 작동하는 데모가 준비되는 즉시 앱 검수 요청을 제출합니다.

  • 등록 플로에서 카탈로그 권한을 요청합니다.
  • 인벤토리는 연결된 카탈로그로 푸시됩니다.
  • 카탈로그를 지원하는 기능은 카탈로그가 동기화된 후에 활성화됩니다.

앱 검수 팀에서는 제공 받은 지침과 스크린캐스트를 사용하여 앱의 카탈로그용 Facebook 통합을 테스트하고 검증합니다. 승인이 거부된 경우 제공된 피드백을 잘 읽고 이유를 파악하세요. 검수자에게 더욱 자세한 정보를 제공하도록 업데이트하여 검수자에게 다시 제출해야 합니다.

앱 검수를 성공적으로 통과하는 방법과 Facebook 파트너에게 거절에 대해 알리고, 앱 검수 거부 가이드에서 추가적인 지원을 받는 방법에 대한 팁을 확인하세요.

자산 선택은 서로 연결되어 있고 자격 요건을 충족하지 못하는 데는 여러 가지 이유가 있습니다. 예를 들어 다음과 같은 이유가 있습니다.

  • 해당 페이지가 이미 다른 카탈로그와 연결되어 있는 경우
  • 카탈로그가 다른 상거래 계정과 연결된 경우
  • 카탈로그를 테스트 앱과 사용하고 프로덕션에 해당 카탈로그를 사용할 수 없는 경우

마이그레이션

FBE 2.0에서 Facebook 페이지 또는 Instagram 비즈니스 프로필은 2개 이상의 파트너 플랫폼(앱 ID 기반)에 연결할 수 있습니다. 그러나 같은 프로필은 특정 파트너 플랫폼에 한 번만 연결할 수 있습니다.

아니요. Messenger 채팅의 경우 파트너 플랫폼은 비즈니스 로그인에서 business_configmessenger_chat을 설정하여 활성화할 수 있습니다. 페이지 샵의 경우 마이그레이션이 끝나고 비즈니스/판매자가 관리 보기에서 활성화해야 합니다.

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

플러그인

아니요. 현재 이 두 가지 플러그인은 FBE 관리 보기에서 사용 중단되었습니다. 2021년부터는 Messenger 채팅 플러그인만 지원됩니다.

Messenger 허용 리스트에 등록된 도메인은 HTTPS가 필요합니다. 파트너는 프로토콜 ID로 도메인 필드 URL(https://)을 검증해야 합니다.

FBEMessengerChatConfigData 개체를 구성하는 방법에 대해 자세히 알아보세요.

파트너는 Messenger 도메인이 유효한지 비교적 쉽게 확인할 수 있고 비즈니스/판매자가 도메인을 설정하는 번거로움이 없습니다. 파트너는 FBE 비즈니스 로그인의 business_config에서 messenger_chat.domains를 설정하고 messenger_chat.enabled=false를 설정할 수 있습니다.

비즈니스/판매자가 나중에 관리 보기에서 Messenger 플러그인을 활성화하거나 파트너 쪽에서 비즈니스/판매자가 기능 구성 API를 통해 설정할 수 있는 경로를 제공할 수 있습니다.

통합 검수

통합 검수는 Facebook이 FBE 통합을 인증하는 프로세스입니다. 앱의 통합 검수가 성공하면 앱이 일반 사용자(즉, 비즈니스 사용자와 판매자)에게 제공됩니다.

모든 요구 사항을 구현한 뒤에 앱의 FBE 개발자 패널 > 개요 탭에서 통합 검수를 요청할 수 있습니다. 검수 절차를 신속하게 진행하려면 구현한 모든 FBE 기능이 작동하는 전체적 데모 동영상을 검수자 또는 FB 담당자와 공유해야 합니다.

앱이 검수를 성공적으로 통과할 때까지 앱 관리자와 개발자만 FBE 플로를 시작할 수 있습니다.

Please reach out to your Meta partner manager, or submit a new integration review.

SDK/API/Webhook/모바일

예, FBE는 모바일 브라우저에서 지원되고 네이티브 Android/iOS 앱을 통해 Webviews를 사용하여 시작할 수 있습니다. 모바일에서 FBE를 시작하는 방법에 대해 자세히 알아보세요.

그래프 API 호출을 보내려면 액세스 토큰이 필요합니다. 액세스 토큰의 각 유형은 여기에 나와 있습니다.

Facebook 로그인을 호출하여 access_token을 가져오고 나서 관리 보기를 호출한 다음, access_token을 사용해 기능 구성 API를 호출할 수 있습니다.

샘플 코드:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

Shops

오프사이트 또는 사이트 내 플로에서 Instagram 쇼핑을 사용하려면 Instagram 비즈니스 계정이 필요합니다. 개인 Instagram 계정은 사용할 수 없습니다. Instagram 비즈니스 계정에 프레즌스가 설정되어 있지 않거나 해당 계정에서 요건을 충족하는 상품을 판매하지 않는 경우, 그 계정은 자격 요건을 충족하지 못할 수 있습니다. 6개월 이내에 다시 인증을 요청할 수 있습니다. 자격 요건을 참조하세요.

상거래 계정은 오프사이트 매장이거나 사이트 내 매장입니다. 사이트 내 매장을 오프사이트 매장으로 전환할 수 있고 그 반대도 가능합니다. 비즈니스에서 오프사이트 매장과 사이트 내 매장이 모두 필요한 경우 자산별로 두 가지 등록 플로가 필요합니다.

자산 선택은 서로 연결되어 있고 자격 요건을 충족하지 못하는 데는 여러 가지 이유가 있습니다. 예를 들어 다음과 같은 이유가 있습니다.

  • 사용자가 페이지를 소유한 비즈니스의 관리자가 아닌 경우
  • 페이지가 다른 비즈니스 관리자와 연결된 경우

문의하기

비즈니스 관리자의 기술 지원 도구를 사용하여 지원팀에게 직접 도움을 받으세요.

  • 예약 및 음식 주문 파트너: 서비스용 Facebook Business 확장 프로그램 주제를 사용하세요.
  • 상거래 파트너: 마케팅 파트너: 기술 지원 주제를 사용하거나 Facebook 파트너 관리자에게 직접 문의하세요.

기술 지원 드롭다운 메뉴에서 찾는 주제가 보이지 않을 경우, 액세스용 이메일을 통해 Facebook 파트너 관리자 담당자에게 문의하세요.

기술 지원은 비즈니스 관리자와 긴밀히 통합되어 있습니다. 기술 지원 도구를 사용하여 회사 사용자로서 질문과 버그를 제출할 모든 팀원을 비즈니스 관리자에 추가하세요. 자세한 방법은 이 지침을 참조하세요.

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.