Graph 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):

Level	Code	Summary	Blame Fields
Ad Set	1772120	Incompatible Instagram placement for ad buying type	targeting
Ad Set	1815312	Audience Network Not Allowed For Ad Account	targeting
Ad Set	1815331	Buying Type Not Supported for Messenger Placement	targeting
Ad Set	1815420	Billing event is invalid for Audience Network inside video views objective	targeting
Ad Set	1815560	Instant Article Not Allowed For AdAccount	targeting
Ad Set	1815604	Placement Not Supported By Dynamic Creative	targeting
Ad Set	1815609	Placement Not Supported By Objective	targeting
Ad Set	1815610	Device Platform Not Supported By Objective	targeting
Ad Set	1815612	Device Platform Not Supported By Optimization Goal	targeting
Ad Set	1815618	Positions Filtered Because No Corresponding Publisher Or Device	targeting
Ad Set	1815619	Publisher Placement Not Available	targeting
Ad Set	1942004	Your Ad Set Targets Multiple Countries	targeting
Ad Set	1942006	Ad Isn't Optimized for Conversions	optimization_goal
Ad Set	1942016	Ad Set Ended	end_time
Ad Set	2238043	Buying Type Not Supported for IG Explore Placement	targeting
Ad	1942001	Targeted Languages Don't Match Text	creative
Ad	1942006	Ad Isn't Optimized for Conversions	tracking_specs
Ad	1942007	Country Languages Don't Match Ad Creative	creative
Ad	1942022	Relevance score of your ad is low
Ad	1942027	Ad Image Needs Improvement	creative
Ad	2007014	Multi-photo not supported	creative

Examples

You can read the recommendations field off of a campaign, ad set, or ad object. The example illustrates reading the recommendations off of an ad.

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad($ad_id);
$ad->read(array(
  AdFields::NAME,
  AdFields::RECOMMENDATIONS,
));

// Output Ad name.
echo $ad->{AdFields::NAME}.PHP_EOL;
// Output recommendations
echo $ad->{AdFields::RECOMMENDATIONS}.PHP_EOL;

curl \
-d "fields=id,recommendations" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/<AD_ID>

Parameters

This endpoint doesn't have any parameters.

Fields

Field	Description
`blame_field` string	Field to associate the recommendation with (optional) Default
`code` int32	Unique recommendation code Default
`confidence` enum {HIGH, MEDIUM, LOW}	Indicator of how reliable recommendation is. Allowed values are: `HIGH`, `MEDIUM`, `LOW` Default
`importance` enum {HIGH, MEDIUM, LOW}	Indicator of how important recommendation is. Allowed values are: `HIGH`, `MEDIUM`, `LOW` Default
`message` string	Content of the recommendation message Default
`recommendation_data` AdRecommendationData	Additional data associated with the recommendation. Returned fields can vary depending on the recommendation code. Default
`title` string	Recommendation title Default

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.