文档

支持

Unity Ads User Acquisition

自定义集成回传请求参考

Send server-to-server postback requests to Unity Ads to report installs and post-install events for accurate attribution in a custom integration.
阅读时间 2 分钟

当使用自定义集成从应用服务器发送回传数据时,请查看以下参数,以确保您的请求格式正确无误。 必须在自定义集成回传请求中传递以下标识参数:

参数

描述

示例

注意

advertisingTrackingId
(iOS)
以大写形式表示的广告标识符 (IDFA)。
1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
所有安装都必须有 IDFA。可以使用原始或哈希形式的 ID。
advertisingTrackingIdMD5
(iOS)
采用小写形式并经过哈希处理的广告标识符 (IDFA)。
fce1e02f2ca0498021ec67f2f22dfcea
所有安装都必须有 IDFA。可以使用原始或哈希形式的 ID。
advertisingTrackingId
(Android)
以小写形式表示的 Google 广告 ID
a1b2-c3d4-e5f6-g7h8
所有安装都必须有广告 ID。可以使用原始或哈希形式的 ID。
advertisingTrackingIdMD5
(Android)
采用小写形式并经过 MD5 哈希处理的 Google 广告 ID
6fbff11856d5f0200d473af3cabd346d
所有安装都必须有广告 ID。可以使用原始或哈希形式的 ID。
gamerId
唯一的 Unity Ads 标识符,在归因已启用有限广告追踪 (LAT) 的用户时必须提供此参数。
00000000-0000-0000-0000-000000000000
应从用于归因的展示量、完成观看量或点击量中获取
gamer_id
参数值。

如果
gamerID
的格式不正确,则会出现
malformed
错误,响应代码为 400:
Malformed or missing input data
installTimeEpoch
系统纪元以来的安装时间(以秒为单位)。
1615973128
对于某些广告系列类型来说,此参数是必需的。
rawAndroidId
以原始小写形式表示的 Android ID
3f4a92b6c1d8e90f
不建议使用
rawAndroidID
参数,因为如果 Android 设备已正确集成 Google Play 服务并安装了 Google Play,则不需要此参数。但是,对于所有没有 Google 广告 ID 的 Android 安装,则必须提供此参数。
androidId
以 MD5 哈希形式表示的 Android ID
4a969d593d2a3e1d602fefe8e75a4d80不建议使用此参数,因为如果 Android 设备已正确集成 Google Play 服务并安装了 Google Play,则不需要此参数。但是,对于所有没有 Google 广告 ID 的 Android 安装,则必须提供此参数。
attributed
这是一个标志,表示此安装是否归因于 Unity Ads 并且可以收费。
  • attributed=1
  • attributed=0
默认值 (
attributed=1
) 表示这一条件成立。如果条件不成立 (
attributed=0
),则该安装未归因,因此也不会计费。

仅当您发送所有安装的事件数据而不是仅发送归因于 Unity 的安装数据时,才应使用此参数。

自定义集成回传请求参考 • Unity Grow • Unity Docs