文档

支持

Unity Ads User Acquisition

归因链接参数参考

Define attribution link parameters for Unity Ads campaigns by specifying values within your tracking URLs.
阅读时间 4 分钟最后更新 3 days ago

通过归因链接可以将互动数据从应用服务器传递到 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 设备。