Adjust integration for Tapper Block
Connect Adjust to Tapper Block to detect and record invalid installs, sessions and in-app events from your Adjust callbacks.
Connecting Adjust to Tapper Block takes two steps: add the app in Tapper and switch on Block for it, then add Tapper's callback address as a global server callback in Adjust. No SDK changes are needed.
Tapper detects and records the invalid installs, sessions and in-app events in your Adjust callbacks. It rejects nothing in Adjust, so your Adjust data stays as Adjust recorded it: see What happens to an invalid install.
What you need from Adjust
| Credential | Where to find it |
|---|---|
| Adjust App Token | Adjust Suite → AppView → All apps → your app → App settings. A 12-character token that identifies the app. |
| Adjust API Token | Adjust Suite → Account Settings → My account → API token. Block does not need it; Counting (Lift) reads your Adjust totals with it unless you invite Tapper as a Reader. Treat it like a password. |
Create the integration in Tapper
Open Setup > Mobile app. With no app yet, the page opens on the add form; otherwise click Add app at the end of the list on the left. Enter a Name, tick the Platforms, choose Adjust as the Tracking tool, enter your Adjust App Token and click Add app. On a new workspace, Add mobile app on the Mobile app row of the connect step opens the same form.
On the Block card, under Access, turn on the switch. The dialog asks for nothing: click Switch on. Tapper makes a callback address and a secret.
The dialog shows the Secret and the Callback address, with the secret hidden in it until you click the eye icon, and the Adjust steps. Click the copy icon next to Callback address. You paste it into Adjust next.
The address carries your secret and every Adjust placeholder Tapper reads, so paste it as it is. The secret is shown only in this dialog; afterwards the Access card keeps a preview.
Configure the callback in Adjust
In Adjust, go to AppView → All apps, select your app, then open Server callbacks.
Click Add callback, then Guided setup. Select Global as the callback trigger.
Paste your Tapper callback address and set the method to GET.
Leave Add a condition empty, so the global callback keeps firing for every trigger Adjust measures, organic included.
A condition on {network_name} narrows the callback to that network. Until campaigns attributed to Tapper exist, Tapper then receives zero events and the integration looks broken while it is only filtered.
If the integration shows no events but test callbacks succeed, check this first.
Click Create callback URL.
Back in Tapper, the app's Block card shows Waiting for first install until Adjust sends its first callback, then Receiving events or Receiving installs.
Wiring Branch, AppsFlyer or Kochava as well? Each of those needs its own all-events setting: see Send all events, not only attributed. Adjust needs only the empty condition above.
Tapper Lift and Adjust
Block sends no numbers to Tapper Lift. To compare your Adjust numbers in Lift, switch on Counting (Lift) for the same app under Setup > Mobile app. It has its own switch and reads Adjust with the API token on the Access card or through Tapper's Reader invite. See Lift Adjust integration.
What data is captured
On every callback, Tapper receives these fields from Adjust:
- Attribution: network, campaign, ad group, creative, tracker and match type.
- Activity type: install, reinstall, session, reattribution or in-app event, with the event name and token.
- Click identifiers: Adjust
click_id,gbraid,wbraid,fbclid,fb_fingerprint_id,labelandreftag, used to match the event back to its click. - Device: IDFA, IDFV, GAID, Android ID, OAID, device name and type, OS, OS version, language and store.
- Location: IP address, country, region and city.
- Timing: click time, install begin time, install time and the time Adjust created the event.
- Revenue and cost: revenue and currency, cost type, amount and currency.
- Rejection data: Adjust's rejection reason and its source.
Google Ads, Meta, TikTok and Snapchat app campaigns
Tapper does not offer click tracking links for Google Ads, Meta, TikTok or Snapchat. Their installs reach Tapper through your Adjust global callback, like every other network's.
Callback security
Tapper checks the secret on every callback and refuses a callback without the right one.
The secret travels in the callback URL, as the secret parameter right after the ?. The Callback address on the app's Access card is the same URL without the secret. If you ever build the callback in Adjust from that address, add secret= and your secret, followed by &, right after the ?. A secret with characters other than letters and digits must be URL-encoded there.
Lost the secret? On the app's Access card, click Replace next to Secret. Type a new one of at least 32 characters or click Generate, then click Replace. The old secret stops working at once and the new one is shown once. In Adjust, replace the value after secret= in the callback URL with the new secret. Until you do, Tapper refuses Adjust's callbacks.