Collecting data from Apple Search Ads

This guide explains how to collect data from Apple Search Ads. To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.

Introduction

For a list of the fields that you can collect from Apple Search Ads, see Apple Search Ads.

Limitations

Collecting data from Apple Search Ads comes with the following limitations:

  • Apple Search Ads can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.

  • You can only create one authorization in Adverity for each Apple Search Ads account. If you create two authorizations with the same Apple Search Ads account, the authorization created first becomes invalid, and all datastreams that use this authorization are not able to collect data.

Prerequisites

Before you start collecting data from Apple Search Ads, perform all of the following actions:

  • Ensure that the account you use to connect to Apple Search Ads has admin rights for the organizations for which you want to collect data.

Creating a datastream to collect data from Apple Search Ads

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Apple Search Ads.

Authorization: Allow Adverity to access Apple Search Ads

To set up a new authorization to fetch data from Apple Search Ads, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Apple Search Ads using your credentials.

  2. Click Next.

  1. If you have access to multiple Apple Search Ads accounts, select the account that you want Adverity to access.

  2. You are directed to the Apple Search Ads login page. Enter your Apple ID to authorize Adverity to access Apple Search Ads.

As a result, Adverity is authorized to access Apple Search Ads. To continue creating your datastream, return to the Authorization step in the datastream wizard and select the newly created authorization from the list.

Configuration: Choose the data you want to collect from Apple Search Ads

To choose what data to collect and customize the Apple Search Ads datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Organizations and Campaigns, select the organizations and campaigns for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Report type, select the type of data to collect from Apple Search Ads.

  1. In Granularity, select the time unit in which you want to retrieve your data.

  1. In Timezone, select the timezone in which the data will be reported. The default value is UTC.

  1. In Group by, select how the data is aggregated. If you leave this field empty, data is not aggregated.

  1. In Fields, change the list of fields that you want to see in your data extract.

What's next?