Conteúdo do curso Lição 113 de 156 · Apps e dispositivos
Apps e dispositivos

Projeto da Etapa 5: o relatório dos dispositivos

Por que isso importa Este é o trabalho completo, do começo ao fim: uma captura de uma casa com um celular e uma smart TV, e um relatório curto que diz, para cada dispositivo, com quem ele fala, quais IDs e tipos de dados ele envia, e se os dois dispositivos podem ser ligados à mesma pessoa. É exatamente o relatório que você gostaria de ter sobre a sua própria casa.

A captura

hidden_capture() dá a você uma captura com dois dispositivos numa mesma rede doméstica:

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 diz qual empresa fez o software de cada dispositivo (a fabricante do app do celular e a fabricante da TV). Toda entrada tem o mesmo formato de antes, mais "device". O avaliador também roda o seu código em outras capturas ocultas (hidden_capture(seed) com sementes que você não vê), então não deixe nada fixo no código sobre esta.

O relatório

O seu relatório é um dict com duas chaves. "devices" mapeia cada nome de dispositivo de first_party para um dict com:

ChaveValor
"destinations"lista ordenada de cada dono que aquele dispositivo contatou (use o seu owner_of; inclua a própria fabricante do dispositivo e "Unknown" se aparecerem)
"identifiers"lista ordenada, sem repetições, dos nomes de campos de identificador enviados com um valor real
"zeroed_ad_id"True se algum campo de AD_ID_NAMES foi enviado com o valor ZERO_AD_ID
"location"True se algum campo do tipo location foi enviado
"acr"True se algum campo do tipo viewing foi enviado
"score"a nota de compartilhamento das entradas daquele dispositivo, com o dono first_party do dispositivo como dono do app

"linked_ids" é uma lista ordenada de valores de identificador (só os reais) que foram enviados por mais de um dispositivo. Se o mesmo valor sai tanto do celular quanto da TV, qualquer um que receba os dois consegue saber que eles pertencem a uma mesma casa, ou a uma mesma pessoa.

Ligação entre dispositivos: reconhecer que dois dispositivos pertencem à mesma pessoa, normalmente porque os dois enviam o mesmo ID de conta ou o mesmo e-mail com hash. É assim que um anúncio na TV e uma compra no celular são juntados num único perfil.

Planeje antes de programar

  1. Copie owner_of, sharing_graph e sharing_score do exercício anterior.
  2. Para cada dispositivo, filtre as entradas dele: [e for e in cap["entries"] if e["device"] == device].
  3. Percorra cada campo uma vez, usando fields_of e DATA_KINDS, definindo as marcações e juntando os nomes de identificadores. Aproveite para registrar quais dispositivos enviaram cada valor de identificador real, num dict valor -> conjunto de dispositivos.
  4. Monte o grafo das entradas do dispositivo; as chaves dele, ordenadas, são os destinos, e ele dá a você a nota.
  5. Depois de todos os dispositivos, guarde os valores cujo conjunto tem mais de um dispositivo.

Por fim, o passo de "envio": transforme o relatório em texto JSON com json.dumps(report, sort_keys=True). JSON é o formato de texto simples que quase toda ferramenta consegue ler, e é por isso que relatórios e APIs o usam.

Lendo o seu próprio resultado

Quando você imprimir o relatório, repare em três coisas. O celular mostra zeroed_ad_id e ainda assim envia outros identificadores? A TV envia dados de viewing, e para quem? E há um valor ligado? Nesta captura há: o e-mail com hash. Um login em cada dispositivo basta para juntá-los.

A defesa

Cada linha do relatório sugere uma correção: desligue o ACR na TV, diga não ao rastreamento no celular, entre na TV só se precisar (ou com outro e-mail) e limite a localização a "durante o uso". Rode o relatório de novo numa captura depois dessas mudanças e a nota cai; esse antes e depois é a evidência.

Em outras linguagens

JavaScript: o passo de ligação, com um Map de Sets.

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) faz o passo de envio.

Resumo

  • Um relatório de dispositivos lista, por dispositivo, os donos contatados, os identificadores enviados, as marcações de localização e de visualização, e uma nota.
  • O mesmo valor de ID real saindo de dois dispositivos os liga a uma pessoa.
  • JSON é o formato de texto simples para entregar um relatório a outras ferramentas.
  • Rodar o relatório de novo depois de mudar as configurações dá a você a evidência de que elas funcionaram.
Sua vez

Escreva device_report(capture, owners), que retorna o relatório descrito acima: um dict com "devices" (uma entrada por dispositivo de capture["first_party"], cada uma com destinations, identifiers, zeroed_ad_id, location, acr e score) e "linked_ids". Você também vai precisar de owner_of, sharing_graph e sharing_score do exercício anterior; defina-as neste programa. Use fields_of, DATA_KINDS, AD_ID_NAMES e ZERO_AD_ID do mundo de prática.
Depois defina report = device_report(hidden_capture(), SDK_OWNERS), defina report_json = json.dumps(report, sort_keys=True) e imprima report_json.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.