Connect Apple Search Ads Data to Revenue Sensor
Paste the public key we generate into Apple Ads, copy back the three IDs, and connect one organisation at a time.
Apple Search Ads has no sign-in popup; it authenticates with a keypair. Revenue Sensor generates the keypair for you, you paste the public half into Apple Ads, and Apple hands you three IDs to paste back. The private key is generated on our servers, stays encrypted there, and is never shown to you or sent to Apple.
Before you begin
- An Admin or Account Holder user in Apple Ads (ads.apple.com), in the Advanced console. The Basic console has no API tab.
- A few minutes: this is a two-step handshake rather than a single popup.
Connect the account
- 1
Start the connection
Integrations → Apple Search Ads → Connect in the Revenue Sensor console. The connect step shows a public key. Press Copy.
- 2
Open the API settings in Apple Ads
Open the account menu at the top right, hover the organisation you want to connect and click its Settings link. On Account Settings, open the API tab and find the Client Credentials panel.
- 3
Paste the public key and save
Paste the whole key into Apple's Public Key field, including the BEGIN PUBLIC KEY and END PUBLIC KEY lines, without retyping it or changing line breaks. Click Save, and Apple fills in clientId, teamId and keyId.
- 4
Paste the three IDs back
Copy clientId into Client ID, teamId into Team ID and keyId into Key ID. Client ID and Team ID both start with SEARCHADS. but are different values, so copy each one separately, and watch for a trailing space.
- 5
Continue
We sign a test request straight away and load the organisations this credential can read, so a wrong value fails right away rather than silently.
One organisation per connection
If you manage several organisations, connect them one at a time. Each is its own connection with its own keypair and IDs. Pressing Back re-uses the same keypair, but starting a new connection creates a new one, and the old IDs will not match it.
What gets imported
| Field | Notes |
|---|---|
| Cost / spend | Daily local spend, per organisation, in the account's currency. |
| Impressions and taps | Taps are stored as clicks, alongside impressions. |
| Installs | As reported by Apple Search Ads. |
Spend only
Apple Search Ads is a pure spend source, so revenue is always zero here. Your App Store revenue comes from the Apple IAP connection instead.
Troubleshooting
- Setup fails when you paste the IDs: re-check the three IDs first, then confirm the public key saved in Apple is the one currently shown on the connect step.
- No organisations listed, or partial spend: the API user's role is too limited. In Account Settings → User Management, give it the Account Admin or API Account Manager role, then reconnect.