卸载与重装跟踪
Adjust 的卸载与重装跟踪功能为您提供应用留存率的深入洞察。通过了解用户何时从其设备上卸载并重新安装您的应用,您可以准确评估自然和渠道合作伙伴的表现,了解用户流失情况以及评估应用的生命周期。
操作前须知
要求
购买我们的卸载与重装跟踪套餐。
- 如需了解更多信息,请联系您的销售经理,或发送电子邮件至 sales@adjust.com 与我们联系。
iOS :Adjust SDK 4.18.1 或以上版本
安卓 :Adjust SDK 版本 4.12 或更高版本
应用需已集成推送通知相关功能,因为Adjust 需依赖推送通知的功能来确认应用是否处于安装或者卸载状态。请参阅适用于 iOS 应用和安卓应用的集成指南。
实用信息
- 重装在 Adjust 中被视作应用内事件,不会自动产生再归因
有关卸载与重装 KPI、回传、Amazon S3 存储桶上传和受众分群工具功能的详细信息,请参阅以下各部分:
对 iOS 应用进行卸载和重装跟踪
Adjust 的应用卸载与重装跟踪功能,是根据静默推送通知,来了解设备上是否安装了应用。有关配置应用以在 iOS 设备上发送推送通知的开发者说明,请参见下文。
使用以下资源准备您的 iOS 应用,以便 Adjust 为您跟踪卸载与重装。
要求
在 Xcode 中配置后台模式功能,启用远程通知
iOS 推送服务证书
- 需要拥有访问您应用的 Apple 开发者门户权限的用户,通过控制面板的中的 证书、标识符和配置文件 来下载此证书。
- 您必须将此文件导出为 P12 格式,并在应用的 平台 设置中将其(以及相关密码)上传到 Adjust(参阅下文)。这会授予我们在您的应用中使用推送通知的权限。
输入到应用的平台设置中的 Bundle ID
导出 iOS 推送服务证书
如需查找并导出已有证书,请按照以下步骤在 Keychain Access 应用中操作。
- 选择 证书 类别
- 右键单击相关 Apple Push Services (Apple 推送服务) 证书,切勿包含其私钥或任何其他证书
- 选择 导出“Apple 推送服务:your.bundle.id"
- 为导出的文件命名
- 从 文件格式 下拉菜单中选择 Personal Information Exchange (个人信息交换) (.p12)
- 选择 保存
- 可选操作 :输入密码。如果输入密码,您需要在 Adjust 控制面板中上传此文件时需将其包含在内。
- 选择 确定
如要创建新证书,请选择以下类型中的一种:
- Apple 推送通知服务 SSL (测试环境)
- Apple 推送通知服务 SSL (测试 & 生产环境)
要成功上传证书至 Adjust 控制面板,则必须使用CN=Apple Push Services
。
macOS Apple 推送通知服务 SSL (生产环境) (Production)
将 iOS 推送服务证书上传到 Adjust 账户
在 Adjust 控制面板中
- 导航到应用,点击您应用选项上的 ^ 符号
- 选择 所有设置 > 平台
- 选择 APNS
- 选择 选择证书文件
- 找到您的证书文件并选择 打开
- 如果在创建证书时输入了密码,请在 密码 字段中输入密码
- 选择 保存
更新 iOS 推送通知证书
推送服务证书在创建一年后到期。若要不间断地跟踪卸载与重装,您需确保在证书到期之前更新证书。Adjust 会在证书到期前两周,通过电子邮件向您发送提醒邮件。收到此电邮后,请按照下列步骤操作:
在 Apple 开发者门户中
- 选择主屏幕右上方的 账户
- 选择 证书、标识符和配置文件
- 选择屏幕右上方的加号 (
+
) 图标 - 在 Production (生产环境) 下,勾选 Apple Push Notification service SSL (Sandbox & Production) (Apple 推送服务证书(测试&生产环境))
- 选择 Continue (继续)
- 从 App ID(应用 ID) 下拉菜单中选择您的应用 ID
- 选择 Continue (继续)
- 按照说明创建 CSR 文件
- 选择 Continue (继续)
- 通过点选 Choose File(选择档案) 按钮上传新创建的 CSR 文件
- 选择 Continue (继续)
- 选择 Download(下载)
- 从下载列表或文件夹中打开新下载的证书文件,将其添加到您的 Keychain Access 中
- 按照说明将 iOS 推送服务证书上传到您的 Adjust 账户
对安卓应用进行卸载和重装跟踪
Adjust 的应用卸载与重装跟踪功能,是根据静默推送通知,来了解设备上是否安装了应用。有关配置应用以跟踪卸载与重装的开发者说明,请参见下文。如果已使用 Firebase Cloud Messaging 为应用和 Adjust SDK 配置了推送通知,则可跳至如何查找 FCM 服务器密钥部分。
注意 :您必须通过 Firebase Cloud Messaging (FCM) 为应用配置推送通知。不支持 Google Cloud Messaging (GCM)。
要求
- 与 Adjust SDK 4.12 或以上版本集成 — 下载 Adjust SDK 最新版本
- 配置 Adjust SDK 以接收应用的推送通知识别码(注册识别码)
- 将 Firebase 添加到您的应用,并配置 Firebase Cloud Messaging
- 有效的 FCM 服务器密钥(见下方)
查找 FCM 服务器密钥
在 Firebase 控制台中
- 点选设置(齿轮)图标 > 项目设置
- 选择 CLOUD MESSAGING
- 查找 服务器密钥 识别码
添加 FCM 服务器密钥至 Adjust 账户
在 Adjust 控制面板中
- 导航到应用,点击您应用选项上的 ^ 符号
- 选择 所有设置 > 平台
- 选择 Firebase Cloud Messaging
- 将 FCM 密钥输入或粘贴到 FCM 密钥 字段中
- 选择 保存
卸载与重装常见问题
我的应用被卸载时,Adjust 是如何报告的?
Adjust SDK 会记录每台设备上每个应用的推送标签。安装应用后,Adjust 通过 Apple 推送通知 (APN) 服务或 Firebase,使用推送标签将静默推送通知发送至您的相关应用。系统每天按照世界标准时间处理并更新 Firebase(用于安卓)和 APN(用于 iOS)的响应。您可以在控制面板的数据上实时看到所有相关的可用数据集。
通过响应,APNs 和 Firebase 可以提供卸载日期。卸载日期与用户实际卸载的时间不同,最多会晚一周多时间。因此,Adjust 会使用最后一次会话的日期和时间报告卸载。
示例: 最后会话 = 1 月 1 日星期一 06:00 时
检测到卸载 = 1 月 5 日星期五 13:00 时
Adjust 报告卸载 = 1 月 1 日星期五 06:00 时
什么是静默推送通知?
标准推送通知是用来向特定应用用户传递消息,当要向应用本身发送消息时则使用静默推送通知。通过静默推送通知,应用可以在不向用户显示任何信息的状况下,从后台接收和处理信息。
用户可以禁用应用的推送通知,但我们仍然可以发送静默推送通知。
Adjust 如何管理推送标签和静默推送通知?
推送标签由 Apple (APN) 和 Google (Firebase) 创建,并在设备层级上指定给不同应用。根据您的应用和安装应用的具体设备,每个推送标签都是独一无二的。Adjust SDK 会收集并传输推送标签,存储在我们的数据库中。
静默推送通知由 Adjust 服务器生成,并通过相关推送通知服务发送至您的应用。
在 iOS 上,我们会通过 APN 发送下列 payload:
{"aps":{"content-available":"1"},"adjust_purpose":"uninstall detection"}
在安卓上,我们会将下列 payload 发送给 FCM,后者会将其发送给您的应用:
{"to":"pushToken","data":{"adjust_purpose":"uninstall detection"}}
Adjust 向我的应用发送静默推送通知的频率如何?
Adjust 按照世界标准时间在每个日历日发送一次静默推送通知。
如何在我的控制面板中显示卸载与重装跟踪?
在可交付数据 KPI 和同期群 KPI 帮助页面,即可查找控制面板中显示的有关卸载与重装 KPI 信息。
什么是再归因重装?
Adjust 视重装为应用内事件。此类事件不会影响我们的归因方法,换言之,重装不会自动被视为再归因。仅当重装会话满足您在应用或跟踪链接层再归因设置中的要求时,我们才会对该用户进行再归因,并将其回报为再归因重装。
再归因重装示例
您的再归因设置默认为:
- 7 天非活跃天数
- 7 天再归因窗口
出现以下情况:
- 用户卸载您的应用,7 天内没有触发应用内会话(可能包含卸载前的时间)
- 用户点击 Adjust 跟踪的再交互广告
- 用户重装应用并在交互的 7 天内触发应用内会话
- Adjust 记录再归因重装
注意: 在 Adjust 跟踪再归因重装时,重装数据将被同时纳入到可交付数据中的再归因重装
和再归因
统计数据中。如果您已设置接收回传,则将仅接收再归因重装的回传。如果您已设置接收回传,则将仅接收再归因重装
的回传。
为什么在 Sandbox 环境中测试的卸载不会出现在我的控制面板中?
卸载事件并非源自我们的 SDK。Adjust 后端要在收到 Apple 推送通知服务或 Firebase 的响应,且同时处在被硬编码为生产
的环境时,才会创建卸载事件。Adjust 也只会检查在生产
环境中记录了最后一次活动的应用卸载。因此,在 Sandbox 模式下测试的卸载事件不会出现在 Adjust 控制面板中。
如何从 Adjust 接收卸载和重装活动?
出现卸载、重装或再归因重装时,您可以通过 Adjust 的实时回传系统或我们的 CSV 上传到云储存收到通知。
注意 :以下广告 ID 可用于卸载回传: {{idfa}}
, {{gps_adid}}
, {{oaid}}
, {{oaid_md5}}
, {{web_uuid}}
。确保在卸载回传字符串或 S3 存储桶 CSV 定义中纳入合适的占位符,以便您可以将相应值映射到系统中的其他广告 ID。
说明
在 Adjust 控制面板中
导航到应用,点击您应用选项上的 ^ 符号
选择 所有设置 > 原始数据导出 > 实时回传
点选以下任一选项旁的编辑(铅笔)图标:
- 全局回传
- 卸载
- 重装
- 重装再归因
输入回传 URL 并附加任何所需的关键参数来通过回传接收所需信息。以下是与卸载和重装跟踪直接相关的 Adjust 占位符:
{time_to_uninstall}
{time_to_reinstall}
{uninstalled_at}
{reinstalled_at}
{last_session_time}
您还可以查看包含说明的 Adjust 可用占位符完整列表。
选择 更新
在 Adjust 控制面板中
上传 CSV 至云储存的说明
导航到应用,点击您应用选项上的 ^ 符号
选择 所有设置 > 原始数据导出 > CSV 上传
选择 选择要导出的事件
选择以下任何一项:
- 卸载
- 重装
- 重装再归因
在 CSV 定义 中,您可纳入以下任何与卸载和重装跟踪相关的占位符
{time_to_uninstall}
{time_to_reinstall}
{uninstalled_at}
{reinstalled_at}
{last_session_time}
您还可以查看包含说明的 Adjust 可用占位符完整列表。
选择 保存