2.8.1
New Features
- Instant Articles is now a separate ads placement, so that advertisers can enable or disable showing ads in Instant Articles. This new placement options is under
/ACCOUNT_ID/adsets
and/AD_SET_ID
. See Targeting Specs. If you use this placement you must also selectfeed
as a position and fordevice_platforms
selectmobile
since Instant Articles is for mobile only. - Facebook Offers is redesigned and is easier for people to save and redeem your offer from any device. If they don't use your offer, they'll get notifications about it before it expires. To use the API to create offers:
- Use
/nativeoffers
as an endpoint. The endpoint/offers
is associated with the old product and has been deprecated. - Use
offer_id
in thepromoted_object
for an ad set. - To learn more see Offer Ads and Page Native Offers.
- Use
Breaking Changes
** Please Review These Changes
Ads Management
- As of 2.8, Website Custom Audiences now only allow at most 200 comparisons in the rule. The number of comparisons are the number of comparison operators in the rule.
- The
place_page_set_id
field under Ad creative is now optional for versions v2.7 and v2.6
and has been deprecated in v2.8. See Ad Creative. offer_data
underlink_data
for an ad object has been deprecated.- The ad account group endpoints
AdAccountGroup
have been deprecated. To manage Ad Accounts, you should use Business Manager or Business Manager API withbusiness_management
extended permission. - The edge
AD_ACCOUNT/audiences
has been deprecated. - The
ad_object_by_url
field for/search
in Ad Targeting Search has been deprecated. - The fields
actor_id
,actor_image_hash
,actor_image_url
, andactor_name
have been deprecated from ad creative GET.
Ads Insights
- We deprecated the redundant fields and parameters in
/insights
endpoint.
In earlier releases it supported the params:fields,summary
,default_summary
,filtering
andsort
. However/insights
should always exactly return what you queried in the POST requests. - In earlier releases we will display all valid fields for
/insights
if you provided an invalid field as a parameter. We now send an the error message which points to a list of valid fields. - In the past we inconsistently returned
/insights
fields in a variety of types: some fields werestring
such asimpressions
, some werenumericstring
, and some werefloat
. We now return all numeric fields, includingfloat
asnumericstring
. All floating point numbers will maintain six precision points. - The insights metric
post_like
in theactions
field is now namedpost_reaction
, see Ads Action Stats. This is more consistent with naming in user interfaces.
Business Manager
The owner_business
field has been deprecated and no longer exists for objects connected to a business, including Ad accounts, Ad Campaign, Product Catalog, and Instagram User.