Marketing API v2.8

Released October 5, 2016 | Available until July 26, 2017

• New Features
• Changes
• Deprecations
• 90-Day Breaking Changes

---

New Features V2.8

• Instant Articles
• Facebook Offers

Instant Articles

• There 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 select feed as a position and for device_platforms select mobile since Instant Articles is for mobile only.

Facebook Offers

• Redesigned and 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 the promoted_object for an ad set.
  • To learn more see Offer Ads and Language Reference, Page Native Offers.

---

Changes V2.8

• Ads Management
• Ads Insight
• Business Manager

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 following rule contains 3 comparisons:

{
  "or": [
    {
      "url": {
        "i_contains": "shoes"
      }
    },
    {
      "and": [
        {
          "event": {
            "eq":"ViewContent"
          }
        },
        {
          "price": {
            "gte": 100
          }
        }
      ]
    }
  ]
}

• 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 under link_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 ManagerBusiness Manager] or Business Manager API with business_management extended permission, see Business Manager API, Overview.
• The edge AD_ACCOUNT/audiences has been deprecated.
• The ad_object_by_url field for /search in (/docs/marketing-api/targeting-search/v2.7)[Ad Targeting Search] has been deprecated.
• The fields actor_image_hash, actor_image_url, place_page_set_id and actor_name have been deprecated from ad creative GET.

Ads Insights

• We deprecated the redundant fields and parameters in /insights endpoint POST requests. - In earlier releases it supported the params: fields,summary, default_summary, filtering and sort. 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 were string such as impressions, some were numericstring, and some were floats. We now return all numeric fields, including floats as numericstring. All floating point numbers will maintain six precision points.
• The insights metric post_like in the actions field is now named post_reaction, see Ads Action Stats, Reference. 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.

---

Deprecations V2.8

There are no deprecation.

---

90-Day Breaking Changes V2.8

There are no 90 Day Breaking Changes.