React Native Apple Search Ads

Apple Search Ads support in React Native 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

AppActor.instance.enableSearchAdsTracking(
  new AppActorAsaOptions(true, false, true)
);

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

React Native exposes iOS-only helpers:

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

These methods intentionally throw or return unsupported-platform results on non-iOS platforms, so branch by platform before calling them 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