Update conversion values for S2S events
If you record in-app events on your server, you can forward these to Adjust as server-to-server (S2S) events. This way, Adjust lets you measure conversion values for both S2S events and events recorded using the Adjust SDK.
Adjust uses your conversion value configuration to map events to conversion values. Depending on your configuration, either the Adjust SDK or your app sends the conversion value updates to Apple.
- In SKAN 3, we recommend recording events via the SDK to update conversion values. This ensures the communication with Apple happens before the Apple timer lapses.
- In SKAN 4, the timing is less critical as there are 3 measurement windows. If it is important to you that the conversion value update reaches Apple in the same window as the event was recorded, then you should use the SDK to record events.
How it works
There are three steps that S2S events follow:
- Your server records an event and sends it to Adjust as a S2S event.
- The Adjust backend calculates the conversion value.
- Adjust sends this conversion value to your server as a S2S response.
There is no difference in how events are sent via our API for the purpose of updating conversion values. It uses exactly the same API call as for the standard sharing of events server-to-server.
Working asynchronously
The Adjust backend cannot initiate a connection with the Adjust SDK. Working asynchronously, the Adjust backend waits until it receives a request from the Adjust SDK. Once received, the Adjust backend sends the updated conversion value as a response to the SDK request.
To use this feature you need to have the Adjust SDK implemented in your app.
- Your server records an event and sends it S2S to Adjust.
- The Adjust backend uses the S2S event and any other applicable activities to calculate the latest conversion value.
- If the latest conversion value is greater than the conversion value currently stored on the Adjust backend, then the Adjust backend updates the stored conversion value.
- If applicable, the Adjust SDK sends an incidental, unrelated request to the Adjust backend (for example, a user triggers an SDK session or SDK event).
- The Adjust backend re-calculates the conversion value as described in step 2 and sends the stored conversion value in its response to the Adjust SDK.
- The Adjust SDK updates the conversion value via SKAdNetwork.
With an asynchronous approach there is no way to communicate with the app in real time, as it has not initialized the connection yet.