错误代码

以下是该 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

直播帖网址安全应用设置不允许使用一个或多个指定网址。它必须与网站网址或全屏广告网址相匹配,或者网域必须是该应用的某个网域的子域。请阅读更多有关登录安全的内容,详细了解与安全相关的应用设置。

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_CAPLOWEST_COST_WITH_BID_CAPTARGET_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 或改为同时使用 LOWEST_COST_WITH_BID_CAP 与 bid_amount。从 3.0 开始生效。

1815067

优化目标不可用:您无法将所选择的优化目标应用于广告系列目标。请选择其他目标并编辑广告系列。

1798130

我们不允许为进阶赋能型目录广告创建空商品系列。请将商品添加至您的目录,并创建至少包含一件商品的系列。

2310025

无法使用此广告帐户创建广告系列。要创建合作广告系列,品牌广告主必须为合作的每位卖家使用独立广告帐户。请确保使用与拥有此细分目录的卖家相关联的独立广告帐户。仅提供有限的访问权限。

2310039

无法使用此细分目录创建广告系列。您无法使用此广告帐户为此细分目录投放广告。商家已创建此细分目录,可供品牌广告主在合作广告中使用。请选择其他广告帐户,或使用此广告帐户投放使用商品目录的广告系列。仅提供有限的访问权限。

3260011

广告组发布后,无法编辑广告组的 Pixel 像素代码、转化事件、自定义转化或优化方式。要投放具有所需更改的广告组,请创建一个新的广告组。

3858064

此广告系列中包含的一些选项不再适用于面向全球 18 岁以下、泰国 20 岁以下或印度尼西亚 21 岁以下观众的广告系列。请提高受众的最低年龄,或移除除了年龄和地点(地点应为城市或更大地区,不包括邮编和指定营销地区)以外的所有受众定位选项。

3858065

此广告系列中包含的一些选项不再适用于面向全球 18 岁以下、泰国 20 岁以下或印度尼西亚 21 岁以下观众的广告系列。请提高受众的最低年龄,或移除以下选项:不可用的广告版位

应仅根据错误代码处理错误。错误代码的描述可能会有变更,恕不另行通知。

blame_field_specs

这是导致验证错误的任何 API 调用的 error_data 二进制大对象中包含的属性,指示导致验证错误的出错字段。这一属性可用于在背景中显示错误,例如在广告创建工具 GUI 中的出错字段旁边显示错误。

blame_field_specs 是一个数组,其中的每个元素都是一个 blame_field_spec,指示 API 规范中出错的单个字段。

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 字段相关。