마케팅 API

오류 코드

API가 반환한 오류 코드는 다음과 같습니다.

오류 코드 설명

-

Negative-value error codes are internal Facebook errors. Check error_subcode for the actual failure code.

1

 An unknown error occurred

1, 하위 코드 99

알 수 없는 오류가 발생했습니다. level을 adset으로 설정했지만 올바른 값이 campaign이어야 하는 경우 이 오류가 발생할 수 있습니다.

4

 Application request limit reached

10

 Application does not have permission for this action

17

 User request limit reached

100

 Invalid parameter

100, 하위 코드 33

 Unsupported post request.

액세스 토큰이 맞춤 타겟을 소유한 광고 계정에 적절한 권한을 가진 시스템 사용자로 추가되지 않으면 이 오류가 나타날 수 있습니다. 비즈니스 관리자의 광고 계정을 확인하고 모든 시스템 사용자가 해당 광고 계정에 Admin으로 표시되는지 확인하세요.


  • Business Settings을 클릭합니다.
  • 광고 계정을 클릭합니다.
  • Add people을 선택합니다.
  • 시스템 사용자를 검색하고 관리자로 추가합니다.
  • API 호출을 다시 시도합니다.

100, 하위 코드 1487694

 Invalid parameter.

선택한 카테고리는 더 이상 사용할 수 없습니다. 일부 행동 기반 타게팅 카테고리가 사용 중단됩니다. 사용 중단된 카테고리를 사용하여 광고를 만들려고 하면 요청이 실패하고 이 오류를 반환합니다. 타게팅 검색을 사용하여 타게팅에 사용 가능한 카테고리를 확인하세요.

100, 하위 코드 1752129

 Invalid parameter.

지원되지 않는 작업 조합입니다. 이 광고 계정에 대해 사용자에게 유효한 기능을 할당하려면 매핑에 정의된 작업 조합으로 전달해야 합니다. 비즈니스 관리자 API, 허용되는 역할을 참조하세요.

102

 Session key invalid or no longer valid

104

 Incorrect signature

190

 Invalid OAuth 2.0 Access Token

200

 Permission error

200, 하위 코드 1870034

맞춤 타겟 약관을 수락하지 않음: 타겟 또는 광고 세트를 만들거나 수정하기 전에 맞춤 타겟 약관에 동의해야 합니다. Facebook, 맞춤 타겟 약관을 참조하세요.

200, 하위 코드 1870047

 Audience Size too Low: You cannot remove users from this audience because it will result in a low audience size and may result in under-delivery or non-delivery of your ads.

294

 Managing advertisements requires the extended permission `ads_management` and an application that is in our allow list to access the Marketing API

2606

 Unable to display a preview of this ad

2607

 The given currency is invalid for usage with ads.

2615

 Invalid call to update this adaccount

2654

 Failed to create custom audience.

2654 하위 코드 1713092

 No write permission for this ad account. Developer making this call must have permissions for the ad account to create an audience for it.

5000

 Unknown Error Code

1340029

현재 다이내믹 크리에이티브 광고는 삭제할 수 없습니다. 상위 광고 세트를 삭제하여 진행해 주세요.

1373054

구문 분석이 가능한 행동 유도 유형이 없습니다. 행동 유도 API 문서를 참조하세요.

1404078

이 작업을 수행하지 못하도록 일시적으로 차단되었습니다.

1404163

이제 Facebook 제품을 광고에 사용할 수 없습니다. 광고 게재, 광고 자산 관리, 새 광고 만들기 또는 비즈니스 계정 만들기 기능이 불가합니다. 더 알아보기

1487007

종료 날짜에 도달한 예약된 광고 세트에 포함되어 있으므로 해당 광고를 수정할 수 없습니다. 광고 세트의 예산 및 일정 섹션으로 이동하여 종료 날짜를 미래의 날짜로 변경하고 다시 수정해 보세요.

1487033

캠페인 종료 날짜는 미래여야 합니다. 다른 종료 날짜를 선택하고 다시 시도하세요.

1487056

이 광고 세트는 삭제되었으므로 이름만 수정할 수 있습니다. 다른 필드를 수정하고자 하는 경우, 이 광고 세트를 복제할 수 있습니다. 그러면 동일한 설정의 광고 세트를 만들어 수정할 수 있습니다.

1487472

 You are using {msg}, which can't be promoted in an ad. Please choose a different Page post to continue.

1487566

이 캠페인은 삭제되었으므로 이름만 수정할 수 있습니다. 다른 필드를 수정하고자 하는 경우, 이 캠페인을 복제할 수 있습니다. 그러면 동일한 설정의 캠페인을 만들어 수정할 수 있습니다.

1487678

광고를 만들고자 하는 앱이 이 광고 세트의 타게팅 설정과는 다른 운영 체제에 있습니다.

1487831

제품 세트를 읽어들일 수 없습니다. 제품 세트가 존재하지 않거나 공개 범위로 인해 액세스가 불가할 수 있습니다.

1487929

홍보하려는 개체가 모호합니다. 홍보 개체를 하나만 지정해야 합니다.

1487990

이 광고 계정에 보관된 광고 그룹이 이미 너무 많습니다. 일부 광고 그룹을 삭제해야 추가로 보관할 수 있습니다.

1815199

이 Instagram에 액세스 권한이 없는 광고 계정입니다. 권한이 있는 Instagram 계정을 사용하거나 먼저 이 Instagram 계정에 광고 계정을 할당하세요.

1815629

모든 광고 세트 값은 고유해야 합니다. 값을 확인해 주세요.

1815694

사용자에게 이 작업에 대한 권한이 없습니다.

1870065

비활성화된 타겟이 하나 이상 포함되어 있어서 사용할 수 없습니다. 비활성화된 타겟은 더 이상 활성 상태가 아닌 계정에서 공유되었습니다. 이 문제를 수정하려면 해당 타겟을 삭제하세요.

1870088

연결 관계 타게팅이 사용 중단되고 있습니다. 캠페인에서 연결을 삭제하여 캠페인을 게시하세요.

1870090

타겟 또는 광고 세트를 만들거나 수정하려면 맞춤 타겟 약관에 동의하세요.

1870092

타겟 또는 광고 세트를 만들거나 수정하려면 Meta 비즈니스 도구 약관에 동의하세요.

1870165

타겟에는 전 세계에서 만 18세 미만(태국의 경우 만 20세, 인도네시아의 경우 만 21세)을 타겟으로 하는 광고에서 더 이상 사용할 수 없는 타게팅 옵션이 포함되어 있습니다. 타겟의 최저 연령을 높이거나 위치, 나이, 성별을 제외한 모든 타게팅 옵션을 삭제하세요.

1870199

모든 위치 타게팅은 자신이 선택한 위치에 살고 있거나 최근에 해당 위치에 있었던 사람들에게 도달합니다. location_types 필드에서 모든 값을 삭제하세요.

1885029

광고에 대해 선택한 페이지가 홍보하려는 개체(예: 페이지 게시물, 앱)와 연결된 페이지와 일치하지 않습니다. 페이지가 동일한지 확인해 주세요.

1885088

이 광고는 보관된 상태이며 수정할 수 없습니다. 이 광고는 이름만 수정할 수 있습니다. 다른 필드를 수정하고자 하는 경우, 이 광고를 복제할 수 있습니다. 그러면 동일한 설정의 광고를 만들어 수정할 수 있습니다.

1885183

개발 모드인 앱에서 만든 광고 크리에이티브 게시물입니다. 이 광고를 만들려면 공개 상태여야 합니다. 그러면 동일한 설정의 새로운 광고 세트를 만들어 수정할 수 있습니다.

1885204

선택한 최적화에 대해 입찰을 자동으로 설정해야 합니다. 청구 또는 입찰 정보를 삭제하거나 최적화를 변경하세요.

1885272

예산이 너무 낮습니다.

1885557

광고에서 사용 불가한 게시물을 홍보하고 있습니다. 게시물이 삭제되었거나, 게시가 취소되었거나, 광고 페이지에서 소유하지 않았거나, 이 게시물을 확인하거나 홍보할 권한이 없습니다.

1885621

광고 세트 예산 또는 캠페인 예산만 설정할 수 있습니다.

1885557

광고에서 사용 불가한 게시물을 홍보하고 있습니다. 게시물이 삭제되었거나, 게시가 취소되었거나, 광고 페이지에서 소유하지 않았거나, 이 게시물을 확인하거나 홍보할 권한이 없습니다.

1885650

예산이 너무 낮습니다. 예산이 업데이트되는 동안(최대 15분 소요 가능) 발생하는 모든 지출을 고려하여 이 최소 금액이 필요합니다.

2238055

크리에이티브 사양에서 instagram_user_id 및 instagram_actor_id 또는 instagram_story_id 및 source_instagram_media_id를 모두 전달할 수 없습니다.

2446149

크리에이티브 사양에서 instagram_user_id 및 instagram_actor_id 또는 instagram_story_id 및 source_instagram_media_id를 모두 전달할 수 없습니다.

2446307

캠페인 그룹 지출 한도가 최소값보다 작습니다.

2238055

이 캠페인의 모든 광고 세트를 고려하여 캠페인 예산이 {minimum_budget} 이상이어야 합니다.

2446173

이름이 {label}인 타겟 규칙 레이블은 어떠한 자산 레이블도 참조하지 않습니다. 모든 광고 크리에이티브를 삭제하여 수정해 주세요.

2446289

광고에 선택한 {post_type}을(를) 사용할 수 없습니다. 삭제되었거나 이를 볼 수 있는 권한이 없을 수 있습니다. 광고 크리에이티브를 확인하고 다시 시도하세요.

2446347

기존 게시물의 광고에 use_existing_post('asset_feed_spec:target_rules'의 기본 규칙)가 true로 설정되어 있습니다. 이는 UI를 통해 실행할 수 있는 것이 아니라 서버로 보내는 POST 요청의 일부에 해당합니다.

2446383

캠페인 목표에 외부 웹사이트 URL이 필요합니다. 행동 유도를 선택하고 광고 크리에이티브 섹션에 웹사이트 URL을 입력하세요.

2446394

이 광고 세트에 더 이상 사용할 수 없거나 타겟에서 사람들을 제외할 때 사용할 수 없는 상세 타게팅 옵션이 포함되어 있습니다. 상세 타게팅에서 항목을 삭제하거나 변경 사항을 확인하여 다시 활성화해야 합니다.

2446509

광고 캠페인 랜딩 페이지 유형이 유효하지 않습니다.

2446580

interactive_components_spec 매개변수를 제공할 때는 components 및 child_attachments 필드를 모두 지정할 수 없습니다.

2446712

매장 방문 최적화가 포함된 광고 세트를 만들거나 실행하는 기능을 더 이상 사용할 수 없습니다. 대신 도달 범위 또는 매장 판매 최적화를 선택하세요.

2446867

{country_names}에 대해 어드밴티지+ 쇼핑 캠페인의 한도인 {campaigns_per_country_cap}에 이미 도달했습니다. 이러한 국가에 대해 더 많은 캠페인을 만들고자 하는 경우, 표준 전환 캠페인을 사용하세요.

2446880

Facebook 페이지 또는 Instagram 프로필에 연결된 WhatsApp 전화번호의 연결이 끊어졌습니다. WhatsApp 계정에 다시 연결했을 때 이 광고를 다시 게재할 수 있습니다.

2490085

최신 광고 API 버전에서 191x100 자르기 키를 더 이상 사용할 수 없습니다. 권장 자르기 키는 100x100입니다.

2490155

광고와 연결된 게시물을 사용할 수 없습니다. 삭제되었거나 조회할 권한이 없을 수 있습니다.

2490372

계속하려면 Shop 랜딩 페이지를 선택해야 합니다.

2490427

가장 최근에 진행한 검수 과정에서 광고가 거부되었고 현재는 비활성화되었습니다. 광고를 활성화하려면 업데이트하고 새로운 광고를 만들어야 합니다.

2490468

가장 최근에 진행한 검수 과정에서 광고가 거부되었고 현재는 비활성화되었습니다. 광고를 활성화하려면 업데이트하고 새로운 광고를 만들어야 합니다.

2708008

사회 문제, 선거 또는 정치 관련 광고를 게재할 권한이 없습니다. 권한이 있는 광고 계정 사용자가 이 광고를 게재하도록 하거나 https://www.facebook.com/id에서 ID 확인 절차를 완료하세요.

2859015

이 작업을 수행하지 못하도록 일시적으로 차단되었습니다.

3858064

이 캠페인에는 전 세계에서 만 18세 미만(태국의 경우 만 20세, 인도네시아의 경우 만 21세)을 타겟으로 하는 캠페인에서 더 이상 사용할 수 없는 옵션이 포함되어 있습니다. 타겟의 최소 연령을 높이거나 연령과 도시 규모 이상의 위치를 제외한 모든 타게팅 옵션을 삭제하세요(우편번호 제외).

3858082

이 크리에이티브는 기본 개선 사항을 적용할 수 있지만 enroll_status를 제공하지 않았습니다. 기본 개선 사항을 활성화할지 여부를 선택하세요. 자세한 내용은 여기를 참조하세요.

3858152

이 광고는 광고 수익 주체 및 지불 주체 정보를 포함하여 게시해야 하는 광고 세트에 속합니다. 광고 세트로 이동하여 이 정보를 추가 또는 검토한 후 '게시'를 클릭하세요.

3867105

이 콘텐츠는 파트너십 광고에 사용할 수 없습니다. 다른 콘텐츠를 선택하세요.

3910001

계정에 문제가 발생했습니다. 나중에 다시 시도해주세요.

오류는 오류 코드만 사용해서 처리되어야 합니다. 설명 문자열은 사전 통지 없이 변경될 수 있습니다.

blame_field_specs

유효성 검사 오류를 발생시키는 모든 API 호출의 error_data 블랍에 포함되는 속성으로, 유효성 검사 오류에 대해 어떤 필드에 오류가 있는지 나타냅니다. 오류가 있는 필드 바로 옆에 상황별 오류를 표시하기 위해 사용될 수 있습니다(예: 광고 제작 도구의 GUI 내 오류 필드).

blame_field_specs는 배열이며, 배열의 각 요소는 API 사양에서 오류가 있는 단일 필드를 나타내는 blame_field_spec입니다.

blame_field_spec 자체도 배열로서 오류가 있는 필드의 이름 및 제공된 전체 API 사양 내에서 해당 필드의 위치를 나타냅니다.

예:

오류가 있는 단일 필드

{  
  "error":{  
    "type":"Exception",
    "message":"The budget for your Ad-Set is too low.  It must be at least $1.00 per day.",
    "code":1487901,
    "is_transient":false,
    "error_data":{  
      "blame_field_specs":[  
        ["daily_budget"]
      ]
    }
  }
}

API 사양의 daily_budget 필드에 수치가 너무 낮은 오류가 있음을 나타냅니다.

오류가 있는 여러 필드

"blame_field_specs":[  
  ["targeting_spec", "interested_in"], 
  ["bid_info", "impressions"]
]

API 사양의 targeting_spec 필드 내 interested_in 하위 필드와 관련된 오류가 있으며, 해당 오류가 API 사양의 bid_info 필드 내 impressions 필드와도 관련이 있음을 나타냅니다.