Apple Search Ads Data Connector

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

Updated Aug 18, 2021: Updated API version, additions to the data mapping table.

 

Quick Details

Data Connector Technology API (Apple Search Ads API v. 4)
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

Tips:

  • 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.
  • For descriptions of each field in Singular reporting, see the Singular Metrics and Dimensions Glossary

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