OnRampOnRamp/Docs

Apple Search Ads integration

Connect Apple Search Ads to see daily campaign and keyword spend next to attributed installs, funnel completion, and revenue.

Before you start

An Apple Search Ads Account Admin must assign the user an API role. That user creates an API client in Account Settings → API. Apple asks for a public key when the client is created.

Connect an account

If another OnRamp app already has the account connected, choose it under Reuse a connected Apple Ads account and click Use existing account. Then select the App Store app for this project. Reuse is available for connected accounts in your organization from apps you can access, and each project keeps its own app selection.

To add a different account, expand Connect a new Apple Ads account and enter its API credentials using the steps below. For an existing connection, Change account opens both options.

  1. Open Integrations then Ad spend.
  2. Select Apple Search Ads and generate a key pair in OnRamp.
  3. Copy the public key into Apple’s API client setup. The matching private key remains in your browser until you connect.
  4. Paste the Client ID, Team ID, Key ID, and private key into OnRamp.
  5. Validate the connection, then select the Apple Search Ads organization for this project.
  6. Click Load apps, choose the App Store ID advertised by this project, and click Use app. The options include a campaign name to help identify each app.

You can connect the same Apple Search Ads account to multiple OnRamp projects, choosing a different App Store app for each. Each project imports only its selected app’s campaigns. Keyword reports apply to Search Results campaigns; other placements still contribute campaign spend.

Use Change app to update an existing connection. Changing the account or app replaces the project’s previous Apple Ads imports and starts a fresh 30-day backfill. Existing connections made before app selection was available must choose an app before syncing again.

The first sync imports the previous 30 days. Daily refreshes re-read the latest three days to capture revised cost data.

Attribution

Apple Search Ads attribution comes from the iOS SDK through Apple AdServices. The spend connection adds campaign and keyword cost to that existing attribution. It does not replace SDK attribution setup.

What you will see

  • Daily campaign and keyword spend
  • Taps and impressions
  • Apple Search Ads acquisition, activation, purchases, CAC, and ROAS where available

If account selection is empty, check that the API role and client belong to an account with Search Ads access.