服务器到服务器 (S2S) 会话 在 Adjust,会话是所有归因和跟踪的基础。当用户打开应用或从后台恢复使用应用时,就会触发会话。您可以通过 S2S 会话 API 跟踪应用中的每一次会话。
Adjust 需要为您启用该功能。请联系您的技术客户经理或发送邮件至 support@adjust.com 来完成此步骤。
设置 S2S 安全 来保护 S2S 会话的安全,抵御欺诈请求的侵害。设置认证后,每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。识别码缺失或错误的请求会被我们的服务器拒绝。
Adjust 将会话归为组,以节省资源。也就是说,在一次会话后,必须有至少 30 分钟的间隔,Adjust 服务器才会将下一次触发的会话计为新会话。
https://s2s.adjust.com/session
要求:
Content-Type
硬编码 POST payload 格式 application/x-www-form-urlencoded X-Adjust-Forwarded-For
设备 IP 地址 180.220.253.39 Authorization
调用 Adjust API 时,发送验证类型设置为 Bearer 的 Adjust 认证识别码。 Bearer authentication_token
payload 中唯一必要的参数是s2s
。请在下方查看完整参数列表。
s2s
服务器到服务器的参数:允许 Adjust 服务器识别服务器端的活动。 必须始终为 1。 1 app_token
应用的唯一认证识别码 pezwd5bre2xb vida
Vizio 广告标识符,仅限 Vizio dca2365e-0d78-47c6-aaac-9567846c6c9e rida
Roku 广告标识符,仅限 Roku 设备 tifa
Tizen 操作系统广告标识符,仅限 Samsung IDFA
iOS 广告标识符,仅限 iOS 设备 29DDE430-CE81-4F00-A50C-689595AAD142 idfv
iOS 供应商标识符,仅限 iOS 设备 59E27F41-A86B-4560-B585-63161F871C4B gps_adid
Google Play 广告标识符,仅在已添加 Google Play 服务库时发送。仅限安卓设备 6cf94580-46c2-490c-b882-2f6ae269b579 oaid
匿名设备标识符 ed799bac-2537-6122-377a-edebce5db5a5 imei
国际移动设备识别码 (IMEI) 490154203237518 android_id
安卓标识符,仅在缺失 gps_adid 的情况下发送。仅限安卓设备 e11a8c233efb29f3 persistent_ios_uuid
与 ios_uuid 相同,但存储在 Keychain 中,以便重装的应用拥有相同的值,仅限 iOS 设备 3b35fcfb-6115-4cff-830f-e32a248c487d app_version
该参数代表 iOS 中的版本号码和安卓中的实际应用版本。 1.0 app_version_short
代表 iOS 中实际应用版本号的发布 版本,仅限 IOS 设备 1.0 session_count
包括当前会话的已跟踪会话总数。 1 subsession_count
已跟踪的子会话数量。跟踪到的首次会话 (即安装) 不包含该参数。其后的所有会话都包含前一次会话的子会话数量。 1 session_length
会话时长 (以秒计)。跟踪到的首次会话 (即安装) 不包含该参数。其后的所有会话都包含前一次会话的时长。 123 time_spent
前次会话中活跃状态时长 123 tracking_enabled
说明用户是否启用了限制广告跟踪 (LAT) 1 bundle_id
Bundle ID,仅限 iOS 设备。 com.adjust.example package_name
包名,仅限安卓设备。 com.adjust.example environment
测试环境为 "sandbox",真实流量为 "production" sandbox country
国家/地区代码 de language
本地语言代码 EN os_name
"ios" 或 "android",仅字符串 iOS os_version
当前操作系统版本 11.0 cpu_type
CPU 处理器系列 arm64-v8a created_at
本地设备创建包的时间戳 (带时区)。 2018-03-23T09:46:47.288Z-0400 sent_at
本地设备发送包的时间戳 (带时区)。 2018-03-23T09:47:47.288Z-0400" device_type
设备型号 Phone (android), iphone device_name
型号标识符 ,必须编码Moto G (5) Plus, iPhone10,5 hardware_name
设备主板配置 N66AP install_receipt
App Store 签名加密的安装收据 ,仅限 iOS 设备代表收据的超长字符串 ip_address
设备 IP 地址。 ip_address
参数仅接受 IPv4 地址。当前不支持 IPv6。 ip_address=192.0.0.1
请求示例
curl -X 'POST' -d 'app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'
{
"Host": "s2s.adjust.com",
"Path": "/session",
"Method": "POST",
"ReceivedAt": "2022-01-01T17:00:01.030986068Z",
"Header": {
"Connection": [
"close"
],
"User-Agent": [
"Adjust Streaming Job (akka-http)"
],
"Authorization": [
"Bearer ADD_YOUR_AUTH_TOKEN_HERE"
],
"Content-Length": [
"0"
],
"X-Adjust-Forwarded-For": [
"71.142.112.183",
"34.221.136.124"
],
"X-Adjust-Forwarded-Proto": [
"https"
]
},
"Form": {
"s2s": [
"1"
],
"rida": [
"099aa0bc-d123-4567-8999-a1b7c50767b1"
],
"os_name": [
"android"
],
"app_token": [
"a1234b2x3a4o"
],
"app_version": [
"Roku/DVP-10.5 (10.5.0.0010)"
],
"environment": [
"production"
],
"created_at_unix": [
"1543915806015"
]
}
}