# 自定义集成辅助回传 > 查看自定义服务器到服务器集成辅助回传的格式和参数。 要使用自定义 S2S 集成将[安装后事件数据](/user-acquisition/data-sharing/post-install-event-data-sharing.md)传递给 Unity，请使用服务器请求来生成回传数据。请参阅这篇文章，了解可从服务器获取的回传数据示例。 ## URL 基地址##base-url 使用以下 URL 基地址将安装后事件回传数据发送给 Unity： ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events ``` ## 必需的事件参数##required-event-parameters 为了将安装后事件数据传递给 Unity，事件查询中应包含以下必需参数。 ### 用户标识##user-identification 您必须在二次回传 URL 中包含以下用户身份参数： | `gamer_id=` | 安装用户的 Unity 唯一 Gamer ID | `gamer_id=00000000-0000-0000-0000-000000000000` | | | -------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -------------------------------- | | * `ifa=` (iOS) * `idfa=` | 设备的 Apple 广告标识符 (IDFA)，需为大写字母形式。 | `ifa=1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P` | IDFA 是所有安装必需的参数。可以使用原始或哈希形式的 ID。 | | `aid=` (Android) | 小写字母形式的 Google Play [广告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9` | | | `android_id_md5` (Android) | Google [广告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) 的 MD5 哈希值，需为小写字母形式 | `android_id_md5=6fbff11856d5f0200d473af3cabd346d` | | ### 广告追踪设置##ad-tracking-setting 您必须在二次回传 URL 中包含以下广告跟踪参数： | * `tracking_enabled=` * `tracking_limited=` | 标记用户是否启用了限制广告跟踪功能 | - `tracking_enabled=1` - `tracking_limited=0` | | | ------------------------------------------- | ----------------- | --------------------------------------------- | - | ### 广告系列标识##campaign-identification 您必须在二次回传 URL 中包含以下广告系列身份参数： | `campaign_id` | Unity 广告系列标识符 | `546b9257365339e0031572bd` | 您可以在用户获取后台的 \*\*Campaigns（广告系列）\*\*页面获取您的 **Campaign ID（广告系列 ID）**。 | | ------------- | ------------- | -------------------------- | ------------------------------------------------------------------- | ### 游戏标识##game-identification 您必须在二次回传 URL 中包含以下游戏身份参数： #### 基础游戏标识##base-game-identification URL 中应包含以下 Game ID（游戏 ID）参数： | `game_id` | Unity 广告主 [游戏 ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id) | `500009999` | 请确保您从[用户获取后台](https://cloud.unity.com/acquire) 获取广告主 **Game ID**。不要使用来自 Monetization（变现）后台用于 SDK 集成的发行商 **Game ID**。 | | --------- | --------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------- | #### 平台标识##platform-identification 在 URL 中应包含以下平台参数之一（还包括 Game ID（游戏 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，可使用以下值：* `ios` * `itunes` * `iOS` * `iTunes` | | --------------------------------------------------------------------- | --------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | `platform={ios or android}&bundle_id={bundle id}` | 平台 + Bundle ID | `platform=ios&bundle_id=com.example.myapp` | 对于 Android，可使用以下值：* `android` * `google` * `Android` * `Google` * `gplay` * `GooglePlay` | | `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**。 | ### 安装时间戳##install-timestamp 您必须在二次回传 URL 中包含以下时间戳参数： | `install_ts={unix time in seconds or milliseconds}` | 原始安装的时间戳（Unix 格式） | `install_ts=1466637800175` | 时间戳建议最好用毫秒。 | | --------------------------------------------------- | ----------------- | -------------------------- | ----------- | ### 事件标识##event-identification 在辅助回传 URL 中应包含以下事件参数之一： | `event=session` | 会话事件标记，表示用户开始了一次游戏玩法会话 | `event=session` | | | ---------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `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` | - 将收入值的格式设置为小数。例如：`1.05`。 - 如果您使用 USD（美元）作为货币，可以发送 `revenue_usd={amount}`，而不是 `value{amount}¤cy={currency}` | ### 转化归因##conversion-attribution 您必须在二次回传 URL 中包含以下转化归因参数： | `was_conversion_attributed=` | 标记原始安装是否归因于 Unity | `was_conversion_attributed=1` | 使用 `1` 表示原始安装归因于 Unity。使用 `0` 表示原始安装未归因（未归因于 Unity）。 | | ---------------------------- | ----------------- | ----------------------------- | ---------------------------------------------------- | ## 查询示例##example-queries 请参阅以下用于将安装后事件数据发送给 Unity 的辅助回传字符串示例。 ### 会话事件##session-event 请参考以下示例，了解如何通过回传字符串传递会话事件数据。 1. **iOS** ```http 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 ``` 2. **Android** ```http 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 ``` ### 购买事件##purchase-event 请参考以下示例，了解如何通过回传字符串传递购买事件数据。 1. **iOS** ```http 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 ``` 2. **Android** ```http 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 ``` ### 广告收入事件##ad-revenue-event 请参考以下示例，了解如何通过回传字符串传递广告收入数据。 1. **iOS** ```http 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 ``` 2. **Android** ```http 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 ```