MBE 픽셀 및 전환 API 온보딩

Meta Business 확장 도구의 픽셀 및 전환 API 플로를 사용하는 사용자는 비즈니스 관리자, 페이지, Meta 픽셀을 만들거나 선택할 수 있습니다. 이 플로는 웹사이트 호스팅 기능이 있는 파트너에게 추천합니다. 파트너는 이 플로를 완료한 이후 반환되는 픽셀을 사용하여 브라우저나 전환 API를 통해 고객을 대신해 Facebook으로 이벤트를 전송할 수 있습니다. 이 플로는 카탈로그 기능이 없습니다.

시작하기 전에

앱은 인증된 비즈니스의 비즈니스 관리자가 소유해야 합니다. 비즈니스를 인증하는 방법에 대해 자세히 알아보세요.
Facebook 앱은 다음의 액세스 레벨, 기능 및 권한이 필요합니다.
- 액세스 레벨: 고급 액세스
- 기능: 광고 관리 표준 액세스
- 공개 권한: ads_management, pages_read_engagement 및 ads_read
- 비공개 권한: manage_business_extension — Facebook 담당자가 앱을 허용 리스트에 추가해야 하는 비공개 권한입니다.
- 시스템 사용자 액세스 토큰: 전환 API로 이벤트를 보내려면 액세스 토큰이 필요합니다. 고객을 대신해 액세스 토큰을 생성하려면 FBE에서 반환된 액세스 토큰으로 추가적 API 호출을 보내 시스템 사용자 액세스 토큰으로 변환합니다.

필수 구성

Extras

필드 유형 설명

필드	유형	설명
`setup`	설정	필수 항목 고유한 식별자(`external_business_id`) 또는 카탈로그의 통화(`currency`)와 같은 판매자의 Facebook 설정입니다. 설정 개체 상세 정보를 참조하세요.
`business_config`	business_config	필수 항목 Facebook Business 확장 프로그램은 Facebook Business 확장 프로그램 워크플로를 구성하는 데 사용하는 구성 개체입니다. `business_config` 개체 상세 정보를 참조하세요.
`repeat`	부울	필수 항목 이 값을 `false`로 설정합니다.

setup

설정

필수 항목

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

business_config

business_config

필수 항목

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

repeat

부울

필수 항목

이 값을 false로 설정합니다.

설정

이 개체를 사용하여 최종 사용자의 Facebook 프레즌스 설정을 정의합니다.

필드	설명
`external_business_id` 문자열	필수 항목 클라이언트의 비즈니스를 대표하는 고유한 비즈니스 ID. 이를 고유한 식별자로 사용합니다. 예를 들어 판매자의 회사가 'Fubar'라면 'fubar-123'은 `external_business_id`가 될 수 있습니다.
`timezone` 문자열	선택 사항 비즈니스가 위치한 시간대. 사용 가능한 시간대 값을 참조하세요.
`currency` 문자열	선택 사항 비즈니스 카탈로그 항목에 사용한 기본 통화의 세 글자 ISO 통화 코드. 지원되는 통화 코드를 참조하세요.
`business_vertical` enum	필수 비즈니스와 관련된 업종 값:`ECOMMERCE`
`merchant_settings_id` 문자열	선택 사항 Facebook Business 확장 프로그램 v1에서 업그레이드할 때 사용합니다. v1에서 v2로 마이그레이션할 경우에는 Facebook 담당자에게 문의하세요.
`domain` 문자열	필수 항목(COMMERCE 및 COMMERCE_OFFSITE 채널의 경우) Instagram 수동 승인에 사용하는 도메인입니다. 예: `https://exampleshop.partnersite.com`.
`channel` enum	필수 파트너가 FBE의 전환 API 플로를 구성하기 위한 경로를 제공합니다. 전환 API 플로의 경우, 이 값은 `CONVERSIONS_API`가 되어야 합니다. `CONVERSIONS_API` — 최종 사용자가 비즈니스 관리자, 광고 계정, Meta 픽셀 개체를 만들거나 선택할 수 있는 플로입니다. 이들 개체를 만들면 최종 사용자가 전환 API나 브라우저 픽셀을 통해 웹사이트에서 Facebook으로 이벤트를 전송할 수 있습니다.
`business_manager_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 비즈니스 관리자에 대한 비즈니스 관리자 ID
`ad_account_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 광고 계정에 대한 광고 계정 ID
`page_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 Facebook 페이지에 대한 페이지 ID
`ig_profile_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 Instagram 비즈니스 프로필에 대한 Instagram 비즈니스 프로필 ID
`pixel_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 픽셀에 대한 픽셀 ID
`catalog_id` 문자열	선택 사항 파트너가 설정 플로에서 사용자 대신 미리 선택할 수 있는 사용자의 기존 카탈로그에 대한 카탈로그 ID

Business Config

이 개체를 사용하여 최종 사용자의 비즈니스 설정을 구성합니다. CTA 등이 포함됩니다. 각 필드에는 아래의 각 테이블과 링크된 '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 행동 유도(CTA) 기능(예: `enabled`, `cta_button_text`, `cta_button_url`)입니다.
`messenger_menu` 유형: FBEMessengerMenuConfigData	선택 사항 Messenger 고정 메뉴 기능(예: `cta_button-text`, `cta_button_url`)입니다.