课程大纲 第 113 课,共 156 课 · 应用与设备
应用与设备

第 5 阶段项目:设备报告

为什么重要 这是完整的工作,从头到尾:一份来自一户拥有一部手机和一台智能电视的人家的捕获,以及一份简短的报告,为每台设备说明它在和谁通信、它发送了哪些 ID 和哪些种类的数据,以及这两台设备能否被联系到同一个人身上。这正是你会希望为你自己家准备的那种报告。

捕获

hidden_capture() 给你一份在同一个家庭网络上有两台设备的捕获:

from watched.leg5b_apps import hidden_capture, SDK_OWNERS

cap = hidden_capture()
print(cap["first_party"])     # {'phone': 'StepBee', 'tv': 'ScreenMaker'}
print(len(cap["entries"]))
print(cap["entries"][0]["device"])   # 'phone' or 'tv'

first_party 说明每台设备的软件是哪家公司制作的(手机应用的制作者,以及电视的制造商)。每一个条目都和以前的形状一样,外加 "device"。评分器还会在其他隐藏的捕获上(带着你看不到的种子的 hidden_capture(seed))运行你的代码,所以不要把这一份捕获的任何东西写死。

报告

你的报告是一个有两个键的字典。"devices" 把 first_party 中的每个设备名称映射到一个字典,其中包含:

键值
"destinations"这台设备联系过的每一个主人组成的排好序的列表(使用你的 owner_of;如果出现了设备自己的制造商和 "Unknown",也要包括在内)
"identifiers"带着真实值发送的标识符字段名组成的排好序、没有重复的列表
"zeroed_ad_id"如果 AD_ID_NAMES 中有任何一个字段以值 ZERO_AD_ID 发送,就为 True
"location"如果发送了任何种类为 location 的字段,就为 True
"acr"如果发送了任何种类为 viewing 的字段,就为 True
"score"这台设备的条目的共享分数,以这台设备的 first_party 主人作为应用主人

"linked_ids" 是一个排好序的列表,包含被不止一台设备发送过的标识符值(只算真实的值)。如果同一个值同时从手机和电视发出,任何同时收到两者的人都能看出它们属于同一户人家,或者同一个人。

跨设备关联:认出两台设备属于同一个人,通常是因为两者发送了同一个账号 ID 或哈希电子邮件。一则电视广告和一次手机购物就是这样被拼接进同一份画像的。

在写代码之前先做计划

  1. 从上一个练习里复制 owner_of、sharing_graph 和 sharing_score。
  2. 对每台设备,过滤出它的条目:[e for e in cap["entries"] if e["device"] == device]。
  3. 使用 fields_of 和 DATA_KINDS,把每个字段过一遍,设置那些标志并收集标识符的名字。趁着在那里,在一个“值 -> 设备集合”的字典里,记录下每一个真实的标识符值是由哪些设备发送的。
  4. 为这台设备的条目构建图;它的键排好序就是目的地,而它也会给你分数。
  5. 处理完所有设备之后,保留那些集合中有不止一台设备的值。

最后是“提交”这一步:用 json.dumps(report, sort_keys=True) 把报告变成 JSON 文本。JSON 是几乎每一种工具都能读的纯文本格式,这就是为什么报告和 API 都使用它。

解读你自己的结果

当你打印出你的报告时,留意三件事。手机是否显示了 zeroed_ad_id,却仍然发送了其他的标识符?电视是否发送了 viewing 数据,发给了谁?以及是否存在一个被关联的值?在这份捕获上是有的:哈希过的电子邮件。在每台设备上登录一次,就足以把它们拼接起来。

防御

报告的每一行都提示了一个修复方法:关闭电视上的 ACR,在手机上拒绝跟踪,只在需要时才在电视上登录(或者使用一个不同的电子邮件),并把位置限制为“使用期间”。在做了这些改变之后,对一份新的捕获再运行一次报告,分数就会下降;这种前后对比就是证据。

用其他语言实现

JavaScript:关联这一步,用一个由 Set 组成的 Map。

const seen = new Map();
for (const e of cap.entries) {
  for (const [name, value] of fieldsOf(e)) {
    if (DATA_KINDS[name] === "identifier" && value !== ZERO_AD_ID && value.trim()) {
      if (!seen.has(value)) seen.set(value, new Set());
      seen.get(value).add(e.device);
    }
  }
}
const linked = [...seen].filter(([, d]) => d.size > 1).map(([v]) => v).sort();
const reportJson = JSON.stringify(report);

PHP:json_encode($report) 完成提交这一步。

回顾

  • 一份设备报告会为每台设备列出联系过的主人、发送的标识符、位置和收视标志,以及一个分数。
  • 同一个真实的 ID 值从两台设备发出,就会把它们关联到同一个人身上。
  • JSON 是把报告交给其他工具时使用的纯文本格式。
  • 在改变设置之后重新运行报告,能给你证明这些设置生效了的证据。
轮到你了

编写 device_report(capture, owners),返回上面描述的报告:一个字典,包含 "devices"(capture["first_party"] 中的每台设备一个条目,每个都有 destinations、identifiers、zeroed_ad_id、location、acr 和 score)以及 "linked_ids"。你还需要上一个练习里的 owner_of、sharing_graph 和 sharing_score;在这个程序里定义它们。使用练习世界中的 fields_of、DATA_KINDS、AD_ID_NAMES 和 ZERO_AD_ID。
然后设 report = device_report(hidden_capture(), SDK_OWNERS),设 report_json = json.dumps(report, sort_keys=True),并打印 report_json。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。