Marketing API Version

Ad Recommendation

Reading

A recommendation object that suggests potential improvements around the ad object's configuration.

Each recommendation contains a unique integer value: code, human readable: title and message. Additionally, a field indicating how important: importance and accurate: confidence we believe this recommendation is. Finally, a blame_field associating the recommendation with a field in the spec.

Currently supported recommendations (split by ad levels):

LevelCodeSummaryBlame Fields
Ad Set1815312Audience Network Not Allowed For Ad Accounttargeting
Ad Set1815420Billing event is invalid for Audience Network inside video views objectivetargeting
Ad Set1815560Instant Article Not Allowed For AdAccounttargeting
Ad Set1942002Your Estimated Audience Is Very Broad
Ad Set1942003Your Audience Is Very Specific
Ad Set1942004Your Ad Set Targets Multiple Countriestargeting
Ad Set1942006Ad Isn't Optimized for Conversionsoptimization_goal
Ad Set1942008Your Bid Is Low
Ad Set1942016Ad Set Endedend_time
Ad Set1942021Creative In Campaign Is Not Eligible For Instagram
Ad Set1942024Creative In Campaign Not Updated for Instagram
Ad1942001Targeted Languages Don't Match Textcreative
Ad1942006Ad Isn't Optimized for Conversionstracking_specs
Ad1942007Country Languages Don't Match Ad Creativecreative
Ad1942010Use Objectives Optimized for Mobilecreative
Ad1942015Ad image contains too much textcreative
Ad1942017Text Overlay Penalty Level Lowcreative
Ad1942018Text Overlay Penalty Level Mediumcreative
Ad1942019Text Overlay Penalty Level Highcreative
Ad1942020Creative Is Not Eligible For Instagramcreative
Ad1942022Relevance score of your ad is low
Ad1942023Creative Not Updated for Instagramcreative
Ad1942027Ad Image Needs Improvementcreative


If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription

blame_field

string

Field to associate the recommendation with (optional)

code

int32

Unique recommendation code

confidence

enum {HIGH, MEDIUM, LOW}

Indicator of how reliable recommendation is. Allowed values are: HIGH, MEDIUM, LOW

importance

enum {HIGH, MEDIUM, LOW}

Indicator of how important recommendation is. Allowed values are: HIGH, MEDIUM, LOW

message

string

Content of the recommendation message

recommendation_data

AdRecommendationData

Additional data associated with the recommendation. Returned fields can vary depending on the recommendation code.

title

string

Recommendation title

Edges

No edges

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.