使用自定义集成来发送辅助回传数据

为每个应用事件构造含有必需的用户、广告系列、游戏、事件和归因参数的请求，使用自定义的 S2S 回传数据将安装后事件数据发送给 Unity Ads。

阅读时间5 分钟

最后更新于 7 天前

要使用自定义 S2S 集成将安装后事件数据传递给 Unity，请使用服务器请求来生成回传数据。请参阅这篇文章，了解可从服务器获取的回传数据示例。

URL 基地址

使用以下 URL 基地址将安装后事件回传数据发送给 Unity：


https://ads-secondary-conversion.unityads.unity3d.com/v1/events

必需的事件参数

为了将安装后事件数据传递给 Unity，事件查询中应包含以下必需参数。

用户标识

在辅助回传 URL 中需要以下用户标识参数：

参数	描述	示例	注意
`gamer_id=`	安装操作用户的 Unity Ads 唯一 Gamer ID（玩家 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，以小写形式表示	`aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9`
`android_id_md5` (Android)	Google 广告 ID 的 MD5 哈希值，以小写形式表示	`android_id_md5=6fbff11856d5f0200d473af3cabd346d`

广告追踪设置

在辅助回传 URL 中需要以下广告追踪参数：

参数	描述	示例	注意
`tracking_enabled=` `tracking_limited=`	表示用户是否启用了有限广告追踪的标志	`tracking_enabled=1` `tracking_limited=0`

广告系列标识

在辅助回传 URL 中需要以下广告系列标识参数：

参数	描述	示例	注意
`campaign_id`	Unity Ads 广告系列标识符	`546b9257365339e0031572bd`	您可以从 User Acquisition（用户获取）后台的 Campaigns（广告系列）页面获取您的 Campaign ID（广告系列 ID）。

游戏标识

在辅助回传 URL 中需要以下游戏标识参数：

基础游戏标识

URL 中应包含以下 Game ID（游戏 ID）参数：

参数	描述	示例	注意
`gameId`	Unity Ads Game ID（游戏 ID）	`500009999`	您可以从 User Acquisition（用户获取）后台的 Apps（应用）页面中获取您的 Game ID（游戏 ID）。

平台标识

在 URL 中应包含以下平台参数之一（还包括 Game ID（游戏 ID））：

参数	描述	示例	注意
`platform={ios or android}&store_id={itunes id or googleplay id}`	平台 + Store ID（商店 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（项目 ID）	`platform=android&project_id=2ff453g1-8d49-2p06-n22f-9m833592113f2`	您可以从 Unity Dashboard（Unity 后台）中任何 Projects（项目）的 Settings（设置）选项卡中获取 Project ID（项目 ID）。

参数

描述

示例

注意

platform={ios or android}&store_id={itunes id or googleplay id}

平台 + Store ID（商店 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（项目 ID）

platform=android&project_id=2ff453g1-8d49-2p06-n22f-9m833592113f2

您可以从 Unity Dashboard（Unity 后台）中任何 **Projects（项目）**的 **Settings（设置）**选项卡中获取 Project ID（项目 ID）。

安装时间戳

在辅助回传 URL 中需要以下时间戳参数：

参数	描述	示例	注意
`install_ts={unix time in seconds or milliseconds}`	Unix 格式的原始安装时间戳	`install_ts=1466637800175`	时间戳的建议最佳实践为毫秒。

事件标识

在辅助回传 URL 中应包含以下事件参数之一：

参数	描述	示例	注意
`event=session`	表示用户启动了游戏会话的会话事件标志	`event=session`
`event=purchase&value{amount}&currency={currency}`	表示用户完成了应用内购的购买事件标志 + 交易金额	`event=purchase&value=1.0&currency=USD`	建议最好使用 USD 作为货币。
`event=ad_revenue&value{amount}&currency={currency}`	表示用户产生了广告收入的广告收入事件标志 + 收入金额	`event=ad_revenue&value=1.23&currency=EUR` `event=ad_revenue&revenue_usd=1.23`	将收入值的格式设置为小数。例如： `1.05` 。如果货币使用 USD，可以发送 `revenue_usd={amount}` 而不是 `value{amount}&currency={currency}`

转化归因

在辅助回传 URL 中需要以下转化归因参数：

参数	描述	示例	注意
`was_conversion_attributed=`	表示原始安装是否归因于 Unity 的标志	`was_conversion_attributed=1`	使用 `1` 表示原始安装归因于 Unity。使用 `0` 表示原始安装未归因（未归因于 Unity）。

查询示例

请参阅以下用于将安装后事件数据发送给 Unity 的辅助回传字符串示例。

iOS 会话事件

使用此参考作为用于回传 iOS 会话事件数据的回传字符串示例。


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

Android 会话事件

使用此参考作为用于回传 Android 会话事件数据的回传字符串示例。


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

iOS 购买事件

使用此参考作为用于回传 iOS 购买事件数据的回传字符串示例。


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

Android 购买事件

使用此参考作为用于回传 Android 购买事件数据的回传字符串示例。


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

iOS 广告收入事件

使用此参考作为用于回传 iOS 广告收入数据的回传字符串示例。


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

Android 广告收入事件

使用此参考作为用于回传 Android 广告收入数据的回传字符串示例。


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