News for Developers

Back to News

Troubleshoot Ad Delivery with WITH_ISSUES Status

Jing Huang
November 27, 2018

In Marketing API, v3.2 we introduced a new ads run status where a campaign, ad set, or ad can be set to WITH_ISSUES, if it can't be delivered for any reason.

Read

To incorporate versioning, fields may return different values on read:

FieldVersion 3.2Versions Prior to 3.2

effective_status (enum {ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, WITH_ISSUES})

WITH_ISSUES

PAUSED

issues_info (list of issue info)

List of error messages

Error

configured_status enum {ACTIVE, PAUSED, DELETED, ARCHIVED}

PAUSED

PAUSED

status (enum {ACTIVE, PAUSED, DELETED, ARCHIVED})

PAUSED

PAUSED

Example - v3.2/ad_object_id?fields=effective_status,status,issues_info

{
"effective_status": "WITH_ISSUES",
"status": "PAUSED",
"issues_info": [
{
"level" : 'AD', 
"error_code": 1815869,
"error_summary": "Ad post is not available",
"error_message": "The Facebook post associated with your ad is not available. It may have been removed, or you may not have permission to view it." }
],
"id": "<ad_object_id>"
}

Example - v3.1/ad_object_id?fields=effective_status,status,issues_info

{
 "effective_status": "PAUSED", 
 "status": "PAUSED", 
 "id": "<ad_object_id>"
}

Example - v3.1/ad_object_id?fields=issues_info

{
  "error": {
    "message": "(#12) Using new run status WITH_ISSUES and ISSUES_INFO requires version v3.2 or higher",
    "type": "OAuthException",
    "code": 12,
    "fbtrace_id": "<fbtrace_id>"
  }
}

Write

When an ad object is set to WITH_ISSUES, you can still make regular writes to the object:

  • If the issue is not fixed and it can be validated on update, the mutation is rejected.
  • If the issues cannot be validated immediately, the update goes through and might be reset to WITH_ISSUES.
  • If the mutation goes through and no status is specified, the ad object may stay in WITH_ISSUES.

ISSUES_INFO Structure

ISSUES_INFO contains a list including error_code, some error_summary, error_message, and level to indicate which level the issue occurs. Possible values for level are AD, AD_SET and CAMPAIGN. For example, querying ISSUES_INFO on ad level could return issues occurred on itself and its parents, if there are any.

WITH_ISSUES Status and ISSUES_INFO Relation

Currently, ISSUES_INFO is provided when the current level's effective_status is set to WITH_ISSUES.

For more details, see the Marketing API v3.2 changelog.


Related News

December 18 2018

November 01 2018

October 25 2018

October 23 2018

September 27 2018

July 31 2018