事件说明

代表唯一设备的应用安装和首次会话，是主要的安装归因事件。

追踪触发条件

自动追踪 ——当唯一设备标识符首次通过 SDK/S2S 集成发送会话时触发。

技术详情

事件说明

追踪所有应用启动和用户会话，为互动和留存指标提供基础数据。

追踪触发条件

自动追踪 ——当通过 SDK/S2S 集成发送会话时触发。包括首次会话（安装）和所有后续应用启动。

会话定义

会话在应用进入前台时开始，在应用切换至后台后经过可配置的超时时间（默认 60 秒）后结束。

技术详情

在分析中的用途

会话事件驱动多个衍生指标：

• 日活跃用户 (DAU)： 指定日期内有会话的唯一用户数
• 留存率： 回访后续会话的用户比例
• 会话频率： 一段时间内每位用户的平均会话数
• 再互动归因： 来自再互动广告活动的会话

事件说明

追踪通过 SDK 收入方法上报且未指定自定义事件名称的应用内购买和收入事件。

追踪触发条件

当 SDK/S2S 集成通过 收入方法 上报收入事件，且该收入事件在 SDK 配置中没有自定义名称时触发。

技术详情

实现示例

iOS SDK：

// Track revenue without custom event name (appears as __iap__)
Singular.revenue(withAmount: 9.99, currency: "USD")

Android SDK：

// Track revenue without custom event name (appears as __iap__)
Singular.revenue("USD", 9.99);

S2S 收入：

amt=9.99&cur=USD&is_revenue_event=true

事件说明

聚合收入事件，每当上报任意类型的收入时自动触发，与收入来源或事件名称无关。

追踪触发条件

自动追踪 ——通过任意方式上报收入时触发：

• __iap__ 事件触发（默认收入事件）
• SDK 上报广告变现收入事件
• S2S 以自定义事件名称上报收入（例如"purchase"）
• 其他收入事件（如"refund"或"offline_purchase"）被上报

回调配置警告

技术详情

使用场景

何时使用 __REVENUE__ ：

• 向合作伙伴平台发送覆盖所有收入类型的单一回调
• 无需按事件细分的聚合收入报告
• 以单一收入事件简化合作伙伴配置

何时使用特定收入事件：

• 对 IAP、订阅和广告收入分别追踪
• 在合作伙伴平台中进行事件级优化
• 按事件类型进行详细的收入归因

事件说明

追踪应用卸载，支持流失分析和再互动广告活动定向。

追踪触发条件

自动追踪 ——当 iOS 或 Android 应用启用卸载追踪且检测到至少一次卸载时触发。一旦检测到某设备的卸载，该事件每天触发一次，直至重装或达到数据保留期限。

前提条件

必须先在 Singular 平台中显式启用卸载追踪， __UNINSTALL__ 事件才会出现。

各平台设置：

• iOS 卸载追踪入门
• Android 卸载追踪入门

技术详情

卸载检测方式

iOS： 静默推送通知验证

Android： FCM（Firebase Cloud Messaging）验证

事件说明

追踪用户在此前卸载后重新安装应用的行为，支持召回广告活动效果衡量和用户生命周期分析。

追踪触发条件

自动追踪 ——当通过 SDK/S2S 启用卸载追踪后，若某设备已追踪到 __UNINSTALL__ ，则后续触发的 __SESSION__ 会自动触发 __REINSTALL__ 事件。

触发序列

1. 初始安装： 用户安装应用，追踪 __START__ 和 __SESSION__
2. 应用使用： 用户使用应用，追踪多个 __SESSION__ 事件
3. 卸载： 用户卸载应用， __UNINSTALL__ 被检测并追踪
4. 重装： 用户重新安装应用并启动
5. 重装检测： __UNINSTALL__ 后的首个 __SESSION__ 触发 __REINSTALL__ 事件

技术详情

归因注意事项

如果用户在重装前点击了广告活动链接，重装可归因于再互动广告活动。归因窗口设置同样适用于重装归因，与初始安装归因相同。

指标定义

追踪唯一设备的首次会话，代表新应用安装，是主要归因指标。

计算方法

统计报告期内首次触发 __SESSION__ 事件的唯一设备标识符数量。

在报告中的用途

• 广告活动效果衡量
• 按来源和渠道进行安装归因
• 每次安装成本（CPI）计算
• 安装漏斗分析

指标定义

追踪由再互动广告活动触发的会话，衡量针对现有用户的广告活动效果。

配置依赖

再互动追踪取决于合作伙伴配置设置，该设置定义了再互动归因窗口和广告活动参数。

计算方法

在配置的归因窗口内归因于再互动广告活动的会话，无论是否为该用户的首次或后续会话。

在报告中的用途

• 再互动广告活动 ROI 衡量
• 沉睡用户激活率
• 跨渠道再互动效果
• 用户生命周期阶段转化

指标定义

统计指定日期内至少有一次会话的唯一用户数量，衡量活跃用户规模。

计算方法

统计在特定日历日内至少触发一次 __SESSION__ 事件的唯一设备标识符数量。

相关指标

• WAU： 周活跃用户（7 天唯一用户数）
• MAU： 月活跃用户（30 天唯一用户数）
• DAU/MAU 比率： 粘性指标（DAU 除以 MAU）

在报告中的用途

• 应用互动趋势分析
• 用户规模增长衡量
• 季节性使用模式识别
• 平台健康状况监控

指标定义

已安装应用（首次会话）的用户在指定时间段内回访的比例。

计算方法

（安装后第 N 天有会话的用户数 / 第 0 天安装的总用户数）× 100

留存类型

在报告中的用途

• 产品市场契合度评估
• 用户引导效果衡量
• 广告活动质量对比（高留存 vs 低留存来源）
• 流失预测与防止

指标定义

追踪 IAP（应用内购买）、自定义收入事件和订阅收入，不含广告变现收入。

包含的收入来源

• __iap__ 事件（默认收入事件）
• 自定义收入事件（purchase、subscription 等）
• 订阅续费和升级
• 一次性购买和消耗品

排除的收入来源

• 广告变现收入（在广告变现收入中单独追踪）

在报告中的用途

• 广告活动 ROI 和 ROAS 计算
• 用户生命周期价值（LTV）衡量
• 变现漏斗分析
• 按来源进行收入归因

指标定义

仅追踪广告变现事件产生的收入，将广告收入与购买收入分开统计。

包含的收入来源

• 横幅广告展示
• 插屏广告观看
• 激励视频完成
• 原生广告互动
• 积分墙完成

实现要求

需要集成广告变现 SDK，或通过 S2S 上报广告收入并指定相应的事件类型。

在报告中的用途

• 广告变现策略优化
• 混合变现模式分析
• 用户细分盈利能力（IAP vs 广告收入）
• 填充率和 eCPM 效果

指标定义

追踪所有来源的所有收入事件，提供完整的变现视图，包括 IAP、订阅和广告收入。

计算方法

总收入 = 收入 + 广告变现收入

包含的收入来源

• 所有 IAP 和购买收入
• 订阅收入
• 广告变现收入
• 自定义收入事件（退款、线下购买等）

在报告中的用途

• 完整的广告活动 ROI 衡量
• 跨变现类型的混合 LTV 计算
• 整体业务表现追踪
• 跨渠道盈利能力对比