Breaking Changes Log

April 2020

curl "https://adsapi.snapchat.com/v1/adsquads/079abe5b-8aa3-4009-9932-66e0b0a2c75c?return_placement_v2=true" \
  -H "Authorization: Bearer  meowmeowmeow"

Example, this Ad Squad using multi-country targeting is targeting the US and Canada:

{
  "request_status": "SUCCESS",
  "request_id": "5e821b1100ff00ff5566930ea67e0001737e7465616d6b6f363139000161646d616e616765722d6170693a6275696c642d61643137333166302d312d3333382d3000010145",
  "adsquads": [
    {
      "sub_request_status": "SUCCESS",
      "adsquad": {
        "id": "079abe5b-8aa3-4009-9932-66e0b0a2c75c",
        "updated_at": "2020-03-10T20:34:09.826Z",
        "created_at": "2020-03-10T20:33:58.614Z",
        "name": "Multi country Ad Squad Example",
        "status": "ACTIVE",
        "campaign_id": "f5b84e48-dc8b-4ddb-bf9b-edf07fadd6c6",
        "type": "SNAP_ADS",
        "targeting": {
          "regulated_content": false,
          "demographics": [
            {
              "languages": ["en"]
            }
          ],
          "geos": [
            {
              "country_code": "us",
              "operation": "INCLUDE"
            },
            {
              "country_code": "ca",
              "operation": "INCLUDE"
            }
          ],
          "enable_targeting_expansion": true
        },
        "targeting_reach_status": "VALID",
        "placement_v2": {
          "config": "AUTOMATIC"
        },
        "billing_event": "IMPRESSION",
        "bid_micro": 1000000,
        "auto_bid": false,
        "target_bid": true,
        "bid_strategy": "TARGET_COST",
        "daily_budget_micro": 50000000,
        "start_time": "2019-12-17T01:38:19.961Z",
        "optimization_goal": "APP_INSTALLS",
        "delivery_constraint": "DAILY_BUDGET"
      }
    }
  ]
}

Multi-country targeting

Multi-country targeting is available through the API starting April 1st! This will enable advertisers to set up Ad Squads targeting any combination of countries across the world.

Multi-country targeting will help extend reach and optimize ads globally to the best audience. While setting up multi-country Ad Squads has its advantages, we do not guarentee evenly distributed delivery. If you want to test audiences between countries, then we advise that you set up separate Ad Squads.

This will launch broadly in Ads Manager in late April, and you will start to see more Ad Squads with multiple geos objects within their targeting_spec as this rolls out. Each country needs to be placed in a geos entry, a targeting spec that uses multi-country targeting needs to also include a demographics entry that incorporates a single languages entry.

If your app is updating the targeting_spec of the AdSquad entity you should take multi-country targeting into consideration to allow multi-country.

March 2020

We are introducing breaking changes to our API. The deprecation date will be 90 days after the announcement date, with final end of life for legacy APIs and fields two weeks after the sunset date.

Deprecation of Insight parameters dimension and pivots

Deprecation Schedule
Announcement Date: March 20th, 2020
Sunset Date: June 20th, 2020

• The parameters dimension and pivots as described in the following section will be deprecated.
• The new parameter report_dimension offers the same functionality with the added benefit of supporting DAY, TOTAL and LIFETIME granularity.
• Delivery Insights via report_dimension are only available from January 1st, 2020.
• After the deprecation you will still be able to use dimension and pivots to retrieve data finalized prior to the 20th June 2020.

New bid_strategy attribute replaces auto_bid and target_bid

Deprecation Schedule
Announcement Date: March 20th, 2020
Sunset Date: June 20th, 2020

• The new bid_strategy attribute replaces the attributesauto_bid and target_bid
• bid_strategy is an enumeration that holds the bid method for the Ad Squad
• Apps should be adjusted to use only bid_strategy on Creation and Update requests, the attributes auto_bid/target_bid should not be sent in requests
• During the 90 day transition period bid_strategy will co-exist with auto_bid and target_bid
• See section on bid_strategy

Deprecation of placement in favour of placement_v2

Deprecation Schedule
Announcement Date: March 20th, 2020
Sunset Date: June 20th, 2020

• All Ad Squads are required to use placement_v2
• The attributes at included_content_types and excluded_content_types at AdSquad level will be deprecated in favour of the attributes inclusion and exclusion defined in placement_v2
• During the 90 day transition period placement will co-exist with placement_v2
• See section on placement_v2 for full information on how to implement