AppActor Apple Ads combines three pieces: Apple calls the platform “Apple Ads” now. Some AppActor and Apple UI still says “Apple Search Ads” or “ASA”; in these docs they refer to the same acquisition channel.

​
1. Create Apple Ads API credentials

In Apple Ads, create API credentials that can access campaign reporting:
  • Client ID
  • Team ID
  • Key ID
  • private .p8 key
  • Apple Ads organization
Use an Apple Ads account with the right API access role. Keep the private key secret and rotate it if access changes.

​
2. Add the connection in AppActor

In AppActor dashboard:
  1. Open Settings.
  2. Go to Apple Search Ads.
  3. Add a connection.
  4. Enter Client ID, Team ID, Key ID, and the private key.
  5. Verify credentials.
  6. Select the Apple Ads organization.
  7. Bind the connection to the iOS app that should import Apple Ads data.
The connection is reusable across apps in the same organization when that matches your account setup.

​
3. Enable SDK attribution

The dashboard connection imports Apple campaign reporting. The SDK attribution helper links Apple Ads acquisition context to AppActor customers and purchase signals. For native iOS:
For wrappers, register tracking before wrapper configure so startup can enable the native helper:

​
4. Wait for first attributed install

The Apple Ads dashboard stays empty until AppActor sees a matching iOS attribution signal and the reporting import has data to join. If the app shows “ASA SDK not integrated”, verify the iOS helper and wait for the first attributed install.

​
Diagnostics

Use platform diagnostics when data is missing:
  • iOS: asaDiagnostics()
  • Flutter: getAsaDiagnostics()
  • React Native: getAsaDiagnostics()
  • dashboard: Apple Ads connection verification and app binding
Apple Ads attribution enriches analytics and acquisition reporting. It does not grant premium access. Entitlements remain the authority for access.

​
Next

Apple Ads Analytics

Read the campaign, ad group, keyword, spend, CPA, and ROAS metrics AppActor reports.