Meta Business 확장 도구

FBE Marketplace 등록

Facebook Business 확장 기능(FBE)을 사용하면 기존 Facebook 자산(예: Facebook 페이지, 비즈니스 관리자)과 같은 기존 Facebook 자산을 연결하거나 완전히 새로운 자산을 만들어서 Facebook 앱 패밀리에 광고를 쉽게 게재할 수 있습니다. FBE를 통해 Meta 솔루션에 Marketplace 판매자를 원활하게 등록할 수 있습니다.

Marketplace 플로의 주요 단계는 아래와 같습니다. 기본 개발자 문서와 함께 이 단계를 사용하는 것이 좋습니다.

FBE Marketplace 플로

파트너 = Marketplace

FBE = Facebook Business 확장 기능(Facebook 소유 UI)


시작하기 전에

  1. 앱은 인증된 비즈니스의 비즈니스 관리자가 소유해야 합니다. 비즈니스를 인증하는 방법에 대해 자세히 알아보세요.
  2. Facebook 앱은 앱 검수에서 다음의 권한을 승인받아야 합니다.

  • 비공개 권한

    1. manage_business_extension — Meta 담당자가 앱을 허용 리스트에 추가해야 하는 비공개 권한입니다. Meta 담당자에게 연락하여 도움을 받으세요.

  • 공개 권한(Marketplace는 앱 검수를 통해 권한을 요청해야 함)

    1. business_management — FBE를 통해 생성된 비즈니스 관리자 ID를 가져오고 비즈니스 관리자 API를 사용해서 비즈니스 자산을 관리하는 데 필요합니다.
    2. ads_management — 고객을 대신해 판매자 광고를 관리하는 데 필요합니다.

FBE 및 협력 광고 API의 주요 단계

  • 판매자(브랜드)가 Marketplace 웹사이트를 통해 FBE 설정 팝업 화면을 시작합니다.
  • 판매자가 FBE 등록 플로를 거치고 핵심 자산(예: 비즈니스 관리자, 페이지)의 설정을 완료합니다.
  • FBE에서 (API 또는 Webhooks를 통해) 판매자가 성공적으로 설정한 자산 ID를 반환합니다. Marketplace가 ID를 수신하면 API 또는 UI(비즈니스 관리자의 협력 센터 도구 사용)에서 카탈로그 세그먼트를 생성/공유할 수 있습니다.
  • 판매자가 FBE 관리 뷰를 시작합니다. 여기에서 생성된 카탈로그 세그먼트 상태를 확인하고, (판매자가 처음으로 Marketplace에서 카탈로그 세그먼트 요청을 수신한 경우) 서비스 약관에 동의합니다.
  • Marketplace가 판매자를 광고 생성 플로(예: 기존 생산자 플로 - 광고 관리자)로 리디렉션합니다.

필수 구성

Extras

필드유형설명

setup

설정

필수 항목

고유한 식별자(external_business_id) 또는 카탈로그의 통화(currency)와 같은 판매자의 Facebook 설정입니다. 설정 개체 상세 정보를 참조하세요.

business_config

business_config

필수 항목

Facebook Business 확장 프로그램은 Facebook Business 확장 프로그램 워크플로를 구성하는 데 사용하는 구성 개체입니다. business_config 개체 상세 정보를 참조하세요.

repeat

부울

필수 항목

이 값을 false로 설정합니다.

설정

필드설명

external_business_id
유형: 문자열

필수 항목.
클라이언트의 비즈니스를 대표하는 고유 비즈니스 ID입니다. 이를 고유한 식별자로 사용합니다. 예를 들어 판매자의 회사가 'Fubar'라면 'fubar-123'은 external_business_id가 될 수 있습니다.

timezone
유형: 문자열

필수 항목.
비즈니스가 위치한 시간대입니다. 사용 가능한 시간대 값을 참조하세요.

currency
유형: 문자열

필수 항목.
비즈니스의 카탈로그 항목에서 사용한 기본 통화의 세 글자 ISO 통화 코드입니다. 지원되는 통화 코드를 참조하세요.

business_vertical
유형: enum

필수 항목.
비즈니스와 관련된 업종. Marketplace의 경우 ECOMMERCE입니다.

merchant_settings_id
유형: 문자열

선택 사항.
Facebook Business 확장 기능, v1에서 업그레이드할 때 사용합니다. v1에서 v2로 마이그레이션할 경우에는 Facebook 담당자에게 문의하세요.

channel
유형: enum

필수 항목.
파트너가 추가적인 단계나 제한이 필요한 기능과 관련하여 사용자에 대한 의도를 표현하는 경로를 제공합니다.


참고: Marketplace FBE 플로의 channel은 MARKETPLACE입니다. channel 필드에서 이를 전달해야 합니다.

business_manager_id
유형: 문자열

선택 사항.
파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 비즈니스 관리자에 대한 비즈니스 관리자 ID.

page_id
유형: 문자열

선택 사항.
파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 Facebook 페이지에 대한 페이지 ID.

Business Config

이 개체를 사용하여 최종 사용자에 대한 비즈니스 설정을 구성합니다. 여기에는 Messenger 등이 포함됩니다. 각 필드에는 아래의 각 테이블과 링크된 'type'이 포함됩니다.

필드설명

business
FBEBusinessPropertiesConfigData

필수 항목.
최종 사용자 비즈니스의 정보.

messenger_chat
FBEMessengerChatConfigData

선택 사항.
최종 사용자 Facebook 페이지의 Messenger 채팅 기능(예: enabled, domains).

catalog_feed_scheduled
FBECatalogFeedConfigData

선택 사항.
Facebook Business 확장 기능이 피드 방식(feed_url에서 카탈로그 항목을 가져오는 방식)을 사용할지 결정합니다.

page_cta
FBEPageCtaConfigData

선택 사항.
최종 사용자 페이지의 행동 유도(CTA) 버튼(예: cta_button_text, cta_button_url).

ig_cta
FBEIGCtaConfigData

선택 사항.
Instagram 행동 유도 기능(예: enabled, cta_button_text, cta_button_url).

messenger_menu
FBEMessengerMenuConfigData

선택 사항.
Messenger 고정 메뉴 기능(예: cta_button-text, cta_button_url).

설치 후

FBE 설정이 완료된 후 FBE 관리 보기가 시작되고 자산 ID가 Webhooks/API를 통해 성공적으로 반환됩니다.