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:
In addition, you can choose one of the following breakdowns:
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 |
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 |
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 |
