판매자 온보딩

이 페이지에서는 판매자 비즈니스 생성 API를 사용하여 판매자를 Facebook 담당자가 지정되어 있는 파트너 광고(MPA)에 온보딩하는 방법에 관한 지침을 제공합니다.

판매자 자격 요건 API를 사용하여 판매자를 MPA에 온보딩할 수 있는지 확인하고 나면 판매자 비즈니스 생성 API를 사용하여 판매자를 온보딩합니다.

적격 판매자의 vendor_id를 사용하여 판매자 비즈니스 생성 API를 호출하면 다음과 같은 작업이 자동으로 수행됩니다.

하위 비즈니스 관리자, Facebook 페이지, 판매자 광고 계정을 만듭니다.
크레딧 라인을 공유합니다.
vendor_id=<child_business_external_id>를 필터로 사용하여 판매자의 카탈로그 세그먼트를 설정합니다.

MPA에 판매자를 온보딩하고 나면 해당 판매자는 Facebook 담당자가 지정되어 있는 파트너로 간주됩니다.

시작하기 전에

판매자를 온보딩하기 전에 다음 단계를 완료하세요.

필수 권한

판매자 비즈니스 생성 API를 호출하려면 다음과 같은 권한이 필요합니다.

비즈니스 관리자
카탈로그 관리자
크레딧 관리
앱 개발자

판매자 비즈니스 생성 API 호출

요청

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "POST", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses", 
        "name": "<ASYNC_SESSION_NAME>", 
        "body": "child_business_external_id=<VENDOR_ID>&line_of_credit_id=<LINE_OF_CREDIT_ID>&credit_limit=<CREDIT_LIMIT>&partition_type=<PARTITION_TYPE>&catalog_id=<PARENT_CATALOG_ID>&ad_account_currency=<AD_ACCOUNT_CURRENCY>&seller_targeting_countries=['COUNTRY_CODE1','COUNTRY_CODE2']&timezone_id=<TIMEZONE_ID>&name=<BUSINESS_MANAGER_NAME>&seller_external_website_url=<SELLER_EXTERNAL_WEBSITE_URL>&partner_facebook_page_url=<PARTNER_FACEBOOK_PAGE_&page_profile_image_url=<PROFILE_PIC_URL>&vertical=<VERTICAL>&partner_registration_countries=<PARTNER_REGISTRATION_COUNTRY>"
      } 
  ]' \
  "https://graph.facebook.com/v21.0"

API 호출에 대한 응답은 ASYNC_SESSION_ID와 함께 즉시 반환됩니다. 요청을 계속 처리하는 동안 터미널 상태 [COMPLETED|FAILED]에 도달할 때까지 ASYNC_SESSION_ID를 폴링해야 합니다.

매개변수

이름	설명
`ad_account_currency` 문자열	필수 항목. 판매자에 대해 생성할 광고 계정의 통화입니다. 문자열은 통화 약어로 입력해야 합니다. 월간 인보이스 작성에 허용된 통화를 참조하세요.
`catalog_id` 숫자 문자열	필수 항목. Marketplace 카탈로그의 ID이며, 상위 카탈로그로 지칭됩니다. 온보딩 중에 이 카탈로그는 판매자를 위한 카탈로그 세그먼트를 만들기 위해 `vendor_id=<child_business_external_id>`를 사용하여 필터링될 수 있습니다.
`child_business_external_id` 문자열	필수 항목. 각 Marketplace는 각 판매자에 대해 고유한 ID를 전달해야 합니다. Marketplace 측 필드의 이름은 `vendor_id`입니다. 이 필드는 `vendor_id = <child_business_external_id>` 필터를 사용하여 카탈로그 세그먼트를 만드는 데 사용됩니다.
`credit_limit` 숫자 문자열	필수 항목. main line_of_credit_id에서 판매자에게 공유될 최대 크레딧 금액입니다. `partition_type` 값이 `FIXED`로 설정된 경우에만 설정해야 합니다. 조건:`line_of_credit_id`의 사용 가능한 크레딧이 요청한 `credit_limit` 이상이어야 합니다.
`partition_type` enum 문자열	필수 항목. 다음 값 중 하나로 설정합니다. `FIXED` `AUTH` 기본값:`FIXED` 고정 파티션 또는 제한되지 않은 크레딧 파티션입니다. `partition_type` 값이 `AUTH`로 설정된 경우 `credit_limit` 매개변수에 설정된 값은 무시됩니다.
`line_of_credit_id` 숫자 문자열	필수 항목. 판매자에게 크레딧을 공유할 수 있는 기본 크레딧 라인의 ID입니다. 조건: `credit_limit` 및 `ad_account_currency` 매개변수를 전달합니다. `no_ad_account`를 전달할 수 없습니다.
`marketplace_bm_id` 문자열	필수 항목. Marketplace의 비즈니스 관리자 ID입니다. 자세한 내용은 Meta 비즈니스 관리자에서 비즈니스 ID 찾기를 참조하세요.
`name` 문자열	필수 항목. 판매자에 대해 생성된 고유한 비즈니스 관리자 이름입니다.
`skip_partner_page_creation` 부울	선택 사항. 판매자의 페이지를 만드는 단계를 건너뛰려면 `true`로 설정합니다. 기본값:`false`
`page_name` 문자열	선택 사항. 판매자에 대해 생성한 페이지에 할당할 이름입니다. `skip_partner_page_creation`이 `true`로 설정되어 있으면 이 매개변수 설정을 건너뛰세요. 조건: 페이지 이름은 Facebook 페이지 이름 요구 사항을 준수해야 합니다. 기본값: 협력 센터에서 Facebook 담당자가 지정되어 있는 파트너 광고 API 온보딩을 진행하는 중에 구성된 파트너의 Facebook 페이지 이름입니다.
`page_profile_image_url` 문자열	선택 사항 판매자 페이지 프로필 사진의 이미지를 가져올 URL입니다. `skip_partner_page_creation`이 `true`로 설정되어 있으면 이 매개변수 설정을 건너뛰세요. 조건: 이미지 크기: 180 * 180픽셀 이상 이미지 크기: 1MB 미만 기본값: 협력 센터에서 Facebook 담당자가 지정되어 있는 파트너 광고 API 온보딩을 진행하는 중에 구성된 파트너의 Facebook 페이지 프로필 사진입니다.
`seller_external_website_url` 문자열	필수 항목. 판매자의 웹사이트 URL입니다.
`seller_targeting_countries` list<string>	필수 항목. 판매자의 타게팅 국가가 포함된 문자열 배열입니다. 값은 국가 이름이 아니라 국가 번호입니다. 광고를 만들 때 광고 세트의 기본 타게팅 국가로 사용됩니다. 국가 번호를 참조하세요.
`partner_facebook_page_url` 문자열	선택 사항. 판매자의 Facebook 페이지 URL입니다.
`partner_registration_countries` 문자열	필수 항목. 판매자의 비즈니스가 등록된 국가입니다. 값은 국가 이름이 아니라 국가 번호입니다. 국가 번호를 참조하세요.
`timezone_id` 숫자 문자열	필수 항목. 비즈니스/광고 계정의 시간대 ID입니다. 시간대 ID를 참조하세요.
`vertical` enum 문자열	필수 항목. 다음 중 한 개 값으로 설정합니다. `ADVERTISING` `AUTOMOTIVE` `CONSUMER_PACKAGED_GOODS` `ECOMMERCE` `EDUCATION` `ENERGY_AND_UTILITIES` `ENTERTAINMENT_AND_MEDIA` `FINANCIAL_SERVICES` `GAMING` `GOVERNMENT_AND_POLITICS` `MARKETING` `ORGANIZATIONS_AND_ASSOCIATIONS` `PROFESSIONAL_SERVICES` `RETAIL` `TECHNOLOGY` `TELECOM` `TRAVEL` `OTHER`

응답

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

ASYNC_SESSION_ID를 사용하여 Facebook 담당자가 지정되어 있는 파트너 광고에 온보딩된 판매자의 해당 ID를 가져옵니다.

자세한 내용은 응답을 얻기 위해 비동기식 세션을 폴링하는 방법을 참조하세요.

성공 응답

상태가 COMPLETED일 경우 비동기식 세션을 폴링한 후의 결과 데이터는 다음과 같습니다.

{
  "result": "{\"id\":\"<NEWLY_CREATED_MANAGED_PARTNER_BM_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

실패 응답

상태가 FAILED일 경우 비동기식 세션을 폴링한 후의 결과 데이터는 다음과 같습니다.

오류 코드

판매자 온보딩 API로 보낸 요청의 결과로 여러 가지 오류 응답이 반환될 수 있습니다. 자세한 내용은 오류를 처리하는 방법을 참조하세요.

오류 코드	오류 하위 코드	오류 메시지
1800000	2310114	협력 센터에서 Facebook 담당자가 지정되어 있는 파트너 광고 온보딩 프로세스를 완료하세요.
1800001	2310118	공급업체 ID {vendor_id}이(가) 이미 사용 중입니다. 다른 곳에서 사용되지 않는 고유한 공급업체 ID를 입력하세요.
1800002	2310138	비즈니스 이름 {invalid_business_name}이(가) 유효한 이름이 아닙니다. 대신 {suggested_business_name}을(를) 사용하는 것이 좋습니다. 비즈니스 이름은 Facebook의 비즈니스 이름 요구 사항을 준수해야 합니다.
1800002	2310139	비즈니스 이름 {invalid_business_name}이(가) 유효한 이름이 아닙니다. 비즈니스 이름은 Facebook의 비즈니스 이름 요구 사항을 준수해야 합니다.
1800003	2310133	이 파트너 비즈니스에 유효한 등록 국가 번호를 입력하세요.
1800004	2310127	파트너 등록 국가에 대해 나열된 유효하지 않은 국가 번호([{invalid_registration_country_codes}])를 삭제하거나 업데이트하세요.
1800006	2310141	잘못 입력된 국가 번호([{invalid_targeting_country_codes}])를 삭제하거나 업데이트하세요.
1800100	2310117	입력한 카탈로그 ID({catalog_id})를 사용하여 카탈로그 세그먼트를 만들 수 없습니다. 커머스 관리자로 이동하여 이 파트너의 품목이 포함된 올바른 카탈로그 ID 번호를 찾을 수 있습니다. 올바른 카탈로그 ID로 파트너 온보딩을 다시 시도하세요.
1800101	2310116	비즈니스 {business_id}에서는 입력한 카탈로그 ID({catalog_id})를 관리하지 않습니다. 비즈니스에서 관리하는 카탈로그 ID를 입력하세요.
1800102	2310115	입력한 카탈로그 ID({catalog_id})를 확인하세요. ID가 정확하고 이 카탈로그에 액세스해야 하는 경우, 전체 관리 권한이 있는 사람에게 비즈니스 관리자의 비즈니스 설정으로 이동하여 액세스 권한을 달라고 요청하세요. 액세스 권한이 할당되면 파트너 온보딩을 다시 시도하세요.
1800200	2310119	파트너에게 크레딧을 공유하는 데 사용할 크레딧 라인 ID를 입력하세요.
1800201	2310144	입력한 크레딧 라인 ID({line_of_credit_id})가 인보이스 작성 계정이 아니거나 크레딧 라인 ID가 아닙니다. 비즈니스 ID({marketplace_business_id})와 연결된 크레딧 라인 ID를 입력하세요. 비즈니스가 파트너에게 크레딧을 공유하는 데 사용하는 크레딧 라인이어야 합니다.
1800202	2310122	입력한 크레딧 라인 ID({line_of_credit_id})를 확인하세요. ID가 정확하고 액세스 권한이 필요한 경우, 비즈니스 관리자 설정으로 이동하여 전체 관리 권한이 있는 사람에게 자금을 관리하기 위한 액세스 권한을 달라고 요청하세요. 자금 관리를 위한 액세스 권한을 받은 후 파트너 온보딩을 다시 시도하세요.
1800203	2310123	비즈니스({business_id})가 입력한 크레딧 라인({line_of_credit_id})을 관리하지 않습니다. 비즈니스에서 관리하는 인보이스 작성 계정 또는 크레딧 라인 ID를 입력하세요.
1800204	2310120	광고 계정의 통화를 입력하세요. 이 정보는 나중에 변경할 수 없습니다.
1800205	2310145	크레딧 라인 ID({line_of_credit_id})가 입력한 통화({ad_account_currency})를 지원하지 않습니다. 파트너 광고 계정 통화를 크레딧 라인에서 지원하는 통화로 업데이트하세요.
1800206	2310121	0보다 큰 크레딧 한도 금액을 입력하세요.
1800207	2310143	입력한 크레딧 한도(${credit_limit})가 사용 가능한 크레딧 잔액(${available_credit})보다 큽니다. 할당된 크레딧 한도를 낮추거나 잔액이 더 많은 다른 크레딧 라인 ID를 사용하세요.
1800305	2310149	파트너 프로필 사진의 이미지 URL을 입력하세요. 이미지는 180 x 180픽셀 이상이고 1MB 미만이어야 합니다.
1800306	2310150	이미지는 180 x 180픽셀 이상이고 1MB 미만이어야 합니다. 이미지 크기와 URL {page_profile_image_url}을(를) 확인하고 다시 시도하거나 새 이미지 URL을 입력하세요.
1800306	2310151	링크({page_profile_image_url})를 확인하거나 새 링크를 입력하세요.
1800307	2310148	이미지 URL({page_profile_image_url})을 처리하는 중에 시스템에서 시간이 초과되었습니다. 이미지 URL을 확인하고 요청을 다시 시도하거나 새 이미지 URL을 입력하세요.
1800311	2310181	페이지 이름({invalid_page_name})이 유효한 이름이 아닙니다. 대신 {suggested_page_name}을(를) 사용하는 것이 좋습니다. 페이지 이름은 Facebook의 페이지 이름 요구 사항을 준수해야 합니다.
1800311	2310182	페이지 이름({invalid_page_name})이 유효한 이름이 아닙니다. 페이지 이름은 Facebook의 페이지 이름 요구 사항을 준수해야 합니다.