服务器回调 URL 请求参考
通过使用回调 URL 报告由于活动而安装广告游戏的转换用户。您可以使用 HTTP GET 请求检索此报告。
对于 iOS，请使用以下 URL
https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]对于 Android，请使用以下 URL
https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]GAME_ID 参数是您的 Unity Ads 游戏 ID。您可以通过登录 Unity Ads 用户获取仪表板 并选择 **活动** 来查找此 ID。
Note: For existing users, the legacy impact.applifier.com domain will continue working in parallel with the new postback.unityads.unity3d.com domain. However, we recommend that you migrate to the new domain.
回调 URL 参数
以下标识参数必须在回调 URL 请求中中继
| 参数 | 描述 | 示例 | 注释 |
|---|---|---|---|
advertisingTrackingId (iOS) | 广告标识符 (IDFA)，以大写形式。对于所有安装（原始形式或 MD5 散列形式），这是强制性的。 | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX | |
advertisingTrackingIdMD5 (iOS) | 广告标识符 (IDFA)，以 MD5 散列形式，小写形式。对于所有安装（原始形式或 MD5 散列形式），这是强制性的。 | ||
advertisingTrackingId (Android) | 以小写形式显示的 Google 广告 ID。对于所有安装（原始形式或 MD5 散列形式），这是强制性的。 | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX | |
advertisingTrackingIdMD5 (Android) | 以 MD5 散列形式显示的 Google 广告 ID。对于所有安装（原始形式或 MD5 散列形式），这是强制性的。 | ||
gamerId | 用于归因已开启有限广告跟踪 (LAT) 的用户的唯一 Unity Ads 标识符，其中广告标识符的值为 00000000-0000-0000-0000-000000000000。如果在这种情况下找不到 gamerID，则会显示 malformed 错误，并带有响应代码 400：Malformed or missing input data。 | 58c116080dbe250047a2a398 | |
installTimeEpoch | 自纪元以来的秒数的安装时间。对于某些活动类型，这是强制性的。 | 1615973128 | |
rawAndroidId | 以其原始小写形式显示的 Android ID。 | 不建议使用此方法，因为如果 Android 设备已正确集成 Google Play 服务并已安装 Google Play，则不需要它。但是，对于没有 Google 广告 ID 的所有 Android 安装，这是强制性的。 | |
androidId | 以 MD5 散列形式显示的 Android ID。 | 不建议使用此方法，因为如果 Android 设备已正确集成 Google Play 服务并已安装 Google Play，则不需要它。但是，对于没有 Google 广告 ID 的所有 Android 安装，这是强制性的。 | |
attributed | 一个标志，指示此安装是否归因于 Unity Ads 并可以收费。默认值 (attributed=1) 表示条件为真。如果条件为假 (attributed=0)，则安装将仅标记给玩家，并且不会收费。 |
| 仅当您发送所有安装的事件数据（而不是仅发送归因于 Unity 的安装）时，才使用此参数。 |
回调 URL 响应格式
如果消息成功接收，Unity Ads 安装跟踪服务器将以 200 OK 状态代码响应，而不会有响应正文。
如果消息无法处理，服务器将以 4XX/5XX 状态代码响应，并且任何可用的错误都将以 JSON 格式显示在响应正文中。
Note: The status code does not indicate if this postback call was actually recorded as a chargeable install. It only states that the message was successfully received and processed.