自定义集成辅助回传
查看自定义服务器到服务器集成辅助回传的格式和参数。
要使用自定义 S2S 集成将安装后事件数据传递给 Unity，请使用服务器请求来生成回传数据。请参阅这篇文章，了解可从服务器获取的回传数据示例。
URL 基地址
使用以下 URL 基地址将安装后事件回传数据发送给 Unity：
https://ads-secondary-conversion.unityads.unity3d.com/v1/events
必需的事件参数
为了将安装后事件数据传递给 Unity，事件查询中应包含以下必需参数。
用户标识
您必须在二次回传 URL 中包含以下用户身份参数：
参数 | 描述 | 示例 | 注意 | | 安装用户的 Unity 唯一 Gamer ID | gamer_id=00000000-0000-0000-0000-000000000000
| |
| 设备的 Apple 广告标识符 (IDFA)，需为大写字母形式。 | ifa=1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
| IDFA 是所有安装必需的参数。可以使用原始或哈希形式的 ID。 |
| (Android) | 小写字母形式的 Google Play 广告 ID | aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9
| |
| (Android) | Google 广告 ID 的 MD5 哈希值，需为小写字母形式 | android_id_md5=6fbff11856d5f0200d473af3cabd346d
| |
广告追踪设置
您必须在二次回传 URL 中包含以下广告跟踪参数：
参数 | 描述 | 示例 | 注意 | | 标记用户是否启用了限制广告跟踪功能 | | |
广告系列标识
您必须在二次回传 URL 中包含以下广告系列身份参数：
参数 | 描述 | 示例 | 注意 | | Unity 广告系列标识符 | | 您可以在用户获取后台的 **Campaigns（广告系列）**页面获取您的 Campaign ID（广告系列 ID）。 |
游戏标识
您必须在二次回传 URL 中包含以下游戏身份参数：
基础游戏标识
URL 中应包含以下 Game ID（游戏 ID）参数：
参数 | 描述 | 示例 | 注意 | | Unity 广告主 Game ID | | 请确保您从用户获取后台 获取广告主 Game ID。不要使用来自 Monetization（变现）后台用于 SDK 集成的发行商 Game ID。 |
参数 | 描述 | 示例 | 注意 | platform={ios or android}&store_id={itunes id or googleplay id}
| 平台 + Store ID |
platform=ios&store_id=123456789
platform=android&store_id=com.example.store
| 对于 iOS，可使用以下值： |
platform={ios or android}&bundle_id={bundle id}
| 平台 + Bundle ID | platform=ios&bundle_id=com.example.myapp
| 对于 Android，可使用以下值： |
platform={ios or android}&project_id={Unity Project ID}
| 平台 + Unity Project ID | platform=android&project_id=2ff453g1-8d49-2p06-n22f-9m833592113f2
| 您可以在 Unity Dashboard（Unity 后台）的任意一个 **Projects（项目）**的 **Settings（设置）**选项卡获取您的 Project ID。 |
安装时间戳
您必须在二次回传 URL 中包含以下时间戳参数：
参数 | 描述 | 示例 | 注意 | install_ts={unix time in seconds or milliseconds}
| 原始安装的时间戳（Unix 格式） | | 时间戳建议最好用毫秒。 |
事件标识
在辅助回传 URL 中应包含以下事件参数之一：
参数 | 描述 | 示例 | 注意 | | 会话事件标记，表示用户开始了一次游戏玩法会话 | | |
event=purchase&value{amount}¤cy={currency}
| 购买事件标记，表示用户完成了一次应用内购并附带交易金额 | event=purchase&value=1.0¤cy=USD
| 建议最好使用 USD（美元）作为货币单位。 |
event=ad_revenue&value{amount}¤cy={currency}
| 广告收入事件标记，表示用户产生了广告收入并附带收入金额 |
event=ad_revenue&value=1.23¤cy=EUR
event=ad_revenue&revenue_usd=1.23
|
- 将收入值的格式设置为小数。例如：。
- 如果您使用 USD（美元）作为货币，可以发送 ，而不是
value{amount}¤cy={currency}
|
转化归因
您必须在二次回传 URL 中包含以下转化归因参数：
参数 | 描述 | 示例 | 注意 | was_conversion_attributed=
| 标记原始安装是否归因于 Unity | was_conversion_attributed=1
| 使用 表示原始安装归因于 Unity。使用 表示原始安装未归因（未归因于 Unity）。 |
查询示例
请参阅以下用于将安装后事件数据发送给 Unity 的辅助回传字符串示例。
会话事件
请参考以下示例，了解如何通过回传字符串传递会话事件数据。
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3
购买事件
请参考以下示例，了解如何通过回传字符串传递购买事件数据。
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3
广告收入事件
请参考以下示例，了解如何通过回传字符串传递广告收入数据。
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=ad_revenue&revenue_usd=1.23&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3
https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=ad_revenue&value=1.23&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3