adjust-icon

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

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

设置 S2S 安全

设置 S2S 安全来保护 S2S 会话的安全,抵御欺诈请求的侵害。设置认证后,每个传入的请求都必须带有您在 Adjust 控制面板中生成的识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。要开始设置,请按 S2S 安全文档中的步骤操作。

记录会话

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 服务器识别服务器端的活动。 必须始终未11
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_nameiosandroidios
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 被投放个性化广告。

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

Adjust 支持使用 dma 参数发送 S2S 会话和安装请求的 Amazon DMA 数据。此参数必须包含已编码的 JSON 负载,其中包括必需的 Amazon DMA 参数。

密钥描述
ad_user_data1 (是) | 0 (否)告知 Amazon Ads 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Amazon Ads 用户界面中指定的所有核心平台服务 (CPS)。
ad_storage1 (是) | 0 (否)了解用户是否同意 Amazon Ads 使用营销相关数据存储

DMA 参数示例

dma=%7B%22amazon_ads%22%3A%7B%22ad_user_data%22%3A%220%22%2C%22ad_storage%22%3A%221%22%7D%7D

示例

请求
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=roku-os&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"]
}
}