# How to Apple Search Ads API Attribution Source: https://www.youtube.com/watch?v=jSPER6mm9ho Recap page: https://rapidrecap.app/video/jSPER6mm9ho Generated: 2025-11-21T20:03:59.479+00:00 --- ## Quick Overview The process for setting up Apple Search Ads API Attribution involves obtaining an API user key and team ID from Apple Search Ads, generating a secure key pair in App Ad Metrics, copying the public key to Apple Ads settings, and then inputting the client ID, team ID, and key ID back into App Ad Metrics to establish a connection that enables tracking of campaign performance and revenue data. **Key Points:** - The setup requires navigating to 'User Management' in Apple Search Ads Account Settings to invite a new API user with 'API Account Manager' permissions (0:51). - The user must generate a secure key pair in App Ad Metrics by clicking 'Generate Repair' (1:49), which provides a public key for upload. - The generated public key must be copied from App Ad Metrics and pasted into the 'Public Key' field under the 'API' section of the Apple Search Ads Account Settings (1:59). - After saving the public key in Apple Ads, the user retrieves the Client ID, Team ID, and Key ID from the Apple Ads 'API' settings screen (2:08). - These three credentials (Client ID, Team ID, Key ID) are then entered into the 'Enter Apple Ads API Credentials' section within App Ad Metrics to finalize the connection (2:17). - RevenueCat integration is completed by setting up a webhook in App Ad Metrics, copying the provided Webhook URL and Authorization Header, and pasting them into the RevenueCat dashboard settings (3:03). - Once both integrations are connected, App Ad Metrics begins syncing Apple Search Ads campaign data and tracking subscription revenue events from RevenueCat (2:34, 2:58). ![Screenshot at 0:40: The initial step of the tutorial shows the user navigating to 'Account Settings' and selecting the 'User Management' tab within the Apple Search Ads interface to begin setting up API access.](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-00-40.png) **Context:** This video provides a step-by-step tutorial on setting up Ad Attribution between Apple Search Ads and the App Ad Metrics platform, utilizing Apple's API for data synchronization. The process requires creating a dedicated API user in Apple Search Ads, generating necessary credentials (Client ID, Team ID, Key ID, and a public key), and mapping this information between the two platforms to ensure accurate tracking of ad spend against subscription revenue captured by RevenueCat. ## Detailed Analysis The tutorial demonstrates how to establish ad attribution by connecting Apple Search Ads data to the App Ad Metrics platform, which also integrates with RevenueCat for subscription revenue tracking. First, the user navigates to Apple Search Ads Account Settings, clicks 'User Management', and invites a new API user, assigning them the 'API Account Manager' role (0:51). Next, within App Ad Metrics, the user generates a secure key pair (1:49), copies the resulting Public Key, and pastes it into the corresponding field in the Apple Search Ads 'API' settings screen, clicking 'Save' (2:24). The user then returns to Apple Ads settings to find and copy the Client ID, Team ID, and Key ID (2:08). These credentials are then pasted into the 'Enter Apple Ads API Credentials' section in App Ad Metrics, and the connection is finalized by clicking 'Connect to Apple Ads' (2:28), resulting in a 'Connection Complete' status (2:29). The second half of the setup focuses on integrating RevenueCat: in App Ad Metrics, the user navigates to Integrations, selects RevenueCat, and clicks 'Add Webhook' (2:58). The platform generates a Webhook URL and an Authorization Header; these are copied and pasted into the corresponding fields within the RevenueCat webhook configuration screen (3:32). After naming the webhook and selecting environments/events (3:37), the user completes setup in App Ad Metrics (3:44). The final step involves mapping the Apple App Store IDs to the corresponding RevenueCat App IDs in the 'RevenueCat App Mapping' section to ensure revenue data syncs correctly (4:03). Once completed, campaign data flows from Apple Ads and revenue data from RevenueCat into the App Ad Metrics dashboard. ### Apple Search Ads API User Setup - Navigate to User Management in Apple Ads Account Settings - Invite a new API user - Assign 'API Account Manager' role (0:51). ### Key Pair Generation and Upload - Generate secure key pair in App Ad Metrics - Copy the Public Key - Paste and save the Public Key in Apple Ads 'API' settings (1:49, 2:24). ### Credential Retrieval and Connection - Copy Client ID, Team ID, and Key ID from Apple Ads API settings - Enter these into App Ad Metrics' 'Enter Apple Ads API Credentials' screen - Click 'Connect to Apple Ads' (2:08, 2:28). ### RevenueCat Webhook Configuration - Go to Integrations in App Ad Metrics and 'Add Webhook' for RevenueCat - Copy the generated Webhook URL and Authorization Header (2:58, 3:32). ### Finalizing RevenueCat Setup - Paste the URL and Header into the RevenueCat webhook configuration - Select production environment and events - Click 'Complete Setup' in App Ad Metrics (3:37, 3:44). ### Data Mapping - Navigate to 'Apps & Providers' in App Ad Metrics - Map Apple App Store IDs to RevenueCat App IDs in the 'RevenueCat App Mapping' table and save changes (4:07, 4:13). ![Screenshot at 0:10: The introductory slide for App Ad Metrics highlights its core value proposition: seeing which keywords make money and auto-scaling bids with AI, showing key performance metrics like Total Spend \($937.75\) and Total Revenue \($503.79\).](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-00-10.png) ![Screenshot at 0:40: The first step in the process shows the Apple Search Ads 'Account Settings' page, specifically highlighting the 'User Management' tab where the API user must be invited.](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-00-40.png) ![Screenshot at 1:20: The API settings screen in Apple Search Ads displays the 'Client Credentials' section, including the existing Client ID and Key ID, and a field to input the Public Key generated by App Ad Metrics.](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-01-20.png) ![Screenshot at 1:51: App Ad Metrics displays the generated Public Key after clicking 'Generate Repair', with an instruction to copy this key for upload to Apple Ads.](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-01-51.png) ![Screenshot at 2:29: The confirmation screen in App Ad Metrics shows 'Connection Complete' after successfully linking the Apple Search Ads account via API credentials.](https://ss.rapidrecap.app/screens/jSPER6mm9ho/00-02-29.png)