文档

支持

Unity Ads 用户获取

广告系列

归因

打开 User Acquisition（用户获取）后台

Unity Ads 用户获取

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

为每个应用事件构造含有必需的用户、广告系列、游戏、事件和归因参数的请求，使用自定义的 S2S 回传数据将安装后事件数据发送给 Unity Ads。
阅读时间5 分钟最后更新于 4 天前
要使用自定义 S2S 集成将安装后事件数据传递给 Unity，请使用服务器请求来生成回传数据。请参阅这篇文章，了解可从服务器获取的回传数据示例。

URL 基地址

使用以下 URL 基地址将安装后事件回传数据发送给 Unity： 
https://ads-secondary-conversion.unityads.unity3d.com/v1/events

必需的事件参数

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

用户标识

您必须在二次回传 URL 中包含以下用户身份参数：

参数

描述

示例

注意

gamer_id=
安装用户的 Unity Ads 唯一 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
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
您可以在用户获取后台的 **Campaigns（广告系列）**页面获取您的 Campaign ID（广告系列 ID）。

游戏标识

您必须在二次回传 URL 中包含以下游戏身份参数：

基础游戏标识

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

参数

描述

示例

注意

game_id
Unity Ads 广告主 Game ID
500009999
请确保您从用户获取后台 获取广告主 Game ID。不要使用来自 Monetization（变现）后台用于 SDK 集成的发行商 Game ID。

平台标识

在 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。

安装时间戳

您必须在二次回传 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 的辅助回传字符串示例。

会话事件

请参考以下示例，了解如何通过回传字符串传递会话事件数据。 
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