服务器到服务器集成跟踪 URL 参考

使用 Unity Ads 用户获取仪表盘为您的广告系列定义自定义跟踪 URL。此 URL 在广告系列的印象(或点击)发生时,向您的安装跟踪服务报告用户的身份识别信息。该服务使用此信息将任何后续安装归因于正确的广告网络,然后使用正确的用户详细信息向该网络进行回调。

URL 要求

您的跟踪 URL 必须符合以下要求

  • URL 及任何重定向均使用 HTTPS。
  • URL 包含 {ifa} 动态自定义标记(请参阅下表)。
  • HTTP 重定向通过使用HTTP 3XX 代码 执行,而不是使用 HTML 或 Javascript。
  • URL 不会重定向到 Apple App Store 或 Google Play Store。

如果您的 MMP 不支持 HTTPS,请联系 Unity 获取帮助。

动态自定义跟踪 URL 标记

跟踪 URL 中提供以下动态替换标记

标记描述示例注释
{ifa} (iOS)iOS 广告标识符 (IDFA) 的纯文本形式,使用其原始大写形式。1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F
{ifa} (Android)原始小写形式的 Google 广告 ID。这将取代 Android ID 作为 Android 上的主要身份识别方法。在过渡阶段,两种标识符需要并行运行。1234abcd-1234-5678-abcd-1a2b3c4d5e6f
{ifa_md5} (iOS)iOS 广告标识符 (IDFA) 的 MD5 哈希值,使用其原始大写形式。1234567890ABCDEFGHIJK123456ABCDEF
{ifa_md5} (Android)Google 广告 ID 的 MD5 哈希值,使用其原始小写形式。1234567890abcdefghijk123456abcdef
{android_id_md5}Android 设备的 MD5 哈希值 Android ID。仅当 Google 广告 ID {ifa} 不可用时才应使用此方法,例如当 Android 设备上未安装 Google Play 服务时。MD5 12345678ABCDEFGH = 123ABC456DEF789GHI012JKL345MNO67890
{ip}最终用户的 IP 地址。123.123.123.123此信息仅供参考,不适合用于安装跟踪中的用户身份识别。
{country_code}用户的 ISO 3166-1 alpha-2 国家代码,使用大写形式。GBGB 指大不列颠及北爱尔兰联合王国。
{campaign_id}Unity Ads 广告系列 ID。12345678abcdefgh9012ijkl
{campaign_name}Unity Ads 广告系列名称。my_ad_campaign
{game_id}广告游戏的 Unity Ads 游戏 ID。1234567
{gamer_id}为归因具有限制广告跟踪 (LAT) 且广告标识符的值为 00000000-0000-0000-0000-000000000000 的用户而必需的唯一 Unity Ads 标识符。如果在这种情况下找不到游戏玩家 ID,您将收到格式错误的错误,响应代码为 400。格式错误缺少输入数据
{source_app_id}显示广告的应用的通用源标识符。这是一个区分大小写的字母数字字符串。9g74cAw7WM1L在 2020 年 5 月迁移之前,这由 source_game_id 表示。
{source_game_id}重要:自 2020 年 5 月 11 日起,此字段已弃用。它已被 source_app_id 取代。7654321
{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 like Mac OS X)
  • AppleWebKit/601.1.46 (KHTML, like Gecko)
  • Mobile/13G36 (iOS)
  • Mozilla/5.0 (Linux; Android 6.0.1; SM-G920V Build/MMB29K)
  • AppleWebKit/537.36 (KHTML, like 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 或为空。此字段仅适用于 iOS 设备。
{video_orientation}广告中显示的创意的方向。
  • 纵向
  • 横向
{screen_size}基于 设备定位 的屏幕大小。
  • 小型
  • 正常
  • 大型
  • 特大型
此字段仅适用于 Android 设备。
{screen_density}基于 设备定位 的屏幕密度。
  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
此字段仅适用于 Android 设备。