adjust-icon

服务器到服务器 (S2S) 会话

在 Adjust 中，会话是所有归因和监测的基础。当用户打开应用或从后台恢复使用应用时，就会触发会话。您可以通过 S2S 会话 API 记录应用中的每一次会话。

操作前须知

认证

设置 S2S 安全来保护 S2S 会话的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。缺失识别码或识别码不正确的请求会被 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 验证识别码，作为Bearer识别码。Bearer authentication_token

Payload

请在下方查看完整参数列表。

参数描述示例
s2s*服务器到服务器的参数：允许 Adjust 服务器识别服务器端的活动。 必须始终未1。1
app_token应用的唯一认证识别码pezwd5bre2xb
vidaVizio 广告标识符，仅限 Viziodca2365e-0d78-47c6-aaac-9567846c6c9e
ridaRoku 广告标识符，仅限 Roku 设备
tifaTizen 操作系统广告标识符，仅限 Samsung
idfaiOS 广告标识符，仅限 iOS 设备29DDE430-CE81-4F00-A50C-689595AAD142
idfviOS 供应商标识符，仅限 iOS 设备59E27F41-A86B-4560-B585-63161F871C4B
gps_adidGoogle 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 中的实际应用版本号。仅限 iOS1.0
session_count包括当前会话的已记录会话总数。1
subsession_count已记录的子会话数量。记录到的首次会话 (即安装) 不包含该参数。
其后的所有会话都包含前一次会话的子会话数量。		1
session_length会话时长 (以秒计)。跟踪到的首次会话 (即安装) 不包含该参数。
其后的所有会话都包含前一次会话的时长。		123
time_spent前次会话中活跃状态时长123
tracking_enabled说明用户是否启用了限制广告跟踪 (LAT)1
bundle_idBundle ID，仅限 iOS 设备。com.adjust.example
package_name包名，仅限安卓设备。com.adjust.example
environmentsandbox 用于测试，production用于真实流量sandbox
country国家/地区代码de
language本地语言代码en
os_nameios 或 androidios
os_version当前操作系统版本11.0
cpu_typeCPU 处理器系列arm64-v8a
created_at本地设备创建包的时间戳 (带时区)。2024-03-23T09:46:47.288Z-0400
sent_at本地设备发送包的时间戳 (带时区)。2024-03-23T09:47:47.288Z-0400
device_type设备型号Phone (android), iphone
device_nameURL 编码模型识别码Moto G (5) Plus, iPhone10,5
hardware_name设备主板配置N66AP
install_receipt来自 App Store 的加密签名安装收据，仅限 iOSSuper long string representation of the receipt
ip_address设备 IP 地址ip_address参数仅接受 IPv4 地址。当前不支持 IPv6。ip_address=192.0.0.1

要符合欧盟的《数字市场法案》(Digital Markets Act，简称 DMA)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。

对于 S2S 会话和安装请求，Adjust 支持下列 DMA 参数。请将参数添加至请求表格中。

请注意，如果您正在使用 Google Ads，则需要发送ad_personalization参数；如果您正在使用 Google Marketing Platform，则需要发送npa参数。

密钥值描述
eea
  • 1: 用户位于 EEA 且 DMA 适用
  • 0: 用户不位于 EEA 且 DMA 不适用
告知 Google 用户是否位于 EEA，即包含 DMA 在内的欧洲法律法规是否适用于该用户和转化，
ad_personalization
  • 1: 用户已授权
  • 0: 用户未授权
表明用户是否同意在安装应用后通过 Google Ads 被投放个性化广告。
ad_user_data
  • 1: 用户已授权
  • 0: 用户未授权
告知 Google 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Google Ads 和 Google Marketing Platform 用户界面中指定的所有核心平台服务 (CPS)。
npa
  • 1: 用户已授权
  • 0: 用户未授权
表明用户是否同意在安装应用后通过 Google Marketing Platform 被投放个性化广告。

示例

请求
curl -X "POST" \
-H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \
-H 'User-Agent: Adjust Streaming Job (akka-http)' \
-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" \
"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"]
   }
}