We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.
Once you have successfully integrated the SDK and the AdServices framework, Apple Ads Attribution data is measured automatically. The Apple Ads Attribution API measures and attributes app installs from your Apple Search Ads campaigns. With Adjust’s Search Ads integration, you can view data from the Attribution API in Adjust.
Here’s how Adjust works with the Attribution API.
The app (via the Adjust SDK) requests a token from the AdServices Framework.
The AdServices Framework returns an Apple Ads Attribution token. This token comes in the form of a string with a 24-hour TTL (time to live).
The token is then passed to Adjust.
Adjust requests an attribution response from Apple’s server.
Depending on the user's consent, Apple sends either a standard or detailed payload attribution response to Adjust.
Detailed response types contain a click time (rounded to the minute).
Standard
Users who have not opted in
Standard response types do not contain a click time.
It is not possible for Adjust to discard standard response engagements that happen outside of the 30-day Apple attribution window. As this response type does not return a timestamp, it cannot be linked to the attribution window you set in Adjust. This also means the {click_time} placeholder cannot be populated.
Note:
The Apple Search Ads Attribution payload does not contain a campaign, adgroup, keyword, and/or creative set name. Ensure that you have linked your Apple Ads account in DataWorks > Connections to pull these campaign details.
How does Adjust measure installs with Apple Search Ads?
Since API integrations don’t use Adjust link URLs, we send SANs every app session our SDK reports. If Apple Search Ads recognizes the activity, they respond with attribution information, that is, campaign details such as campaign, adgroup, keyword, and/or the creative set name. Following our own attribution method, Adjust then uses the engagement data from all networks (including non-SANs) to attribute the install to the last measured source.
If you ONLY integrate the Adjust SDK and the AdServices framework in your app, we can measure installs and subsequent sessions/ events for Apple Search Ads. However, we display the parameter IDs without names. For more information, see our Reporting article.
What Apple Search Ads campaign data is passed to Adjust?
In Adjust, your Apple Search Ads campaign data automatically appears as:
* If the iad-keyword-id is missing, then we didn't receive it from the Apple Search Ads API.
If you want to receive the creative set name and the creative set ID for your Apple Search Ad campaigns, add the {iad_creative_set_name} (creative set name) and the {iad_creative_set_id} (creative set ID) placeholders to your raw data exports. This data does not appear in Datascape.
