S2S – Adjust
Discover the most-read articles
Adjust is a mobile attribution platform. Combined with Affilae’s Server-to-Server tracking, it lets you track the installs and in-app events your affiliates generate. Affilae records the click, Adjust does the attribution, then sends the conversions back to Affilae.
How it works
- The visitor clicks an Affilae tracking link.
- Affilae records the click and sends the visitor to your Adjust link. That link carries Affilae’s callback address, in which Affilae puts the click ID.
- Adjust does the attribution, not Affilae.
- When a user attributed to that link completes a configured event, Adjust calls Affilae’s callback.
- Affilae matches the conversion to the click and computes the commission.
Step 1, create an Adjust link for Affilae
- In Adjust, open Campaign Lab > Custom links and create a new link dedicated to Affilae.
- In the link’s destinations, choose where visitors without the app go: the store, by default, or your website, with a redirect (redirect). For those who cannot install it, on desktop in particular, enter an address of your website (fallback). Affilae will replace these addresses with the page chosen by the affiliate.
- Copy the full link, with its adj_t parameter, not its short version: on a short link, Adjust does not accept a change of redirect, and visitors sent to your website would not land on the page chosen by the affiliate.
The full link looks like this:
Step 2, add the Affilae callback to the link
Adjust sends conversions back to Affilae through callbacks added to the link, one per event you want to reward.
- In Affilae, pick the commission rule for app sales and note its Key. We recommend a rule dedicated to the app, separate from your website rules.
- In Adjust, note the token of the event to reward (event token), for iOS and for Android.
- Prepare the callback URL below, replacing YOUR_AFFILAE_KEY with the rule’s key.
- Add this callback to your link with Adjust’s Encoding tool, entering the event’s iOS and Android tokens. The tool adds an adj_event_callback_… parameter to the link (event_callback_… on an app.adjust.com link).
| Parameter | What it does |
|---|---|
| key | The key of the Affilae commission rule |
| id | The conversion identifier: {adid} (the device) and {created_at} (the event time) |
| cids | The click ID. Keep {ClickID} as is: Affilae fills it in on every click. |
| amount | The sale amount, in currency units: {revenue_float} |
| currency | The sale currency: {currency} |
To reward installs too, add an install callback the same way (adj_install_callback), with the key of a rule dedicated to installs.
The attribution window
A callback is only matched to the affiliate’s click if that click is more recent than the rule’s Tracking duration (in days) when the callback reaches Affilae. A later in-app purchase is not matched to the affiliate, even if Adjust still sends the callback. Pick that duration according to how long after the click you want to reward purchases.
Users who already have the app
A user who already has the app and clicks an affiliate link is only attributed to that link if Adjust reattributes them. Reattribution is set in your app’s attribution settings (AppView, Attribution settings tab), and a user is only reattributed if they have not opened the app during the Inactivity period (7 days by default). Otherwise, their purchases stay attributed to their original source, and the Affilae callback does not fire.
To credit your affiliates for these users too, check that reattribution is on, then, in Campaign Lab > Custom links, open the Affilae link, Attribution settings tab, and set the Inactivity period to 0. If you only want to reward new users, keep your current settings.
Step 3, configure Affilae
- In Affilae, open Configuration.
- Global settings section: check that the program’s URL format is set to Server-to-Server (S2S).
- Then, URL tracking management section: turn on Redirect clicks through an attribution partner (advanced). The next two fields only appear once it is on.
- Paste your Adjust link, callbacks included, into Partner redirection URL.
- In Landing page query parameter, enter the parameters of your link that hold an address of your website, separated by commas: adj_redirect, adj_fallback or adj_deep_link, depending on your link. If adj_deep_link receives a web address, your app must be able to open the matching page.
- Click Save.
Step 4, the final test
The test replays a customer’s journey: a click on an affiliate link, the app install, then a purchase. Run it on a phone, never on a computer.
Prepare the test
- A test partnership in Affilae, to generate the link. Your app rules must apply to its group.
- A phone “forgotten” by Adjust. Adjust attributes one install per device. The Adjust Insights app gives you the phone’s advertising ID. Before each test, uninstall the app, then, in Adjust, open the Testing Console, enter that ID, click View device data, then Forget device.
- On iPhone, open Settings > Privacy & Security > Tracking, turn on Allow Apps to Request to Track, then accept your app’s tracking request. Depending on the privacy model chosen in Adjust, a user who has not allowed tracking may trigger no callback.
- One person, one phone at a time, from the country your program targets. Write down the time of each action.
The test, step by step
| # | Do | Check |
|---|---|---|
| 1 | In Affilae, open the Link builder, pick the test partnership and a page of your website, then copy the Tracked link. | The link starts with https://lb.affilae.com/r/ and contains your Adjust link in encoded form: that is normal, do not edit it. |
| 2 | Send the link to yourself by text message or email, and tap it on the phone. | In Affilae, program menu, Clicks: a new row shows up within seconds, with your test partnership. |
| 3 | The store opens: install the app, then open it. | In Adjust, Testing Console, View device data: in the attribution information, Link name is your Affilae link. Allow up to 30 minutes. |
| 4 | Make a purchase in the app and write down the time. | In the Testing Console, the last event date (Last event times) is updated. Adjust does not show callbacks there: the next check is in Affilae. |
| 5 | In Affilae, open Conversions and find the conversion at the time of your purchase. | It shows up with its amount and your test partnership. Its Conversion funnel shows the click from step 2. |
| 6 | Refuse the test conversion: tick it, click Refuse, choose the Test order or tracking error reason, then click Confirm. If it is locked, refusing is no longer offered: on 2026 plans, select it and click Contest; otherwise, contact support. | A test conversion is still a real conversion, with a commission to pay. Details in Testing click and conversion tracking. |
If something does not come through
| What you see | What to check |
|---|---|
| No click in Clicks | The link comes from the Link builder and was not edited. The program is in S2S, with Redirect clicks through an attribution partner (advanced) on and both its fields filled in. |
| The link opens your website instead of the store | You are testing on a computer, or your link redirects visitors without the app to your website (redirect): that is then the expected behavior. |
| The install is not attributed to the Affilae link | The phone was not forgotten in the Testing Console, tracking is not allowed on the iPhone, or the install happened after Adjust’s attribution window (7 days by default). |
| Install attributed, but no conversion in Affilae | The event callback is missing from the link, or carries the token of another event or platform; the Key belongs to another program’s rule; the rule does not apply to the test partnership’s group; the currency sent is not one of the rule’s Currencies; or the test was run outside the targeted country. Otherwise, contact us (below). |
| A user who already had the app is not attributed | Reattribution is off, or the link’s Inactivity period is not 0 (see step 2). |
| Conversion at €0 | In-app revenue is not on in Adjust, the app does not send the amount with the purchase, or the callback does not use {revenue_float}. |
| Amount 100 times too high | The callback uses {revenue} instead of {revenue_float}. |
| A second purchase is missing | The id parameter does not contain {created_at}. |
| Visitors do not land on the page chosen by the affiliate | The link pasted into Affilae is a short link, or the parameter holding your website address is missing from Landing page query parameter. |
Key points
- The Affilae program must be in S2S.
- One Adjust link dedicated to Affilae, with one callback per rewarded event.
- The callback carries cids={ClickID}, amount={revenue_float} and an id unique to each conversion.
- Revenue sharing (In-app revenue) must be on in Adjust.
- A purchase is only matched to the affiliate within the rule’s Tracking duration, counted from the click.
- Inactivity period at 0 to also credit users who already have the app.
- The Adjust link is pasted into the program configuration, never given to affiliates.
- Testing is done on a device forgotten in the Testing Console, on iPhone with tracking allowed.
Related articles
- S2S, Server-to-Server
- S2S – AppsFlyer
- Affilae tracking fundamentals
- Testing click and conversion tracking
- All available integrations
Frequently asked questions
Voir plus de questions reponses
S2S switches your links to redirection and validates the conversion server side. That is what lets Adjust send conversions to Affilae. Without that setting, the integration cannot work.
In Affilae, open Configuration, Tracking tab, expand Integration via an Affilae plugin and pick the rule in Rules and currencies: its Key appears.
Check three things: revenue sharing is on in Adjust (Dynamic ad network data access > In-app revenue), the app sends the amount with the purchase event, and the callback uses {revenue_float}.
{revenue} gives the amount in cents, {revenue_float} in currency units. Affilae expects units: 24.99 for €24.99.
The id most likely stays the same from one purchase to the next. Affilae counts one conversion per identifier and per rule: use id={adid}_{created_at}.
No. Paste it into your program configuration: the Link builder adds it automatically to your affiliates’ tracked links. An Adjust link shared as is, or inserted by hand into an Affilae link, may not record clicks and conversions.
No. The callbacks added to the link only fire for users attributed to that link.
