Apple Search Ads is a first-class platform attribution helper, separate from general attribution fields. Use it when your iOS app should collect Apple Ads attribution signals and attach them to AppActor customer and purchase context. Apple’s current product name is Apple Ads. Some SDK and dashboard surfaces still use Apple Search Ads or ASA naming.

​
Native iOS setup

Configure AppActor first, then enable Apple Search Ads tracking:
Calling the native ASA helper before configure(...) completes can fail because the SDK runtime is not ready yet.

​
Wrapper setup note

Flutter and React Native expose a wrapper-level enableSearchAdsTracking(...) registration that should be called before the wrapper configure(...) call when you want ASA enabled during startup. The wrapper registers the intent early. The native iOS helper still runs after native configure is ready.

​
Diagnostics

iOS-only ASA surfaces include:
  • asaDiagnostics()
  • pendingASAPurchaseEventCount
  • AppActor.asaFirstInstallOnDevice
  • AppActor.asaFirstInstallOnAccount

​
Privacy and product use

Apple Ads data is acquisition context. It should enrich analytics and attribution, but it should not directly grant premium access. Review App Store privacy disclosures whenever your app opts into additional device or advertising identifiers.

Apple Ads Integration

Connect dashboard credentials, bind an app, and enable SDK attribution.

Apple Ads Analytics

Read spend, CPA, revenue, and ROAS for campaigns, ad groups, and keywords.

Flutter Apple Search Ads

Use the Flutter wrapper ASA registration and diagnostics.

React Native Apple Search Ads

Use the React Native wrapper ASA registration and diagnostics.