광고 캠페인 생성 및 게재

이 페이지에서는 Facebook 담당자가 지정되어 있는 파트너 광고에 온보딩한 Facebook 담당자가 지정되어 있는 파트너(판매자)를 위해 광고 캠페인을 만드는 단계를 제공합니다.

시작하기 전에

파트너를 위한 광고 캠페인을 만들고 게재하기 전에 다음 단계를 완료해야 합니다.

필수 권한

판매자 광고 생성 API를 호출하려면 사용자에게 다음 권한이 필요합니다.

판매자 비즈니스 관리자

DSA 규제를 받는 위치(유럽 연합) 타게팅

유럽 연합(EU) 및/또는 관련 영토를 타게팅하는 광고 캠페인의 경우, dsa_payor 및 dsa_beneficiary 필드가 필수입니다. 이러한 2개의 필드에서 제공한 정보는 최종 사용자에게 표시되어 누가 광고 비용을 지불하고 누가 광고의 수익 주체인지 나타냅니다.

유럽 연합 및 관련 영토를 타게팅하는 모든 캠페인의 경우, 광고 수익 주체 및 지불 주체 정보를 반드시 입력해야 합니다. 이러한 필드를 제공하지 않는 경우, 광고주는 MPA 캠페인을 생성할 수 없고 API는 아래에 나열된 오류 코드와 함께 실패 응답을 반환합니다.

판매자 광고 생성 API 호출

요청

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

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

매개변수

이름	설명
`conversion_domain` 문자열	필수 항목. 광고 생성 플로에서 전환 도메인을 설정합니다. `conversion_domain` 필드는 Meta 픽셀 구성과 일치해야 합니다. 이 필드는 전체 URL이 아니라 첫 번째 및 두 번째 수준 도메인만 포함해야 합니다. 예를 들면 facebook.com입니다.
`custom_event_type` enum	선택 사항. 잠재 고객 발굴 및 리타게팅 광고에서 최적화할 대상인 앱 이벤트입니다. 값:`CONTENT_VIEW`, `ADD_TO_CART`, `PURCHASE` 조건:`use_marketplace_template`이 `true`이고 `use_seller_template`이 `false`인 경우에만 이 필드를 지정할 수 있습니다.
`dsa_payor` 문자열(최대 512자)	선택 사항. 캠페인의 지불 주체입니다. 참고: 이 필드는 유럽 연합 및/또는 관련 영토를 타게팅하는 캠페인에 필수입니다.
`dsa_beneficiary` 문자열(최대 512자)	선택 사항. 캠페인의 수익 주체입니다. 참고: 이 필드는 유럽 연합 및/또는 관련 영토를 타게팅하는 캠페인에 필수입니다.
`end_time` datetime	필수 항목. 광고 캠페인의 종료 시간입니다(UTC UNIX 타임스탬프 기준).
`lifetime_budget` 숫자 문자열	필수 항목. 광고 계정 통화 기준의 캠페인 예산입니다. 광고 분야에서는 오프셋이 1 또는 100일 수 있습니다(센트 개념이 있는 통화의 경우). 예를 들어 USD에서 `lifetime_budget = 1`(오프셋: 100)은 1/100(오프셋) = $0.01(1센트)를 의미합니다. JPY에서 `lifetime_budget = 1`(오프셋: 1)은 1/1(오프셋) = ¥1(1엔)을 의미합니다.
`override_creative_text` 문자열	필수 항목. 크리에이티브의 본문입니다.
`override_targeting_countries` list<strings>	선택 사항. 캠페인에서 타게팅하는 국가입니다. 이는 잠재 고객 발굴 및 리타게팅 광고에서 판매자 비즈니스 생성 중에 설정된 국가를 재정의합니다.
`product_set_id` 숫자 문자열	선택 사항. 이 캠페인이 모든 광고에서 홍보하고자 하는 판매자 제품 카탈로그 내의 제품 세트 ID입니다.
`start_time` datetime	필수 항목. 광고 캠페인의 시작 시간입니다(UTC UNIX 타임스탬프 기준).
`use_marketplace_template` 부울	선택 사항. 모든 판매자에게 전 세계적으로 제공되는 기본 템플릿을 사용하여 캠페인을 만들려면 이 필드를 지정합니다. 조건:`use_marketplace_template` 또는 `use_seller_template`을 사용해야 하며, 두 가지를 모두 사용할 수 없습니다.
`use_seller_template` 부울	선택 사항. 판매자에 적용되는 맞춤 템플릿을 사용하여 캠페인을 만들려면 이 필드를 지정합니다. 조건:`use_marketplace_template` 또는 `use_seller_template`을 사용해야 하며, 두 가지를 모두 사용할 수 없습니다.

응답

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

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

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

성공 응답

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

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

실패 응답

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

오류 코드

오류 코드	오류 하위 코드	설명
1800011	2310154	개발 모드인 앱에서 만든 광고 크리에이티브 게시물입니다. 이 광고를 만들려면 전체 공개 상태여야 합니다.
1800103	2310155	비즈니스 관리자 {seller_business_id}에 공유 카탈로그 세그먼트가 없습니다. 이 오류는 부분적 온보딩이 원인일 수 있습니다. 협력 센터를 사용하여 자산을 공유하고 카탈로그 세그먼트를 추가하거나, 판매자 삭제 API를 사용하여 판매자를 삭제하고 비동기식 판매자 온보딩 API를 이용하여 다시 온보딩할 수 있습니다. Meta 파트너에게 연락하여 도움을 요청할 수도 있습니다.
1800104	2310156	입력한 ID({product_set_id})가 제품 세트 ID가 아닙니다. 카탈로그 ID({catalog_id})와 연결된 제품 세트 ID를 입력합니다.
1800105	2310157	입력한 ID({product_set_id})가 비즈니스 카탈로그 세그먼트의 제품 세트 ID가 아닙니다. 카탈로그 ID({catalog_id})와 연결된 제품 세트 ID를 입력합니다.
1800208	2310152	이 비즈니스의 광고 계정은 Facebook의 광고 정책 또는 다른 표준을 위반하여 비활성화되었습니다. 자세히 알아보려면, 협력 센터의 파트너십으로 이동하여 Facebook 담당자가 지정되어 있는 파트너를 선택하고 품질 문제 탭을 선택하세요. Meta 파트너에게 연락하여 도움을 요청하거나 재고를 요청할 수도 있습니다.
1800209	2310153	입력한 광고 계정({account_id})이 Facebook 담당자가 지정되어 있는 파트너 광고로 생성되지 않았습니다. Facebook 담당자가 지정되어 있는 파트너 광고에 온보딩할 때 이 비즈니스에 대해 생성된 광고 ID를 입력하세요.
1800308	2310137	이 비즈니스의 비즈니스 관리자({seller_business_id})에 판매자 페이지가 없습니다. 이 오류는 부분적 온보딩이 원인일 수 있습니다. 판매자 삭제 API를 사용하여 판매자를 삭제하고 비동기식 판매자 온보딩 API를 사용하여 다시 온보딩할 수 있습니다. Meta 파트너에게 연락하여 도움을 요청할 수도 있습니다.
1800309	2310159	이 비즈니스의 판매자 페이지는 Facebook의 광고 정책 또는 다른 표준을 위반했을 가능성이 있어 비활성화되었으므로 광고 게재에 사용할 수 없습니다. 자세히 알아보려면, 협력 센터의 파트너십으로 이동하여 Facebook 담당자가 지정되어 있는 파트너를 선택하고 품질 문제 탭을 선택하세요. Meta 파트너에게 연락하여 도움을 요청하거나 재고를 요청할 수도 있습니다.
1800400	2310161	입력한 캠페인 예산이 너무 작습니다. 사용한 템플릿에 따르면 예산은 {minimum_budget} 이상이어야 합니다.
1800402	2310160	입력한 잠재 고객 발굴 및 리타게팅 예산이 100%가 아닙니다. 잠재 고객 발굴 캠페인의 예산 비율과 리타게팅 캠페인의 예산 비율이 총 100%가 되도록 입력하세요. 또한 템플릿에서 잠재 고객 발굴 및 타게팅 캠페인이 모두 식별되었는지 확인하세요.
1800500	2310166	Facebook 담당자가 지정되어 있는 파트너 광고(MPA) API를 사용하여 MPA 캠페인이 아닌 캠페인을 업데이트하려고 합니다. 입력한 캠페인({campaign_id})을 확인하거나 다른 API를 사용하세요.
1800501	2310168	입력한 캠페인 ID({campaign_id})가 광고 계정에 속하지 않습니다. ID를 확인하고 다시 시도하세요.
1800700	2310172	이 광고 세트의 비용을 지불하는 사람 또는 조직을 입력하세요.
1800701	2310171	이 광고 세트를 통해 수익을 얻는 사람 또는 조직을 입력하세요.