FACEBOOK MARKETING API CHANGELOG

Marketing API

Version	Path	Date Introduced	Available Until
v2.5	/v2.5/{object}	Oct 7th, 2015
v2.4	/v2.4/{object}	July 8th, 2015	April, 2016

Marketing API

Lead Ads - Advertisers will now be able to collect contact information and other qualifiers from potential customers via a Facebook ad.

Insights - Added 

inline_link_clicks

, 

cost_per_inline_link_click

,

inline_post_engagement

, 

cost_per_inline_post_engagement

 metrics.

Ad, Ad set, and Campaign object read path:

Add 

effective_status

 to reflect the real Ad delivery status. For example for an active adset in a paused campaign, the 

effective_status

 of
this adset is

CAMPAIGN_PAUSED

.
Add 

configured_status

 to reflect the status specified by user.

Changes from v2.4 to v2.5

Marketing API

See table above for future deprecation dates of Marketing API.
Consistent naming for three-level campaign structure between API and UI. This changes naming at endpoint, params, fields, and enum level. For the full list of changes, refer here.

Change 

/adcampaign_groups

 to 

/campaigns

Change 

/adcampaigns

 to 

/adsets

Change 

/adgroups

 to 

/ads

In the write path, change campaign_group_status, campaign_status, adgroup_status to

status

Ad Account

Default the 

name

 of the first visible admin to current user if not specified.

Campaign

Change naming of objectives

WEBSITE_CLICKS

 to 

LINK_CLICKS

WEBSITE_CONVERSIONS

 to 

CONVERSIONS

Targeting

Response for call to 

/search?type=adgeolocation

 will contain only the 'City' instead of 'City, State'
Change 

{cpc, cpm, cpa}_{min, max, median}

, such as 

cpc_min

 fields
in/reachestimate to 

bid_amount_min

, 

bid_amount_median

, 

bid_amout_max

.
Change

bid_for

 to 

optimize_for

DPA

Enforce Terms of Service for all Product Catalogues and Dynamic Product Ads users. Advertisers
implicitly accept by creating their first catalog through Business Manager. For API developers, Terms of Service need to be accepted through BM
when the product catalog is first created.

Local Awareness Ads

Require 

page_id

 in 

promoted_object

 at
the 

/adset

 level for Local Awareness Ads
No longer require 

custom_locations

 for location targeting, and also allow sub-national, single country targeting. Now all location
types except for country, and all locations must be within the same country.

Deprecations in this version

90-day deprecations

New Real Time Updates via HTTPS Only - New subscriptions cannot be created with a non-HTTPS callback URL. This affects 

User

, 

Page

, 

App

,
and 

Payment

 updates.

Page Tab Apps URI Format - Page Tab Apps URI format

https://www.facebook.com/{vanity}?v={app_id}

 will
no longer work 90 days after this release. Please use 

https://www.facebook.com/{vanity}?sk={app_id}

 or

https://www.facebook.com/{vanity}/{app_id}

.

Marketing API

See table above for future deprecation dates of Marketing API
Premium Self Serve

The last day to book a PSS (or homepage) campaign will be November 15th
The last day PSS (or homepage) campaigns can run will be December 31st 2015.

Account

Remove 

friendly_name

Campaign

Remove ability to create campaign with 

Objective='NONE'

. 'NONE' is still a valid read-only objective. You can continue to edit
existing campaigns.
Remove 

reach_block

, 

deprecated_reach_block

 and 

FIXED_CPM

 from
campaign

buying_type

.

Adset

Remove 

USE_NEW_APP_CLICK

Remove 

buying_type

Targeting

Remove 

want_localized_name

 param for 

/search?type=adgeolocation

.
Remove 

/search?type=adcity

 and 

adregion

,
use 

/search?type=adgeolocation

instead.
Remove 

engagement_specs

 and 

excluded_engagement_specs

 from
targeting spec. The similar video remarketing functionality is supported through 

/customaudiences

endpoint.
Deprecate or make private certain targeting options:
Instead of being returned in 

/search

, private categories will now be returned in

/act_{AD_ACCOUNT_ID}/broadtargetingcategories

 or

/act_{AD_ACCOUNT_ID}/partnercategories

.
Deprecated categories will no longer be returned.
Updates to ad set targeting using private or deprecated categories will error. It's recommended to query the validation endpoint before updating the ad set targeting to identify which targeting options to remove.

Insights

Remove filter on 

adgroup_id

, 

campaign_id

,
or 

campaign_group_id

. Instead use

ad.id

, 

adset.id

 and 

campaign.id

Remove 

cpc

 and 

clicks

 fields
in Insights API. Newly added related metrics include

inline_link_clicks

, 

cost_per_inline_link_click

, 

inline_post_engagement

,

cost_per_inline_post_engagement

.
Please note clicks(all) historically counted any engagement taken within the ad unit as a click. Thus, clicks(all) won't be a simple addition of 

link_clicks

 and 

post_engagement

.
The newly added fields are available in v2.4 and v2.5

The next version of the Graph API will be released in April 2016. We'll announce a specific date in the near future.