We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.
Sessions are the base of all attribution and tracking in Adjust. They trigger when a user resumes using an app from the background or when they open the app. Use the S2S Session API to track each user session in your app.
Warning:
Adjust needs to turn this feature on for you. Contact your Technical Account Manager or support@adjust.com to proceed.
Set up S2S Security to guarantee the security of your S2S sessions and protect against spoofed requests. This requires each incoming request to carry an authentication token generated in your Adjust dashboard. Requests that do not carry the token or that carry an incorrect token are rejected by our server.
Adjust groups sessions to save resources. This means there must be a gap of at least 30 minutes after a session, before the Adjust server accepts a new session as triggered.
The only required parameter in the payload is s2s. Find the full list of parameters in the table below.
Parameter
Description
Example
s2s
REQUIRED
Server-to-server parameter: allows Adjust servers to recognize server-side activity. Must always be sent as 1.
1
app_token
Unique authentication token for your app
pezwd5bre2xb
vida
Vizio advertising identifier, Vizio only
dca2365e-0d78-47c6-aaac-9567846c6c9e
rida
Roku advertising identifier, Roku only
tifa
Tizen OS advertising identifier, Samsung only
idfa
iOS advertising identifier, iOS only
29DDE430-CE81-4F00-A50C-689595AAD142
idfv
iOS vendor identifier, iOS only
59E27F41-A86B-4560-B585-63161F871C4B
gps_adid
Google Play advertising identifier, only sent if Google Play Services library is added. Android only
6cf94580-46c2-490c-b882-2f6ae269b579
oaid
Open Advertising ( Anonymous ) identifier
ed799bac-2537-6122-377a-edebce5db5a5
imei
International Mobile Equipment Identity
490154203237518
android_id
Android identifier, only sent if gps_adid is not present. Android only
e11a8c233efb29f3
persistent_ios_uuid
Same as ios_uuid, but saved in Keychain so that re-installed apps will have same value, iOS only
3b35fcfb-6115-4cff-830f-e32a248c487d
app_version
This parameter represents build number in iOS and actual app version in Android.
1.0
app_version_short
The release represents actual app version number in iOS, iOS only
1.0
session_count
Number of tracked sessions including current one.
1
subsession_count
Number of sub-sessions tracked. First session ever tracked (Install) doesn't contain this parameter. Every subsequent session contains number of sub-sessions for previous session.
1
session_length
Length of session in seconds. First session ever tracked (Install) doesn't contain this parameter. Every subsequent session contains length of the previous session.
123
time_spent
Time spent active during previous session
123
tracking_enabled
Indicates whether the user has limited ad tracking enabled
1
bundle_id
The bundle identifier, iOS only.
com.adjust.example
package_name
The package name, Android only.
com.adjust.example
environment
“sandbox” for testing or “production” for live traffic