语言 

卸载与重装跟踪

Adjust 的卸载与重装跟踪功能为您提供应用留存率的深入洞察。通过了解用户何时从其设备上卸载并重新安装您的应用,您可以准确评估自然和渠道合作伙伴的表现,了解用户流失情况以及评估应用的生命周期。

操作前须知

要求

  • 购买我们的卸载与重装跟踪套餐。

    • 如需了解更多信息,请联系您的销售经理,或发送电子邮件至 sales@adjust.com 与我们联系。
  • iOS​ :Adjust SDK 4.18.1 或以上版本

  • 安卓​ :Adjust SDK 版本 4.12 或更高版本

  • 应用需已集成推送通知相关功能,因为Adjust 需依赖推送通知的功能来确认应用是否处于安装或者卸载状态。请参阅适用于 iOS 应用安卓应用的集成指南。

实用信息

  • 重装在 Adjust 中被视作应用内事件,不会自动产生再归因

有关卸载与重装 KPI、回传、Amazon S3 存储桶上传和受众分群工具功能的详细信息,请参阅以下各部分:

1-4:Adjust 获取应用的推送标签 (push token)

1/2

对 iOS 应用进行卸载和重装跟踪

Adjust 的应用卸载与重装跟踪功能,是根据静默推送通知,来了解设备上是否安装了应用。有关配置应用以在 iOS 设备上发送推送通知的开发者说明,请参见下文。

使用以下资源准备您的 iOS 应用,以便 Adjust 为您跟踪卸载与重装。

要求

  • 在 Xcode 中配置后台模式功能,启用远程通知

  • iOS 推送服务证书

    • 需要拥有访问您应用的 Apple 开发者门户权限的用户,通过控制面板的中的  证书、标识符和配置文件​ 来下载此证书。
    • 您必须将此文件导出为 P12 格式,并在应用的  平台​ 设置中将其(以及相关密码)上传到 Adjust(参阅下文)。这会授予我们在您的应用中使用推送通知的权限。
  • 输入到应用的平台设置中的 Bundle ID

导出 iOS 推送服务证书

如需查找并导出已有证书,请按照以下步骤在 Keychain Access 应用中操作。

  1. 选择  证书​ 类别
  2. 右键单击相关  Apple Push Services​ (Apple 推送服务) 证书,切勿包含其私钥或任何其他证书
  3. 选择  导出“Apple 推送服务:your.bundle.id"
  4. 为导出的文件命名
  5. 从  文件格式​ 下拉菜单中选择  Personal Information Exchange (个人信息交换)​ (.p12)
  6. 选择  保存
  7. 可选操作 :输入密码。如果输入密码,您需要在 Adjust 控制面板中上传此文件时需将其包含在内。
  8. 选择  确定

如要创建新证书,请选择以下类型中的一种:

  • Apple 推送通知服务 SSL (测试环境)
  • Apple 推送通知服务 SSL (测试 & 生产环境)

要成功上传证书至 Adjust 控制面板,则必须使用CN=Apple Push Services

警告:
注意:无法使用以下类型证书:macOS Apple 推送通知服务 SSL (生产环境) (Production)

将 iOS 推送服务证书上传到 Adjust 账户

在 Adjust 控制面板中

  1. 导航到应用,点击您应用选项上的 ^ 符号
  2. 选择  所有设置​ >  平台
  3. 选择  APNS
  4. 选择  选择证书文件
  5. 找到您的证书文件并选择  打开
  6. 如果在创建证书时输入了密码,请在  密码​ 字段中输入密码
  7. 选择  保存

更新 iOS 推送通知证书

推送服务证书在创建一年后到期。若要不间断地跟踪卸载与重装,您需确保在证书到期之前更新证书。Adjust 会在证书到期前两周,通过电子邮件向您发送提醒邮件。收到此电邮后,请按照下列步骤操作:

在 Apple 开发者门户中

  1. 选择主屏幕右上方的 账户
  2. 选择 证书、标识符和配置文件
  3. 选择屏幕右上方的加号 (+) 图标
  4. Production (生产环境)​ 下,勾选 Apple Push Notification service SSL (Sandbox & Production) (Apple 推送服务证书(测试&生产环境))
  5. 选择 Continue​ (继续)
  6. App ID(应用 ID)​ 下拉菜单中选择您的应用 ID
  7. 选择 Continue​ (继续)
  8. 按照说明创建 CSR 文件
  9. 选择 Continue​ (继续)
  10. 通过点选 Choose File(选择档案)​ 按钮上传新创建的 CSR 文件
  11. 选择 Continue​ (继续)
  12. 选择 Download(下载)
  13. 从下载列表或文件夹中打开新下载的证书文件,将其添加到您的 Keychain Access 中
  14. 按照说明将 iOS 推送服务证书上传到您的 Adjust 账户

对安卓应用进行卸载和重装跟踪

Adjust 的应用卸载与重装跟踪功能,是根据静默推送通知,来了解设备上是否安装了应用。有关配置应用以跟踪卸载与重装的开发者说明,请参见下文。如果已使用 Firebase Cloud Messaging 为应用和 Adjust SDK 配置了推送通知,则可跳至如何查找 FCM 服务器密钥部分。

注意​ :您必须通过 Firebase Cloud Messaging (FCM) 为应用配置推送通知。不支持 Google Cloud Messaging (GCM)。

要求

查找 FCM 服务器密钥

在 Firebase 控制台中

  1. 点选设置(齿轮)图标 >  项目设置
  2. 选择  CLOUD MESSAGING
  3. 查找 服务器密钥​ 识别码

添加 FCM 服务器密钥至 Adjust 账户

在 Adjust 控制面板中

  1. 导航到应用,点击您应用选项上的 ^ 符号
  2. 选择  所有设置​ >  平台
  3. 选择  Firebase Cloud Messaging
  4. 将 FCM 密钥输入或粘贴到  FCM 密钥​ 字段中
  5. 选择  保存

卸载与重装常见问题

我的应用被卸载时,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 天再归因窗口

出现以下情况:

  1. 用户卸载您的应用,7 天内没有触发应用内会话(可能包含卸载前的时间)
  2. 用户点击 Adjust 跟踪的再交互广告
  3. 用户重装应用并在交互的 7 天内触发应用内会话
  4. 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 控制面板中

  1. 导航到应用,点击您应用选项上的 ^ 符号

  2. 选择  所有设置​ >  原始数据导出​ > 实时回传

  3. 点选以下任一选项旁的编辑(铅笔)图标:

    • 全局回传
    • 卸载
    • 重装
    • 重装再归因
  4. 输入回传 URL 并附加任何所需的关键参数来通过回传接收所需信息。以下是与卸载和重装跟踪直接相关的 Adjust 占位符:

    • {time_to_uninstall}
    • {time_to_reinstall}
    • {uninstalled_at}
    • {reinstalled_at}
    • {last_session_time}

    您还可以查看包含说明的 Adjust 可用占位符完整列表

  5. 选择 更新

在 Adjust 控制面板中
上传 CSV 至云储存的说明

  1. 导航到应用,点击您应用选项上的 ^ 符号

  2. 选择 所有设置​ >  原始数据导出​ >  CSV 上传

  3. 选择 选择要导出的事件

  4. 选择以下任何一项:

    • 卸载
    • 重装
    • 重装再归因
  5. CSV 定义​ 中,您可纳入以下任何与卸载和重装跟踪相关的占位符

    • {time_to_uninstall}
    • {time_to_reinstall}
    • {uninstalled_at}
    • {reinstalled_at}
    • {last_session_time}

    您还可以查看包含说明的 Adjust 可用占位符完整列表

  6. 选择  保存