오류 코드

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
`1349118`	지정된 URL 중 1개 이상이 스트리밍 게시물 URL 보안 앱 설정에서 허용되지 않습니다. 웹사이트 URL 또는 캔버스 URL과 매칭되거나 도메인이 앱 도메인 중 하나의 하위 도메인이어야 합니다. 보안과 관련된 앱 설정에 대한 자세한 내용은 로그인 보안을 참조하세요.
`1359036`	Ad Create Failed - Too Many Ads: The account {account_id} has reached the maximum number of ads {max}
`1359102`	Invalid Parameter In Spec: Parameter has invalid value or missing required parameter: {param-value}
`1487006`	Invalid Campaign ID: You must specify a campaign, and the campaign specified must belong to the account specified and must not be deleted.
`1487007`	Campaign Ended: You can't edit ads in a campaign that has ended. Please create a new ad within this campaign, update the campaign end time, pick another campaign, or create a new campaign.
`1487010`	Ad Bid Too High: Your bid is above the maximum for its type and placement. Please try again with a value below the maximum if you would like to raise your bid.
`1487013`	Bid Too Low: Your bid is below the minimum for its placement and type. If you don't want your ad to run at the minimum bid rate, please pause it. Otherwise, please increase the bid to be within the suggested range.
`1487014`	Campaign budget was too low. Please increase the daily budget to at least 2 times the amount of the highest CPC ad bid, which is at least {minimum_budget}. You bid {bid}.
`1487015`	The ad creative is invalid
`1487065`	Ad Missing Targeting Spec: Ad spec needs a targeting spec. Please use targeting field to specify what audience the ad should be shown to. Field 'countries' is required; all others are optional.
`1487087`	Ad Create Failed: The Ad Create Failed for the following reason: {reason}
`1487089`	Target Spec Invalid: The target spec is invalid: {reason}
`1487090`	Ad Edit Failed - Spec Errors: {error}
`1487108`	Invalid Cities: Please check that the format in which you are specify the cities is correct, and if you specify IDs, that they are of the correct type. This can not be the the ID of the page for the city; city ids are returned by, `/search?type=adcity`.
`1487124`	Invalid Connection: You can only specify connections to objects you are an administrator or developer of.
`1487133`	Invalid Negative Connections: If you specify negative targeting, you must be the administrator or developer of the objects whose fans you want to specify to exclude. You are not an admin of the following specified connections: {connections}
`1487172`	Could not save creative
`1487174`	Invalid Image Hash: Invalid Image Hash - {hash}
`1487194`	Permission Error: Either the object you are trying to access is not visible to you or the action you are trying to take is restricted to certain account types.
`1487199`	Ad targeting does not match targeting of the story: The targeting specified for this ad is not compatible with the story being boosted. Check the privacy and language/country targeting of the story you are trying to sponsor.
`1487202`	Invalid object - not admin or object not public: The user is not an admin of the object or the object is not publicly accessible.
`1487211`	Invalid URL For Creative Destination: Creative must have a valid destination URL, and if attached object is page, destination must match page.
`1487225`	Ad Creation Limited By Daily Spend: The number of ads you can create in a given period of time has a limit determined by your daily spend level. Higher spend levels allow creation of more ads. Increase your daily spend limit or create fewer ads per time period.
`1487244`	Campaign Update Failed: Campaign {campaign_id}: {reason}
`1487246`	Campaign Creation Failed: {reason}
`1487256`	Targeting declined due to policy: Invalid ads targeting. The targeting spec was declined due to policy restrictions.
`1487283`	Not Allowed To Use View Tags: Only some partners are allowed to use view tags. Please verify that you are using an approved account.
`1487301`	Custom Audience Unavailable: The custom audience you're trying to use hasn't been shared with your ad account. Please create or choose a different custom audience, or ask the owner of the custom audience to let you use it.
`1487346`	The post does not belong to the specified Page: Post to be promoted does not belong to the Page specified. The post belongs to {otherDestination}; try using this as the destination or using a post that belongs to the specified Page. Specified Page: {destination}.
`1487366`	Custom Audience Has Been Deleted: Cannot use deleted custom audience. Please choose another audience.
`1487376`	Conversion Spec Needed: For ads pointing to an offsite location with a non-zero bid on actions, you must specify the conversion spec.
`1487380`	Invalid aggregation day for conversion data. The aggregation day must be larger than or equal to 1.
`1487390`	Adcreative Create Failed: The Adcreative Create Failed for the following reason: {reason}
`1487391`	Cannot Use Syndicated Audiences From Multiple Partners: When specifying partner-created custom audiences for an ad, all audiences must be from the same provider.
`1487396`	Failed to update the creative: Failed to update creative {id}. Failed for the following reason: {reason}
`1487424`	Ad Needs Exclusion Targeting: This ad cannot be created with the targeting spec you selected. Your ad has a conversion objective that users can only do once, so you must target the ad at those users who have not already converted. If you are using the Facebook API, consider including the following string in your targeting spec: {exclusion-targeting-spec}.
`1487465`	Invalid CPA Bid: The action type you selected is not allowed for Cost-Per-Action (CPA) bidding: '{action_type}'. Please change your optimization goal or switch your bid type to regular Optimized CPM.
`1487472`	This type of page post is not eligible to be promoted. {debug_info}
`1487477`	Conversion Tracking Pixel Permission Error: The conversion tracking pixel you're trying to use is owned by another user and hasn't been shared with you. Please use a tracking pixel that's been shared with you or create a new one.
`1487485`	Too many async requests
`1487506`	The new budget value is too low: The new budget value of {new_budget} is too low. The minimum acceptable is {minimum_budget}.
`1487557`	No supported fields were provided for updating the campaign
`1487558`	No supported fields were provided for updating the ad
`1487559`	Ad Update Failed {reason}
`1487573`	You must specify an object_id for this adcreative type (creative type 27)
`1487742`	There have been too many calls from this ad-account. Wait a bit and try again.
`1487756`	You have overlapping locations specified in the geo_locations field. Your broader option will override the narrower option, please remove one to proceed.
`1487790`	The promoted object is invalid: it could have been deleted or never existed.
`1487881`	The given prediction id in a reach and frequency campaign is not reserved.
`1487882`	The given reservation in a reach and frequency campaign is not finalized yet.
`1487884`	The given reservation in a reach and frequency campaign is already finalized
`1487885`	The prediction in a reach and frequency campaign is already reserved.
`1487886`	This indicates the operation fails for an unknown reason.
`1487887`	The given page types are not supported by the inventory manager.
`1487915`	A finalized prediction order can not be cancelled. You can create a new prediction or delete the campaign.
`1634013`	Conversion Spec Targets Invalid ID: You are targeting an ID in your conversion spec without admin permissions on that object. {debug_info}
`1667002`	This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.
`1667002`	This Promotion Can't Be Edited: This can't be edited because you promoted it from your Page. Find the post on your Page to pause, delete, or update budget for this promotion.
`1815826`	입찰 전략이 유효하지 않습니다. 현재 이용 가능한 입찰 전략은 `LOWEST_COST_WITHOUT_CAP`, `LOWEST_COST_WITH_BID_CAP`, `TARGET_COST`입니다. 비즈니스 목표에 맞는 유효한 입찰 전략을 선택하세요. 3.0 버전부터 적용됩니다.
`1815829`	광고 캠페인에서 캠페인 예산 최적화를 활성화한 상태에서 광고 세트에 입찰 전략을 설정하려고 합니다. 이러한 광고 세트에는 입찰 전략을 설정할 수 없습니다. 광고 세트에서 입찰 전략을 삭제하거나 캠페인에서 캠페인 예산 최적화를 비활성화하세요. 3.0 버전부터 적용됩니다.
`1815830`	광고 캠페인에서 경매 구매 유형을 사용하지 않는 상태에서 광고 세트에 입찰 전략을 설정하려고 합니다. 이러한 광고 세트에는 입찰 전략을 설정할 수 없습니다. 3.0 버전부터 적용됩니다.
`1815857`	입찰가 필요: bid_amount 필드에 입찰가 한도 또는 목표 비용을 입력해야 합니다. `LOWEST_COST_WITH_BID_CAP`의 경우 bid_amount 필드에 입찰가 한도를 설정해야 합니다. `TARGET_COST`의 경우 bid_amount 필드에 평균 목표 비용을 설정해야 합니다. 3.0 버전부터 적용됩니다.
`1815858`	입찰 전략이 `LOWEST_COST_WITHOUT_CAP`인 광고 세트에는 입찰가 한도를 설정할 수 없습니다. bid_amount를 삭제하거나 bid_amount로 `LOWEST_COST_WITH_BID_CAP`을 사용하도록 변경하세요. 3.0 버전부터 적용됩니다.
`1815067`	최적화 목표를 사용할 수 없음: 선택한 최적화 목표를 캠페인 목표에 사용할 수 없습니다. 다른 목표를 선택하고 캠페인을 수정하세요.
`1798130`	어드밴티지+ 카탈로그 광고에는 빈 제품 세트 만들기가 허용되지 않습니다. 카탈로그에 제품을 추가하고 제품을 1개 이상 포함하는 세트를 만드세요.
`2310025`	이 광고 계정을 사용하여 캠페인을 만들 수 없습니다. 협력 광고 캠페인을 만들려면 브랜드 광고주는 협력하는 각 판매자에 대해 별도의 광고 계정을 사용해야 합니다. 이 카탈로그 세그먼트를 소유한 판매자와 관련된 별도의 광고 계정을 사용하세요. 일부 계정에서만 이용할 수 있습니다.
`2310039`	이 카탈로그 세그먼트를 사용하여 캠페인을 만들 수 없습니다. 이 광고 계정을 사용하여 해당 카탈로그 세그먼트에 대한 광고를 게재할 수 없습니다. 비즈니스는 브랜드 광고주가 협력 광고에 사용할 수 있도록 이 카탈로그 세그먼트를 만들었습니다. 다른 광고 계정을 선택하거나 이 광고 계정에서 제품 카탈로그를 대신 사용하여 캠페인을 실행하세요. 일부 계정에서만 이용할 수 있습니다.
`3260011`	광고 세트가 게시된 후에는 광고 세트에 대한 픽셀, 전환 이벤트, 맞춤 전환 또는 최적화를 수정할 수 없습니다. 원하는 변경 사항을 적용하여 광고 세트를 실행하려면 새 광고 세트를 만드세요.
`3858064`	이 캠페인에는 전 세계에서 만 18세 미만(태국의 경우 만 20세, 인도네시아의 경우 만 21세)을 타겟으로 하는 캠페인에서 더 이상 사용할 수 없는 옵션이 포함되어 있습니다. 타겟의 최소 연령을 높이거나 연령과 도시 규모 이상의 위치를 제외한 모든 타게팅 옵션을 삭제하세요(우편번호 및 Designated Marketing Area 제외).
`3858065`	이 캠페인에는 전 세계에서 만 18세 미만(태국의 경우 만 20세, 인도네시아의 경우 만 21세)을 타겟으로 하는 캠페인에서 더 이상 사용할 수 없는 옵션이 포함되어 있습니다. 타겟의 최소 연령을 높이거나 사용할 수 없는 노출 위치를 삭제하세요.

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

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 필드와도 관련이 있음을 나타냅니다.