<!--
{
  "documentType" : "article",
  "framework" : "AdServices",
  "identifier" : "/documentation/AdServices/Changelog",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Changelog"
}
-->

# Changelog

A log of Ad Services framework updates.

## Discussion|Release date   |Release details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|September, 2026|Attribution payload will return `attribution = false` for campaigns using age or gender targeting.                                                                                                                                                                                                                                                                                                                                                                                                                  |
|January, 2026  |A new `supplyPlacement` field has been added to attribution payloads, indicating the ad placement for an Apple Ads campaign.                                                                                                                                                                                                                                                                                                                                                                                        |
|November, 2025 |Apple News is unsupported in iOS 26.1 and later.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|October, 2025  |Introduced attribution support for pre-order app campaigns. Updated the `conversionType` field with a new `preorder` value and an attribution window for both clicks and views. If a pre-order was placed within 30 days from the click or 1 day from the view the lookback window for click-throughs is 90 days. The lookback window for view-throughs is 61 days.                                                                                                                                                 |
|March, 2025    |Introduced view-through attribution on March 27, 2025.  A new attribute, `impressionDate` has been added to payloads for view-through attribution. A new value has been added to the `claimType` field.                                                                                                                                                                                                                                                                                                             |
|November, 2024 |The `claimType` attribute with a value of `Click`, specifying that the app download was from a tap on an ad. Note that the tap-through attribution window is 30 days.                                                                                                                                                                                                                                                                                                                                               |
|May, 2024      |To reduce the rate of delayed attribution responses resulting in 404 errors, the Ad Services API will hold connections for up to 1 second before responding with a 404 error code. Doing this allows more time for the request to be processed and correct data delivered as a part of the response, increasing the number of successful API requests. The impact on the API caller could result in an increased number of client-side connection timeouts in cases if timeout is configured for less than 1 second.|
|March, 2023    |Updated `AdServices` workflow and `AAAttribution/attributionToken()`.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|October, 2022  |Updated `adId` description.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|January, 2022  |Apple Ads no longer supports Creative Sets and `AdGroupCreativeSets`.  Creative Sets API calls return 200 OK responses with an invalid state. Your Creative Sets data remains available through the `AdServices` attribution framework for devices running iOS versions earlier than 15.2 where `creativeSetId` returns in payloads. For devices running iOS version 15.2 and later, `adId` returns in campaigns using a `supplySource` of `APPSTORE_TODAY_TAB` or `APPSTORE_SEARCH_RESULTS`.                       |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)