L'essai d'abandon de la réduction user-agent a permis aux sites de continuer à recevoir la chaîne user-agent complète après la réduction de la chaîne UA. L'essai a pris fin le 23 septembre 2023.
À partir de Chrome 101, les informations disponibles dans la chaîne user-agent (UA) seront réduites par étapes. Les sites qui n'ont pas eu le temps d'utiliser la chaîne user-agent réduite et de passer aux indicateurs client User-Agent peuvent participer à un essai d'abandon pour continuer à recevoir la chaîne user-agent complète.
L'inscription à l'évaluation avant arrêt débutera avec la version bêta de Chrome 100. Elle permettra aux sites de recevoir la chaîne user-agent complète avant le lancement de la version 101 de Chrome, où la chaîne de la version mineure sera réduite. Si vous souhaitez tester la phase d'évaluation sur la version bêta de Chrome 100 avant son lancement en version stable, inscrivez-vous et testez-la avant la date de sortie de Chrome 100 (actuellement prévue pour le 31 mars 2022).
Vous trouverez ci-dessous un aperçu de l'évaluation avant arrêt et de ce qui vous attend. Si vous avez des commentaires à nous transmettre ou si vous rencontrez des problèmes au cours de cet essai, n'hésitez pas à nous en faire part dans le dépôt GitHub sur la réduction d'UA.
Quel impact pour les développeurs Web ?
Si vous vous inscrivez à l'évaluation avant arrêt, les sites continueront de recevoir la chaîne UA complète dans navigator.userAgent
et les valeurs non réduites dans les getters JavaScript navigator.platform
et navigator.appVersion
associés:
- L'en-tête de requête HTTP
User-Agent
- Le getter JavaScript
navigator.userAgent
- Le getter JavaScript
navigator.platform
- Le getter JavaScript
navigator.appVersion
Les sites doivent toujours auditer leur utilisation de l'en-tête user-agent et des API associées et, si nécessaire, se préparer à la migration vers les indicateurs client User-Agent avant la fin de l'essai d'abandon. L'intent expire une fois le déploiement de la réduction user-agent terminé.
Comment participer à l'essai d'abandon de la réduction user-agent ?
S'inscrire à l'essai
Pour vous inscrire à la phase d'évaluation et obtenir un jeton pour vos domaines, accédez à la page concernant l'abandon de la fonctionnalité User-Agent Reduction. Si vous êtes un tiers, veuillez cocher la case "Mise en correspondance tierce".
Préparation
Une fois inscrit à l'essai, modifiez vos en-têtes de réponse HTTP comme suit:
- Ajoutez
Origin-Trial: <ORIGIN TRIAL TOKEN>
à votre en-tête de réponse HTTP. <ORIGIN TRIAL TOKEN
> contient le jeton que vous avez obtenu lors de votre inscription à la phase d'évaluation. - Ajoutez
Accept-CH: Sec-CH-UA-Full
à votre en-tête de réponse HTTP. Si vous définissezAccept-CH
, seule la chaîne user-agent complète sera envoyée lors des requêtes ultérieures adressées à l'origine. - Si la chaîne user-agent complète est essentielle à la première requête, ajoutez
Critical-CH: Sec-CH-UA-Full
à votre en-tête de réponse HTTP, en plus des en-têtesAccept-CH
etOrigin-Trial
. Pour les participants qui participent à l'essai d'abandon via la réduction, nous suggérons d'autoriser tous les domaines tiers à accéder à la chaîne user-agent complète. Si des domaines tiers n'ont pas accès à la chaîne user-agent complète, leur accès complet à cette chaîne sera bloqué, quelle que soit leur propre inscription à la période d'évaluation avant abandon. Vous pouvez autoriser l'accès complet de la chaîne user-agent aux domaines tiers de deux manières:
- Ajoutez un en-tête
Permissions-Policy
avec les domaines tiers qui doivent recevoir la chaîne user-agent complète.- Pour autoriser tous les domaines tiers, ajoutez
Permissions-Policy: ch-ua-full=*
. - Pour autoriser une liste nommée de domaines tiers, ajoutez
Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com")
.
- Pour autoriser tous les domaines tiers, ajoutez
- Ajoutez une balise Meta
Accept-CH
avec les domaines tiers qui doivent recevoir la chaîne user-agent complète (uniquement dans Chrome 100 et versions ultérieures).- Pour autoriser une liste nommée de domaines tiers, ajoutez
<meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">
. - Vous ne pouvez pas déléguer à tous les domaines tiers via
*
dans la balise Meta.
- Pour autoriser une liste nommée de domaines tiers, ajoutez
- Ajoutez un en-tête
Chargez votre site Web dans Chrome 100 (ou version ultérieure) et continuez à recevoir la chaîne user-agent complète.
Démonstration
Consultez https://uard-ot-demo.glitch.me pour une démonstration du test (avec le code source).
Comment vérifier que l'essai fonctionne ?
Pour vérifier que la phase d'évaluation fonctionne, examinez les en-têtes de requête et vérifiez les points suivants:
- L'en-tête user-agent contient la version complète. Il ne doit pas contenir les valeurs réduites (disponibles dans la liste des exemples de chaînes user-agent réduites). Pour savoir facilement que la chaîne de la version mineure de Chrome ne doit pas être
0.0.0
, - L'en-tête
Sec-CH-UA-Full
est défini sur?1
.
Les en-têtes de la réponse initiale contenant le jeton "origin-trial" doivent se présenter comme suit:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/blog/AIlPxFBDvO7jQrXuKfWU.png?authuser=6&hl=fr)
Les en-têtes de requêtes suivants contenant la chaîne user-agent complète doivent se présenter comme suit:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/blog/Hzi5O1mZQyZEKeokCQSe.png?authuser=6&hl=fr)
Comment puis-je arrêter de participer à l'essai d'abandon de la réduction user-agent ?
Au cours de la période d'essai, vous pouvez à tout moment arrêter de participer et recevoir la chaîne user-agent réduite. Pour ne plus participer:
- Envoyez dans votre réponse HTTP un en-tête
Accept-CH
qui n'inclut pasSec-CH-UA-Full
. Notez queAccept-CH
avec une valeur vide constitue un moyen valide d'effectuer cette opération si votre site ne demande aucun autre Client Hint. - Supprimez l'en-tête
Origin-Trial
de l'essai d'abandon de la réduction user-agent de votre réponse HTTP. - Si ce champ est défini, supprimez
Sec-CH-UA-Full
de l'en-têteCritical-CH
dans votre réponse HTTP.
En quoi ce test est-il différent des autres phases d'évaluation User-Agent ?
Chrome exécute deux phases d'évaluation liées à la réduction user-agent. La première était la phase d'évaluation de la fonctionnalité User-Agent Reduction, qui permettait aux sites de recevoir la chaîne user-agent réduite pour tester leurs cas d'utilisation et envoyer des commentaires avant qu'elle ne devienne le comportement par défaut dans Chrome.
Le deuxième, mentionné ici, est un essai d'abandon destiné aux sites qui ont besoin d'un peu plus de temps pour migrer vers l'API User-Agent Client Hints. Elle permet aux sites de continuer à recevoir la chaîne user-agent complète.
Combien de temps durera l'évaluation avant arrêt ?
L'essai d'abandon de la réduction user-agent se déroulera de Chrome 100 à Chrome 115. Chrome 116 sera la première version dans laquelle seule la chaîne user-agent entièrement réduite sera envoyée.
Comment envoyer des commentaires sur l'essai d'amortissement de réduction user-agent ?
Si vous rencontrez des problèmes ou envoyez des commentaires, accédez au dépôt GitHub "User-Agent Reduction".