Adjust payload 结构

您可以借助 Adjust payload 结构,向 Adust 发送 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"
}

创建 Adjust payload 结构

要简化您和 Adjust 之间的数据映射,您需要将受支持的 Adjust 推广活动参数附加至 SKAdNetwork 终端,并将 SKAdNetwork 安装回调发送给 Adjust。

要创建 Adjust payload 结构,请按照下列步骤操作:

  1. sk_network_token值附加至终端,然后附加受支持的 Adjust 推广活动参数。您需要确保 SKAdNetwork 安装回调请求中的所有参数均已填充。

  2. 使用 HTTP GET 方法向 Adjust 发送信息。

Adjust 会收到下列信息:

示例:

https://app.adjust.com/skadnetwork/<sk_network_token>?tracker=abc123&campaign={your_campaign_name}&campaign_id={your_campaign_id}&adgroup={your_adgroup_name}&adgroup_id={your_adgroup_id}&creative={your_creative_name}&creative_id={your_creative_id}&sk_ts=1597151456&ip_address=10.10.10.10&user_agent=App+Store&sk_payload=%7B%0A%20%20%22version%22%20%3A%20%222.2%22%2C%0A%20%20%22ad-network-id%22%20%3A%20%22com.example%22%2C%0A%20%20%22campaign-id%22%20%3A%2042%2C%0A%20%20%22transaction-id%22%20%3A%20%226aafb7a5-0170-41b5-bbe4-fe71dedf1e28%22%2C%0A%20%20%22app-id%22%20%3A%20525463029%2C%0A%20%20%22attribution-signature%22%20%3A%20%22MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY%2FAOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9%2FsY%22%2C%0A%20%20%22redownload%22%3A%20true%2C%0A%20%20%22source-app-id%22%3A%201234567891%2C%0A%20%20%22fidelity-type%22%3A%201%0A%20%20%22conversion-value%22%3A%2020%0A%20%20%22coarse-conversion-value%22%3A%20%22high%22%20%0A%20%20%22postback-sequence-index%22%3A%200%0A%20%20%22source-identifer%22%3A%20%225239%22%0A%7D

此处的sk_payload是从 Apple 收到的完整已编码 SKAdNetwork payload。

sk_ts是您从 Apple 收到原始回调的 UNIX 时间戳 (以秒计)。如果sk_ts为空,Adjust 就会回溯至您发送回调的时间。

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