# 归因链接参数参考

> 在追踪 URL 中指定相应的值来定义 Unity Ads 广告系列的归因链接参数。

通过归因链接可以将互动数据从应用服务器传递到 Unity Ads 用户获取广告系列。请参阅这些归因跟踪链接的以下要求。

如需了解如何获取归因链接，请参阅您偏好的合作伙伴的[合作伙伴集成](/grow/acquire/partner-integration.md)文档或[自定义集成](/grow/acquire/partner-integration/custom/custom-integration.md)文档。

## URL 要求##url-requirements

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

* 对 URL 和重定向使用 HTTPS。
* 包含 `{ifa}` 动态自定义标记。请参阅下面的[动态自定义标记](#dynamic)以了解更多信息。
* 使用 [HTTP 3XX](https://www.w3.org/Protocols/HTTP/HTRESP.html) 重定向代码。不要使用 HTML 和 JavaScript 重定向。
* 不要将 URL 重定向到 Apple App Store 和 Google Play 应用商店。

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

## 动态自定义 URL 标记##dynamic

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

| **标记**                       | **描述**                                                                                                                                                                                                                   | **示例**                                                                                                                                                                                                                                                         | **注意**                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| `{ifa}` (iOS)                | 采用纯文本以原始大写形式表示的 iOS 广告标识符 (IDFA)。                                                                                                                                                                                        | `1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F`                                                                                                                                                                                                                         |                                             |
| `{ifa}` (Android)            | 以原始小写形式表示的 [Google Advertising ID](https://developer.android.com/google/play-services/id.html)。这将取代 Android ID 成为 Android 上的主要标识方法。在过渡阶段，两种标识符需要并存。                                                                      | `1234abcd-1234-5678-abcd-1a2b3c4d5e6f`                                                                                                                                                                                                                         |                                             |
| `{ifa_md5}` (iOS)            | 从原始大写形式经过 MD5 哈希处理的 iOS 广告标识符 (IDFA)。                                                                                                                                                                                    | `9dd6df49d764d6ada0b250a6376d7b44`                                                                                                                                                                                                                             |                                             |
| `{ifa_md5}` (Android)        | 从原始小写形式经过 MD5 哈希处理的 [Google Advertising ID](https://developer.android.com/google/play-services/id.html)。                                                                                                                 | `9a6a0a84bd8003a97a2109f6c4`                                                                                                                                                                                                                                   |                                             |
| `{android_id_md5}`           | Android 设备以 MD5 哈希形式表示的 [Android ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#a-n-d-r-o-i-d_-i-d)。只有在 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 双字母国家/地区代码（大写）。                                                                                                                                                                                           | `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](/grow/acquire/get-started/key-concepts.md) 支持状态。                                                                                                                                                           | `true` 或 empty。                                                                                                                                                                                                                                                | 此字段仅适用于 iOS 设备。                             |
| `{video_orientation}`        | 广告中显示的广告素材方向。                                                                                                                                                                                                            | `portrait``landscape`                                                                                                                                                                                                                                          |                                             |
| `{screen_size}`              | 基于[设备定向投放](/grow/acquire/targeting/device/device-targeting.md)需求的屏幕尺寸。                                                                                                                                                   | `small``normal``large``xlarge`                                                                                                                                                                                                                                 | 此字段仅适用于 Android 设备。                         |
| `{screen_density}`           | 基于[设备定向投放](/grow/acquire/targeting/device/device-targeting.md)需求的屏幕密度。                                                                                                                                                   | `ldpi``mdpi``hdpi``xhdpi``xxhdpi``xxxhdpi`                                                                                                                                                                                                                     | 此字段仅适用于 Android 设备。                         |
