Skip to main content

Apple Search Ads

This page contains the setup guide and reference information for the Apple Search Ads source connector.

Setup guide

Step 1: Set up Apple Search Ads

  1. With an administrator account, create an API user role from the Apple Search Ads UI.
  2. Then implement OAuth for your API user in order to the required Client Secret and Client Id.

Step 2: Set up the source connector in Airbyte

For Airbyte Open Source

  1. Log in to your Airbyte Open Source account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Apple Search Ads from the Source type dropdown.
  4. Enter a name for your source.
  5. For Org Id, enter the Id of your organization (found in the Apple Search Ads UI).
  6. Enter the Client ID and the Client Secret from Step 1.
  7. For Start Date and End Date, enter the date in YYYY-MM-DD format. For DAILY reports, the Start Date can't be earlier than 90 days from today. If the End Date field is left blank, Airbyte will replicate data to today.
  8. Click Set up source.

Supported sync modes

The Apple Search Ads source connector supports the following sync modes:

Supported Streams

The Apple Ads source connector supports the following streams. For more information, see the Apple Search Ads API.

Base streams

Report Streams

Report aggregation

The Apple Search Ads currently offers aggregation at hourly, daily, weekly, or monthly level.

However, at this moment and as indicated in the stream names, the connector only offers data with daily aggregation.

Reference

Config fields reference

Field
Type
Property name
integer
org_id
string
client_id
string
client_secret
string
start_date
string
end_date

Changelog

Expand to review
VersionDatePull RequestSubject
0.1.142024-08-1744322Update dependencies
0.1.132024-08-1243912Update dependencies
0.1.122024-08-1043514Update dependencies
0.1.112024-08-0343195Update dependencies
0.1.102024-07-2742660Update dependencies
0.1.92024-07-2042225Update dependencies
0.1.82024-07-1341722Update dependencies
0.1.72024-07-1041546Update dependencies
0.1.62024-07-0940832Update dependencies
0.1.52024-06-2540364Update dependencies
0.1.42024-06-2240186Update dependencies
0.1.32024-06-0438967[autopull] Upgrade base image to v1.2.1
0.1.22024-05-2138502[autopull] base image + poetry + up_to_date
0.1.12023-07-1128153Fix manifest duplicate key (no change in behavior for the syncs)
0.1.02022-11-1719557Initial release with campaigns, adgroups & keywords streams (base and daily reports)