Flutter Apple Search Ads

Apple Search Ads support in Flutter is a wrapper-level registration for the native iOS AppActor helper. For the product setup, connect Apple Ads credentials in the dashboard and bind the connection to the iOS app before expecting campaign analytics.

Setup order

await AppActor.instance.enableSearchAdsTracking();

await AppActor.instance.configure(
  'pk_YOUR_PUBLIC_APP_KEY',
  appUserId: 'user_123',
);

The wrapper registers the intent early. The native iOS helper still runs after native configure is ready.

Diagnostics

Flutter exposes iOS-only helpers:

getAsaDiagnostics()
getPendingAsaPurchaseEventCount()
getAsaFirstInstallOnDevice()
getAsaFirstInstallOnAccount()

Branch intentionally by platform before calling these helpers from shared code.

Boundary

Apple Search Ads is acquisition context. It should enrich attribution and analytics, not replace entitlement checks.

Apple Ads Integration

Connect credentials and enable SDK attribution.

Apple Search Ads

Read the native iOS setup and diagnostics contract.

​Setup order

​Diagnostics

​Boundary

Apple Ads Integration

Apple Search Ads

Setup order

Diagnostics

Boundary