# 归因链接参数参考

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

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

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

## URL 要求##url-requirements

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

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

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

## 动态自定义 URL 标记##dynamic-custom-url-tokens

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)，以 MD5 哈希形式表示。只有在 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 广告系列 ID。                                                                                                                                                                                                                   | `12345678abcdefgh9012ijkl`                                                                                                                                                                                                                                                  |                                             |
| `{campaign_name}`            | Unity 广告系列名称。                                                                                                                                                                                                                    | `my_ad_campaign`                                                                                                                                                                                                                                                            |                                             |
| `{game_id}`                  | 广告推广的游戏的 Unity Game ID（游戏 ID）。                                                                                                                                                                                                   | `1234567`                                                                                                                                                                                                                                                                   |                                             |
| `{gamer_id}`                 | 唯一 Unity 标识符，强制用于对启用了有限广告跟踪 (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 构建/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](/user-acquisition/getting-started/glossary.md) 支持状态。                                                                                                                                                               | `true` 或 empty。                                                                                                                                                                                                                                                             | 此字段仅适用于 iOS 设备。                             |
| `{video_orientation}`        | 广告中显示的广告素材方向。                                                                                                                                                                                                                    | * `portrait`
* `landscape`                                                                                                                                                                                                                                                  |                                             |
| `{screen_size}`              | 基于[设备定向投放](/user-acquisition/targeting/intro-to-campaign-targeting.md#device-targeting)的屏幕大小。                                                                                                                                    | - `small`
- `normal`
- `large`
- `xlarge`                                                                                                                                                                                                                                   | 此字段仅适用于 Android 设备。                         |
| `{screen_density}`           | 基于[设备定向投放](/user-acquisition/targeting/intro-to-campaign-targeting.md#device-targeting)的屏幕密度。(/user-acquisition/targeting/intro-to-campaign-targeting#device-targeting)                                                          | * `ldpi`
* `mdpi`
* `hdpi`
* `xhdpi`
* `xxhdpi`
* `xxxhdpi`                                                                                                                                                                                                                 | 此字段仅适用于 Android 设备。                         |
