Apple Search Ads Attribution Integration

Integration Summary

Partner Apple Search Ads
Partner Type Self-attributing Ad Network (iOS Only)
Creatives Supported
Publisher Not Supported
View-Through Supported
Re-engagement Supported by request
Click Tag No (Self-attributing)
Receiving All Installs N/A
Receiving All Events N/A


Introduction to Apple Search Ads

Apple Search Ads is a unique self-attributing integration utilizing the Apple Attribution API accessed via the Singular SDK retrieve advertising information for any ad click as detected by Apple.  As such, a Partner Configuration is not required and no postbacks are involved in the integration

Installs from Apple Search Ads are fed through Singular last click attribution methodology.


  1. Integrate the Singular iOS SDK and ensure the iAd and AdSupport frameworks are included (see instructions). 


Reporting on Apple Search Ads Installs

Singular reports use the values as named in your Apple Search Ads campaigns. You can also use special keywords to provide even more insights into how your users are acquired.

Apple Search Ad values are mapped to Singular reporting dimensions as follows:

Singular Value Apple Search Ads Value Example
Tracker Campaign Name Campaign Name “MyCampaign”
Tracker Campaign ID Campaign ID 12345678
Tracker AdGroup Name AdGroup Name “MyAdGroup”
Tracker AdGroup ID AdGroup ID 98123747
Source Apple Search Ads “Apple Search Ads”
Keyword Keyword “bubbles”

When you run a report in Singular, Apple Search Ads will also match the SDK data with the spend data provided by Apple Search Ads API, including:

  • Spend by Campaign
  • Spend by Keyword

To start pulling marketing data from Apple Search Ads, add a data connector for Apple Search Ads in the Data Connectors page. See the Data Connectors FAQ for more information.


Discrepancies with Apple Search Ads may be due to various reasons:

  • Definition of Apple's 'download' is the moment the user clicks "download", where as Singular's definition is counted only when the user opens the app for the first time

  • Limit ad tracking (LAT) users are not trackable by attribution providers, while reporting on these attributed users is supported in Apple's reports

For more details on differences between the reported numbers by Apple Search Ads and Singular, see Apple's Mobile Measurement Providers page.

Was this article helpful?