文档

支持

Unity Ads 用户获取

使用自定义集成发送归因链接

从服务器向 Unity Ads 发送归因链接,以追踪用户交互并支持自定义安装归因(无需 MMP)。
阅读时间2 分钟最后更新于 14 天前

要使用自定义 S2S 集成将互动归因数据传递给 Unity,请使用服务器请求来生成归因追踪链接。请参阅本文以了解可用于向 Unity 发送归因链接的 GET 请求。

先决条件

要将安装数据发送给 Unity,必须添加至少一个应用到 Unity Ads User Acquisition(用户获取)后台

使用回传请求来发送链接

使用以下 HTTP GET 请求可以将安装回传数据发送给 Unity。请参阅自定义集成回传请求参考表,确保包含所需的参数。

iOS

使用以下回传请求 URL 来发送 iOS 回传数据:
https://postback.unityads.unity3d.com/games/[game_id]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]&gamerId=[unity_gamer_id]&attributed=[attributed]

Android

使用以下回传请求 URL 来发送 Android 回传数据:
https://postback.unityads.unity3d.com/games/[game_id]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]&gamerId=[GAMER_ID]&attributed=[ATTRIBUTED]
请查看以下回传参数以确保 Android 回传请求的格式正确无误:

参数名称

要求

格式

描述

注意

game_id
必需字符串您的 Unity Ads Game ID(游戏 ID)您可以在 User Acquisition(用户获取)后台中所选应用的 Campaigns(广告系列) 页面顶部找到您的 Game ID(游戏 ID)。
GAMER_ID
可选字符串唯一的 Unity Ads 标识符,在归因已启用有限广告追踪 (LAT) 的用户时必须提供此参数。您可以从用于归因的展示量、完成观看量或点击量中找到
gamer_id
参数值。
需要
GAMER_ID
参数才能成功归因安装。对于未归因的安装,该参数是可选的。
ATTRIBUTED
可选整数(
0
1
这是一个标志,表示此安装是否归因于 Unity Ads 并且可以收费。默认值 (
attributed=1
) 表示这一条件成立。如果条件不成立 (
attributed=0
),则该安装未归因,因此也不会计费。

URL 格式

为了确保您的归因正确运作,请确保根据以下要求提供格式正确的链接:
  • 对 URL 和所有重定向使用 HTTPS。
  • 包含
    {ifa}
    动态自定义标记。请参阅动态自定义标记参考以查看支持的标记。
  • 使用 HTTP 3XX 重定向代码。不要使用 HTML 和 JavaScript 重定向。
  • 不要将 URL 重定向到 Apple App Store 和 Google Play 应用商店。
保存归因链接时,后台会检查是否存在错误,以验证 URL 在语法上是否正确。