归因链接参数参考

Define attribution link parameters for Unity Ads campaigns by specifying values within your tracking URLs.

阅读时间4 分钟

通过归因链接可以将互动数据从应用服务器传递到 Unity Ads 用户获取广告系列。请参阅这些归因跟踪链接的以下要求。如需了解如何获取归因链接，请参阅您偏好的合作伙伴的合作伙伴集成文档或自定义集成文档。

URL 要求

确保您的归因追踪链接满足以下要求：

对 URL 和重定向使用 HTTPS。
包含
```
{ifa}
```
动态自定义标记。请参阅下面的动态自定义标记以了解更多信息。
使用 HTTP 3XX 重定向代码。不要使用 HTML 和 JavaScript 重定向。
不要将 URL 重定向到 Apple App Store 和 Google Play 应用商店。

如果您的 MMP 不支持 HTTPS，请联系 Unity 寻求帮助。

动态自定义 URL 标记

Unity 支持在归因追踪 URL 中动态替换以下标记：

标记	描述	示例	注意
`{ifa}` (iOS)	采用纯文本以原始大写形式表示的 iOS 广告标识符 (IDFA)。	`1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F`
`{ifa}` (Android)	以原始小写形式表示的 Google Advertising ID。这将取代 Android ID 成为 Android 上的主要标识方法。在过渡阶段，两种标识符需要并存。	`1234abcd-1234-5678-abcd-1a2b3c4d5e6f`
`{ifa_md5}` (iOS)	从原始大写形式经过 MD5 哈希处理的 iOS 广告标识符 (IDFA)。	`9dd6df49d764d6ada0b250a6376d7b44`
`{ifa_md5}` (Android)	从原始小写形式经过 MD5 哈希处理的 Google Advertising ID。	`9a6a0a84bd8003a97a2109f6c4`
`{android_id_md5}`	Android 设备以 MD5 哈希形式表示的 Android ID。只有在 Google Advertising ID `{ifa}` 不可用时（例如，Android 设备上未安装 Google Play 服务时）才应使用此标记。	MD5 `12345678ABCDEFGH` = `5756ae9022b2ea1e47d84fead75220c8`
`{mmp}`	移动端成效衡量合作伙伴的名称。	`appsflyer` `adjust` `branch` `tenjin` `singular`
`{platform}`	发生安装的平台。	`ios` `android`
`{ip}`	终端用户的 IP 地址。	`123.123.123.123`	这仅作为参考目的提供，不适合用于安装量追踪中的用户标识。
`{organic}`	指示此安装是否归因于自然流量的标志。请参阅以下标志值： `organic=1` 表示该安装不归因于任何广告网络（Unity Ads 或其他）的任何广告。 `organic=0` 表示该安装归因于广告网络。	`organic=1` (true) `organic=0` (false)
`{country_code}`	用户的 ISO 3166-1 alpha-2 国家/地区代码（大写）。	`GB`	`GB` 表示大不列颠及北爱尔兰联合王国。
`{campaign_id}`	Unity Ads 的广告系列 ID。	`12345678abcdefgh9012ijkl`
`{campaign_name}`	Unity Ads 的广告系列名称。	`my_ad_campaign`
`{game_id}`	广告推广的游戏的 Unity Ads Game ID（游戏 ID）。	`1234567`
`{gamer_id}`	唯一的 Unity Ads 标识符必须用于归因已启用有限广告追踪 (LAT) 的用户，其中，广告标识符的值为 `00000000-0000-0000-0000-000000000000` 。如果在这种情况下找不到玩家 ID，您将接收到 malformed 错误，响应代码为 400。	`Malformed` 或 `missing input data`
`{source_app_id}`	展示广告的应用的通用源标识符。这是一个区分大小写的字母数字字符串。	`9g74cAw7WM1L`	在 2020 年 5 月迁移之前，该标识符由 `source_game_id` 表示。
`{source_game_id}`	自 2020 年 5 月起，此字段已弃用。 `{source_app_id}` 标记取代 `{source_game_id}` 。	`7654321`	`{source_app_id}` 取代此标记。
`{os}`	终端用户设备的操作系统。	`9.2.1` (iOS) `4.4.0` (Android)
`{device_type}`	终端用户的设备类型。	`iPad4,1` `motorola XT1254` `samsung SM-G900F`
`{creative_pack}`	广告中使用的广告素材包的名称。	`Video Creatives Pack - EN - 15s`
`{creative_pack_id}`	广告中使用的广告素材包的唯一标识符。	`5beafbce74ed83001acb258c`
`{language}`	终端用户的设备语言。	`en-GB`
`{user_agent}`	终端用户的设备用户代理。	`Mozilla/5.0` （iPhone；CPU iPhone OS 9_3_5，如 Mac OS X） `AppleWebKit/601.1.46` （KHTML，如 Gecko） `Mobile/13G36` (iOS) `Mozilla/5.0` （Linux；Android 6.0.1；SM-G920V Build/MMB29K） `AppleWebKit/537.36` （KHTML，如 Gecko） `Chrome/52.0.2743.98 Mobile Safari/537.36` (Android)
`{device_make}`	终端用户的设备制造商。	`Apple` (iOS) `samsung` (Android)
`{device_model}`	终端用户的设备型号。	`iPhone7,2` (iOS) `SM-G900F` (Android)
`{is_skadnetwork_supported}`	SKAdNetwork 支持状态。	`true` 或 empty。	此字段仅适用于 iOS 设备。
`{video_orientation}`	广告中显示的广告素材方向。	`portrait` `landscape`
`{screen_size}`	基于设备定向投放需求的屏幕尺寸。	`small` `normal` `large` `xlarge`	此字段仅适用于 Android 设备。
`{screen_density}`	基于设备定向投放需求的屏幕密度。	`ldpi` `mdpi` `hdpi` `xhdpi` `xxhdpi` `xxxhdpi`	此字段仅适用于 Android 设备。

文档

引擎

服务

增长

工业

支持

Unity Ads User Acquisition

Campaigns

Attribution

Unity Ads User Acquisition

归因链接参数参考

URL 要求

动态自定义 URL 标记

标记

描述

示例

注意