客户端 SDK

累计价值追踪

追踪生命周期购买收入与广告收入

Version:

SDK 会在设备本地维护购买与广告收入的累计总额，并自动随事件一起上报。

获取累计购买金额

double totalPurchases = AudiencelabSDK.GetTotalPurchaseValue();
Debug.Log($"Lifetime revenue: ${totalPurchases:F2}");

获取累计广告收入

double totalAdRevenue = AudiencelabSDK.GetTotalAdValue();
Debug.Log($"Lifetime ad revenue: ${totalAdRevenue:F2}");

工作原理

  1. 每次调用 SendPurchaseEvent() 或 SendAdEvent() 时，SDK 会把 value 累加到总额中
  2. 总额通过 Unity 的 PlayerPrefs API 进行本地保存
  3. 数值会在多次启动与设备重启后继续保留
  4. 累计值会自动作为 total_purchase_value 与 total_ad_value 附加在事件 payload 中

Unity 负责“使用理由必填”API 声明

插件调用 Unity 公开的 PlayerPrefs 抽象；Audiencelab SDK 不直接调用 Apple 的 UserDefaults“使用理由必填”API。底层平台访问由 Unity 负责，并由 Unity Engine 隐私清单包含相应声明。Audiencelab SDK 本身不需要增加此类 API 声明。

使用场景

累计追踪可用于：

  • LTV（生命周期价值）分析
  • 按付费层级做用户分群
  • 基于收入里程碑做 cohort 分析

On this page

获取累计购买金额获取累计广告收入工作原理