En-tête Sec-Browsing-Topics
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
Attention : Cette fonctionnalité est actuellement opposée par deux fournisseurs de navigateurs. Voir la section Positions sur les standards pour plus de détails sur l'opposition.
Note : Un processus d'inscription est requis pour utiliser cette fonctionnalité dans vos applications.
L'en-tête de requête HTTP Sec-Browsing-Topics envoie les sujets sélectionnés pour l'utilisateur·ice actuel·le avec la requête associée, qui sont utilisés par une plateforme publicitaire pour choisir une publicité personnalisée à afficher.
Si le site appelant n'inclut pas l'API Topics dans un processus d'inscription au bac à sable de confidentialité réussi, toute tentative de création ou de modification de Sec-Browsing-Topics échoue silencieusement, et tout en-tête Sec-Browsing-Topics existant est supprimé.
Voir Utiliser l'API Topics pour plus de détails.
| Type d'en-tête | En-tête de requête |
|---|---|
| En-tête de requête interdit | Oui (préfixe Sec-) |
Syntaxe
Sec-Browsing-Topics: <array-of-observed-topics>
Directives
Un objet JSON représentant un tableau de jusqu'à trois objets représentant les sujets sélectionnés par l'utilisateur·ice actuel·le pour les trois dernières époques. Chaque objet contient les propriétés suivantes :
configVersion-
Une chaîne de caractères identifiant l'algorithme (autre que la partie modèle) utilisé pour calculer le sujet.
modelVersion-
Une chaîne de caractères représentant le modèle utilisé pour classer une chaîne de caractères (comme le nom d'hôte d'une page web) en identifiants de sujets.
taxonomyVersion-
Une chaîne de caractères représentant la version de la taxonomie utilisée.
topic-
Un nombre représentant l'ID du sujet, qui peut être utilisé par le navigateur pour récupérer le sujet à partir de la taxonomie (voir un exemple de taxonomie des intérêts (angl.)).
version-
Les valeurs de
configVersion,modelVersionettaxonomyVersion, concaténées avec des deux-points (:) entre chaque.
Exemples
Les valeurs exactes des propriétés peuvent varier en fonction de l'implémentation du navigateur. Un exemple d'en-tête provenant de Chrome pourrait ressembler à ce qui suit :
Sec-Browsing-Topics: [{configVersion: "chrome.1", modelVersion: "1", taxonomyVersion: "1", topic: 43, version: "chrome.1:1:1"}]
Spécifications
Cette fonctionnalitée ne fait partir d'aucun standard officiel, bien qu'elle soit définie dans le brouillon de proposition non officiel de l'API Topics (angl.).