“激活” Ping(已弃用)

此移动设备专用 Ping 用于跟踪移动产品分发的激活情况,错误率很低。

将在启动时发送。至少,我们希望从每个客户端至少获取一次此 Ping。

提交将按照 Edge 服务器规范进行。

/submit/mobile/activation/v/docId

这是一个现代的“结构化摄取”Ping(命名空间不是遥测)。对于结构化摄取,我们将模式版本作为 URI 参数之一捕获,因此我们无需将其包含在消息正文中。

  • v 是 Ping 格式版本

  • docId 是用于去重的 UUID

结构

{
  "identifier": <string>, // Googled Ad ID hashed using bcrypt
  "clientId": <string>, // client id, e.g. "c641eacf-c30c-4171-b403-f077724e848a"
                        //included only if identifier was unable to be retrieved
  "manufacturer": <string>, // Build.MANUFACTURER
  "model": <string>, // Build.MODEL
  "locale": <string>, // application locale, e.g. "en-US"
  "os": <string>, // OS name.
  "osversion": <string>, // OS version.
  "created": <string>, // date the ping was created
                       // in local time, "yyyy-mm-dd"
  "tz": <integer>, // timezone offset (in minutes) of the
                   // device when the ping was created
  "app_name": <string>, // "Fennec"
  "channel": <string>, // Android package name e.g. "org.mozilla.firefox"
  "distributionId": <string> // Distribution identifier (optional)
}

字段详情

标识符

identifier 字段是使用 bcrypt 对 Google 广告 ID 进行哈希处理的结果。理想情况下,我们希望发送此字段而不是 client_id,但并非所有分发都启用了 Google Play 服务。

client_id

client_id 字段表示遥测客户端 ID,仅在标识符为空时包含。

渠道

channel 字段表示 Android 包名称。

版本历史

  • v1:初始版本 - 发布在 Fennec 68 中。

Android 实现说明

在 Android 上,上传器很有可能为给定客户端提供完整数据,但并非 100% 概率。这是一个为了简化代码而做出的有意识的决定。即使我们丢弃了一个 Ping,它也会在以后的启动时重新发送,直到我们确认它已上传。