Apple payload 结构

您可以使用 Apple payload 结构，向 Adust 发送 SKAdNetwork payload 的信息和任意额外的推广活动信息。

Adjust 支持 Apple 的 JSON SKAdNetwork payload 结构。

操作前须知

以下是您在操作前需要了解的内容。

要求

确保您从 Apple 收到含有以下参数的SKAdNetwork payload：

  • version
  • ad-network-id
  • campaign-id
  • transaction-id
  • app-id
  • attribution-signature
  • redownload
  • source-app-id
  • conversion-value
  • fidelity-type (SKAdNetwork 2.2 及更高版本)
  • did-win (iOS 14.6 及更新版本，SKAdNetwork 3.0 版本)
  • coarse-conversion-value (iOS 16.1 及更高版本，SKAdNetwork 版本 4.0)
  • source-identifier (iOS 16.1 及更高版本，SKAdNetwork 版本 4.0)
  • postback-sequence-index (iOS 16.1 及更高版本，SKAdNetwork 版本 4.0)

示例：

{
  "version" : "2.2",
"ad-network-id" : "com.example",
"campaign-id" : 42,
  "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id" : 525463029,
  "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
  "redownload": true,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "conversion-value": 20,
  "did-win": true
  "coarse-conversion-value": "high" 
  "postback-sequence-index": 0
  "source-identifer": "5239"
}

创建 Apple payload 结构

您需要将受支持的 Adjust 推广活动参数附加至 Apple SKAdNetwork payload，并将 SKAdNetwork 安装回调发送给 Adjust。

要创建 Apple payload 结构，请按照下列步骤操作：

  1. 将额外信息附加至 Apple SKAdNetwork payload。
参数描述
adjust-tracker6/7 字符 Adjust 链接识别码
adjust-campaignAdjust 推广活动名称
adjust-campaign-idAdjust 推广活动 ID
adjust-adgroupAdjust 广告组名称
adjust-adgroup-idAdjust 广告组 ID
adjust-creativeAdjust 素材名称
adjust-creative-idAdjust 素材 ID
timestamp从 Apple 接收初始回调时的 UNIX 时间戳 (以秒计)。 如果该值为空，那么 Adjust 就会使用从接收到您的回调的时间。
country显示安装位置的两字符国家/地区代码。
如果该值为空，Adjust 就会将其报告为 "ZZ" (在聚合报告中显示为 "Unknown" (未知))。
  1. 通过Content-Type: application/json使用 HTTP POST 方法向 Adjust 发送信息。

Adjust 会收到下列信息：

示例：​

URL: https://app.adjust.com/skadnetwork/<sk_network_token>

正文：

{ 
"source-app-id" : 123456789, 
"app-id" : 987654321, 
"attribution-signature" : "xxxxxxxxxxxx",
"campaign-id" : 1, 
"transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28", 
"conversion-value" : 1,
"fidelity-type": 1, 
"version" : "2.2", 
"ad-network-id" : "xxxxxxxxx.skadnetwork", 
"redownload" : true, 
"coarse-conversion-value": "high" 
"postback-sequence-index": 0
"source-identifer": "5239"
"adjust-tracker": "abc123",
"adjust-campaign": "test_campaign_name", 
"adjust-campaign-id": "test_campaign_id", 
"adjust-adgroup": "test_adgroup_name", 
"adjust-adgroup-id": "test_adgroup_id", 
"adjust-creative": "test_creative_name", 
"adjust-creative-id": "test_creative_id", 
"timestamp": 1597151456,
"country": "de",
"ip-address": "10.10.10.10", 
"user-agent": "App Store"
 }

此处的user_agent是来自 SKAdNetwork payload 的用户代理。不过我们建议您使用实际的浏览器用户代理。例如：Mozilla/5.0 (iPod; U; CPU iPhone OS 4_3_3 like Mac OS X; ja-jp) AppleWebKit/533.17.9 (KHTML, like Gecko) Version/5.0.2 Mobile/8J2 Safari/6533.18.5