Programme Leçon 113 sur 156 · Applis et appareils
Applis et appareils

Projet de l'étape 5 : le rapport sur les appareils

Pourquoi c'est important Voici le travail complet, du début à la fin : une capture d'un foyer avec un téléphone et une télévision connectée, et un court rapport qui dit, pour chaque appareil, à qui il parle, quels identifiants et types de données il envoie, et si les deux appareils peuvent être reliés à la même personne. C'est exactement le rapport que tu voudrais sur ton propre foyer.

La capture

hidden_capture() te donne une capture avec deux appareils sur un même réseau domestique :

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 dit quelle entreprise a fait le logiciel de chaque appareil (le fabricant de l'appli du téléphone, et le fabricant de la télévision). Chaque entrée a la même forme qu'avant, plus "device". Le correcteur lance aussi ton code sur d'autres captures cachées (hidden_capture(seed) avec des graines que tu ne vois pas), donc ne code rien en dur à propos de celle-ci.

Le rapport

Ton rapport est un dict à deux clés. "devices" associe chaque nom d'appareil de first_party à un dict avec :

CléValeur
"destinations"liste triée de chaque propriétaire contacté par l'appareil (utilise ton owner_of ; inclus le fabricant de l'appareil et "Unknown" s'ils apparaissent)
"identifiers"liste triée, sans doublons, des noms de champs identifiants envoyés avec une vraie valeur
"zeroed_ad_id"True si un champ de AD_ID_NAMES a été envoyé avec la valeur ZERO_AD_ID
"location"True si un champ de type location a été envoyé
"acr"True si un champ de type viewing a été envoyé
"score"le score de partage des entrées de cet appareil, avec le propriétaire first_party de l'appareil comme propriétaire de l'appli

"linked_ids" est une liste triée des valeurs d'identifiants (les vraies seulement) envoyées par plus d'un appareil. Si la même valeur quitte à la fois le téléphone et la télévision, quiconque reçoit les deux peut savoir qu'ils appartiennent à un même foyer, ou à une même personne.

Liaison entre appareils (cross-device linking) : reconnaître que deux appareils appartiennent à la même personne, en général parce que les deux envoient le même identifiant de compte ou le même e-mail haché. C'est ainsi qu'une publicité à la télévision et un achat sur le téléphone se retrouvent réunis dans un seul profil.

Planifie avant de coder

  1. Recopie owner_of, sharing_graph et sharing_score de l'exercice précédent.
  2. Pour chaque appareil, filtre ses entrées : [e for e in cap["entries"] if e["device"] == device].
  3. Parcours chaque champ une fois, avec fields_of et DATA_KINDS, en réglant les drapeaux et en collectant les noms d'identifiants. Au passage, note quels appareils ont envoyé chaque vraie valeur d'identifiant, dans un dict valeur -> set d'appareils.
  4. Construis le graphe des entrées de l'appareil ; ses clés, triées, sont les destinations, et il te donne le score.
  5. Après tous les appareils, garde les valeurs dont le set contient plus d'un appareil.

Enfin, l'étape d'« envoi » : transforme le rapport en texte JSON avec json.dumps(report, sort_keys=True). JSON est le format texte que presque tous les outils savent lire, c'est pourquoi les rapports et les API l'utilisent.

Lire ton propre résultat

Quand tu affiches ton rapport, remarque trois choses. Le téléphone montre-t-il zeroed_ad_id tout en envoyant d'autres identifiants ? La télévision envoie-t-elle des données viewing, et à qui ? Et y a-t-il une valeur reliée ? Sur cette capture, oui : l'e-mail haché. Une connexion sur chaque appareil suffit à les réunir.

La défense

Chaque ligne du rapport suggère une correction : désactive l'ACR sur la télévision, refuse le suivi sur le téléphone, connecte-toi à la télévision seulement si tu en as besoin (ou avec un autre e-mail), et limite la position à « pendant l'utilisation ». Relance le rapport sur une capture faite après ces changements et le score baisse ; cet avant-après est la preuve.

Dans d'autres langages

JavaScript : l'étape de liaison, avec une Map de Set.

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) fait l'étape d'envoi.

Récap

  • Un rapport sur les appareils liste, par appareil, les propriétaires contactés, les identifiants envoyés, les drapeaux de position et de visionnage, et un score.
  • La même vraie valeur d'identifiant qui quitte deux appareils les relie à une seule personne.
  • JSON est le format texte pour passer un rapport à d'autres outils.
  • Relancer le rapport après avoir changé les réglages te donne la preuve que les réglages ont marché.
À ton tour

Écris device_report(capture, owners) qui renvoie le rapport décrit ci-dessus : un dict avec "devices" (une entrée par appareil de capture["first_party"], chacune avec destinations, identifiers, zeroed_ad_id, location, acr et score) et "linked_ids". Tu auras aussi besoin de owner_of, sharing_graph et sharing_score de l'exercice précédent ; définis-les dans ce programme. Utilise fields_of, DATA_KINDS, AD_ID_NAMES et ZERO_AD_ID du monde d'entraînement.
Puis définis report = device_report(hidden_capture(), SDK_OWNERS), définis report_json = json.dumps(report, sort_keys=True), et affiche report_json.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.