归因链接参数参考

Read time 3 minutes

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

如需了解如何获取归因链接，请参阅您偏好的合作伙伴的合作伙伴集成文档或自定义集成文档。

URL 要求
URL 要求

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

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

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

动态自定义 URL 标记
动态自定义 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 设备。