FACEBOOK MARKETING API CHANGELOG

Marketing API

VersionPathDate IntroducedAvailable 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 isCAMPAIGN_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 tostatus

• 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. Changebid_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 formathttps://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} orhttps://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 campaignbuying_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=adgeolocationinstead.
• Remove engagement_specs and excluded_engagement_specs from targeting spec. The similar video remarketing functionality is supported through /customaudiencesendpoint.

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 usead.id, adset.id and campaign.id
• Remove cpc and clicks fields in Insights API. Newly added related metrics includeinline_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.