使用自定义集成来发送辅助回传数据
为每个应用事件构造含有必需的用户、广告系列、游戏、事件和归因参数的请求，使用自定义的 S2S 回传数据将安装后事件数据发送给 Unity Ads。
阅读时间5 分钟最后更新于 4 个月前
要使用自定义 S2S 集成将安装后事件数据传递给 Unity，请使用服务器请求来生成回传数据。请参阅这篇文章，了解可从服务器获取的回传数据示例。
URL 基地址
使用以下 URL 基地址将安装后事件回传数据发送给 Unity：
https://ads-secondary-conversion.unityads.unity3d.com/v1/events
必需的事件参数
为了将安装后事件数据传递给 Unity，事件查询中应包含以下必需参数。
用户标识
您必须在二次回传 URL 中包含以下用户身份参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 安装用户的 Unity Ads 唯一 Gamer ID | | |
| 设备的 Apple 广告标识符 (IDFA)，需为大写字母形式。 | | IDFA 是所有安装必需的参数。可以使用原始或哈希形式的 ID。 |
| 小写字母形式的 Google Play 广告 ID | | |
| Google 广告 ID 的 MD5 哈希值，需为小写字母形式 | |
广告追踪设置
您必须在二次回传 URL 中包含以下广告跟踪参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 标记用户是否启用了限制广告跟踪功能 |
|
广告系列标识
您必须在二次回传 URL 中包含以下广告系列身份参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| Unity Ads 广告系列标识符 | | 您可以在用户获取后台的 **Campaigns（广告系列）**页面获取您的 Campaign ID（广告系列 ID）。 |
游戏标识
您必须在二次回传 URL 中包含以下游戏身份参数：
基础游戏标识
URL 中应包含以下 Game ID（游戏 ID）参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| Unity Ads 广告主 Game ID | | 请确保您从用户获取后台 获取广告主 Game ID。不要使用来自 Monetization（变现）后台用于 SDK 集成的发行商 Game ID。 |
平台标识
在 URL 中应包含以下平台参数之一（还包括 Game ID（游戏 ID））：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 平台 + Store ID |
| 对于 iOS，可使用以下值：
|
| 平台 + Bundle ID | | 对于 Android，可使用以下值：
|
| 平台 + Unity Project ID | | 您可以在 Unity Dashboard（Unity 后台）的任意一个 **Projects（项目）**的 **Settings（设置）**选项卡获取您的 Project ID。 |
安装时间戳
您必须在二次回传 URL 中包含以下时间戳参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 原始安装的时间戳（Unix 格式） | | 时间戳建议最好用毫秒。 |
事件标识
在辅助回传 URL 中应包含以下事件参数之一：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 会话事件标记，表示用户开始了一次游戏玩法会话 | | |
| 购买事件标记，表示用户完成了一次应用内购并附带交易金额 | | 建议最好使用 USD（美元）作为货币单位。 |
| 广告收入事件标记，表示用户产生了广告收入并附带收入金额 |
|
|
转化归因
您必须在二次回传 URL 中包含以下转化归因参数：
参数 | 描述 | 示例 | 注意 |
|---|---|---|---|
| 标记原始安装是否归因于 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?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?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