调整使用情况¶

如果本文档中任何内容不清楚、不正确或需要更多详细信息，请通过 Github 或 Bugzilla 提交请求。也欢迎您提交更正或补充信息。

Firefox Focus（但 Firefox Klar 除外）使用名为 Adjust 的第三方安装跟踪框架跟踪某些类型的安装。目的是通过回答“此设备上的此用户是否响应 Mozilla 执行的特定广告活动安装了 Firefox Focus？”来确定 Firefox Focus 安装的来源。

该框架由链接到 Firefox Focus 的软件开发工具包 (SDK) 和由德国公司 adjust GmbH 运行的数据收集互联网服务后端组成。Adjust SDK 是开源的，并采用 MIT 许可证。它托管在 https://github.com/adjust/android_sdk。Firefox Focus 使用 Gradle 拉取 SDK 的未修改副本。 build.gradle 包含正在使用的框架版本。SDK 文档位于 https://docs.adjust.com。

调整集成¶

Adjust 框架通过 AdjustHelper 类进行抽象。所有与 Adjust 的交互都通过此类进行。

调整消息¶

Adjust SDK 收集并将一种类型的消息发送到 Adjust 后端

在新应用程序会话开始时，会发送一个会话消息，其中包含基本系统信息以及自上次使用以来的应用程序使用频率。

消息在下面详细记录了每个 HTTP 请求中发送的内容。所有消息都发布到 https://app.adjust.com 的安全端点。它们都是 application/x-www-form-urlencoded HTTP POST 请求。

会话消息¶

请求¶

bundle_id:               org.mozilla.focus
tracking_enabled:        0
language:                en
country:                 CA
app_version:             4.2
device_name:             Pixel 2
app_version_short:       2.0
needs_response_details:  0
attribution_deeplink:    1
session_count:           1
os_name:                 android
event_buffering_enabled: 0
idfv:                    8D452BFB-0692-4E8C-9DE0-7578486A872E
hardware_name:           J127AP
app_token:               xxxxxxxxxxxx
os_version:              10.1
environment:             production
created_at:              2016-11-10T20:34:39.720Z-0500
device_type:             phone
idfa:                    00000000-0000-0000-0000-000000000000
sent_at:                 2016-11-10T20:34:39.787Z-0500

这些参数（包括未公开给 Mozilla 的参数）在 https://partners.adjust.com/placeholders/ 中有记录

响应¶

如果应用程序成功归因于特定广告系列，则广告系列的详细信息将作为 JSON 响应发送回来

{ "app_token": "xxxxxxxxxxxx",
  "adid": "00000000000000000000",
  "attribution" { "tracker_token": "xxxxxx",
                  "tracker_name": "Network::CAMPAIGN::ADGROUP::CREATIVE",
                  "network": "Network",
                  "campaign":"CAMPAIGN",
                  "adgroup":"ADGROUP",
                  "creative":"CREATIVE" } }

应用程序无需此信息并会忽略它。