Apple Search Ads Data Connector

Learn how Singular pulls data from Apple Search Ads and displays it in your reports.


Quick Details

Data Connector Technology API (Apple Search Ads API v. 2 - see documentation)
Data breakdown (segmentation)

Data from Apple Search Ads is broken down by:

  • Campaign
  • Sub-Campaign (Ad Group)
  • Country

In addition, you can choose one of the following breakdowns:

  • Keyword (search keyword) - default
  • City and Region

If you're interested in the City and Region breakdown instead of the keyword breakdown, reach out to your Customer Success Manager or Singular support.

How far back we pull data 30 days
Time zone By default, Singular pulls data in the original time zone you have defined in the Apple dashboard. Contact us if you want your data to be pulled in UTC.
Is data available on the creative level? Yes
Does Singular show your creative assets? No (the Apple Search Ads API does not provide access to the creative assets)

Data Mapping

  • Singular's Sub-Campaign corresponds to Apple's Ad Group.
  • The Publisher field is not populated for this data connector since the publisher is Apple Search Ads.

  Field in Singular UI Field in Singular API Field in Apple
Campaign Dimensions Account ID adn_account_id orgID
Campaign Dimensions App app appName
Campaign Dimensions App Site ID app_site_id adamId
Campaign Dimensions City
Campaign Dimensions Country country_field countryOrRegion
Campaign Dimensions Date date_field date
Campaign Dimensions Keyword keyword searchTermText OR keyword
Campaign Dimensions Keyword ID keyword_id keywordId
Campaign Dimensions Network Campaign ID adn_campaign_id (campaign) id
Campaign Dimensions Network Campaign Name adn_campaign_name (campaign) name
Campaign Dimensions Network Creative ID adn_creative_id creativeSetId
Campaign Dimensions Network Creative Name adn_creative_name creativeSetName
Campaign Dimensions Network Sub Campaign ID adn_sub_campaign_id (adGroup) id
Campaign Dimensions Network Sub Campaign Name adn_sub_campaign_name (adGroup) name
Campaign Dimensions OS os Always "iOS" (hardcoded)
Campaign Dimensions Public Id site_public_id adamId
Campaign Dimensions Region
Campaign Dimensions Scraped App app_name appName
Campaign Dimensions Target Countries target_countries_str storeFrontCountryCodes
Campaign Dimensions Timezone adn_timezone timeZone
Creative Dimensions Creative ID creative_id creativeSetId
Creative Dimensions Creative Name creative_name creativeSetName
Metrics Network Clicks adn_clicks taps
Metrics Network Impressions adn_impressions impressions
Metrics Network Installs adn_installs installs
Metrics Original Cost adn_original_cost amount
Metrics Original Currency adn_original_currency currency
Was this article helpful?