La Privacy Sandbox inclut une sélection de propositions permettant d'utiliser la publicité sans avoir besoin du suivi intersites. Les versions d'essai Origin permettent aux développeurs d'évaluer de nouvelles technologies Web et de donner leur avis à leur sujet grâce à des tests concrets. La phase d'évaluation de l'origine Privacy Sandbox Relevance and Measurement permet aux sites d'exécuter des tests unifiés sur Attribution Reporting, l'API Protected Audience, Topics, Fenced Frames et Shared Storage. Les développeurs peuvent s'inscrire à cette phase d'évaluation unique qui vous permet de tester les API Topics, Protected Audience et Attribution Reporting. Ce guide vous explique comment configurer l'accès aux API, comment valider votre configuration et vous fournit des ressources supplémentaires pour effectuer des tests avec les API.
Vérifier l'état de l'évaluation d'origine
Juin 2023
Déploiement de Private Aggregation à 7 % dans la version stable
L'API Private Aggregation sera disponible pour 7 % du trafic Chrome Stable à partir du mardi 6 juin 2023. L'API sera disponible dans le groupe principal unifié de la phase d'évaluation (5 %), dans le groupe isolé Protected Audience (1 %) et dans le groupe isolé Shared Storage (1 %). L'allocation du trafic pour Protected Audience et Shared Storage ne changera pas, car Private Aggregation est ajoutée aux tests isolés existants.
Répartition du trafic à partir du mardi 6 juin :
| API | Répartition du trafic | État |
| Rapports sur l'attribution | Unifié : 5 % | 6 % du trafic stable au 13 mars 2023 |
| Isolé – 1 % – ARA uniquement | ||
| Frames cloisonnés | Unifié : 5 % | 7 % du trafic stable au 13 mars 2023 |
| Isolé : 1 % (Shared Storage + Private Aggregation + Fenced Frames uniquement) | ||
| Isolé : 1 % – Protected Audience + Private Aggregation + Fenced Frames uniquement | ||
| Protected Audience | Unifié : 5 % | 6 % du trafic stable au 13 mars 2023 |
| Isolé : 1 % – Protected Audience + Private Aggregation + Fenced Frames uniquement | ||
| Private Aggregation | Unifié : 5 % | 7 % du trafic stable au 6 juin 2023 |
| Isolé : 1 % – Protected Audience + Private Aggregation + Fenced Frames uniquement | ||
| Isolé : 1 % (Shared Storage + Private Aggregation + Fenced Frames uniquement) | ||
| Stockage partagé | Unifié : 5 % | 6 % du trafic stable au 13 mars 2023 |
| Isolé : 1 % (Shared Storage + Private Aggregation + Fenced Frames uniquement) | ||
| Thèmes | Unifié : 5 % | 6 % du trafic stable au 13 mars 2023 |
| Isolé – 1 % – Sujets uniquement |
Actualités précédentes
Consultez les précédentes mises à jour de l'étude d'origine.
Avril 2023
Déploiement de Private Aggregation à 1 % dans la version stable
La phase d'évaluation de l'origine de l'API Private Aggregation sera disponible pour 1 % du trafic de test unifié de Chrome Stable à partir du lundi 17 avril. La fonction sendHistogramReport() de Private Aggregation peut être utilisée dans les worklets Protected Audience API et Shared Storage.
À partir du lundi 17 avril, la répartition du trafic sera la suivante :
| API | Répartition du trafic | État |
| Rapports sur l'attribution | Unifié : 5 % | 6 % du trafic stable à partir du 13 mars 2023 |
| Isolé – 1 % – ARA uniquement | ||
| Frames cloisonnés | Unifié : 5 % | 7 % du trafic stable à partir du 13 mars 2023 |
| Isolé – 1 % – Stockage partagé (sélection d'URL) + Frames isolés uniquement | ||
| Isolé : 1 % (API Protected Audience et cadres clôturés uniquement) | ||
| API Protected Audience | Unifié : 5 % | 6 % du trafic stable à partir du 13 mars 2023 |
| Isolé : 1 % (API Protected Audience et cadres clôturés uniquement) | ||
| Private Aggregation | Unifié : 1 % | 1 % du trafic stable à partir du 17 avril 2023 |
| Shared Storage (sélection d'URL) | Unifié : 5 % | 6 % du trafic stable à partir du 13 mars 2023 |
| Isolé – 1 % – Stockage partagé (sélection d'URL) + Frames isolés uniquement | ||
| Thèmes | Unifié : 5 % | 6 % du trafic stable à partir du 13 mars 2023 |
| Isolé – 1 % – Sujets uniquement |
Mars 2023
Mise à jour de la chronologie
Nous avions initialement annoncé que nous commencerions les tests isolés le lundi 13 mars 2023, mais ils débuteront désormais le jeudi 16 mars 2023, car nous avons besoin de plus de temps pour les configurer. La reprise de l'augmentation de l'API Protected Audience de 1 % (de 4 % à 5 %) aura également lieu le jeudi 16 mars 2023.
Reprise progressive de l'API Protected Audience à 1 %
Le mois dernier, nous avons temporairement réduit le trafic de la phase d'évaluation de l'API Protected Audience de 5 % à 4 % de la version stable de Chrome pour les tests. Les premiers tests sont terminés. Nous prévoyons de faire passer l'API Protected Audience de 4 % à 5 % pour le test unifié le jeudi 16 mars 2023.
Les utilisateurs réactivés seront les mêmes que ceux qui avaient été désactivés. Toutefois, leurs anciens groupes d'intérêt ont expiré, car plus de 30 jours se sont écoulés depuis la réduction progressive.
Tests isolés
Pour améliorer notre processus de test et continuer à observer les métriques des API d'Origin Trials, nous créons des expériences isolées pour chaque API, en plus de l'expérience unifiée existante. De nouveaux tests seront créés pour Attribution Reporting, Topics, une combinaison de l'API Protected Audience et de Fenced Frames, ainsi qu'une combinaison de l'opération de sélection d'URL de Shared Storage et de Fenced Frames. Dans chaque test isolé, seules les API attribuées seront disponibles pour les utilisateurs de ce groupe.
| API | Répartition du trafic pour un test isolé |
|---|---|
| Rapports sur l'attribution | 1 % |
| API Protected Audience + cadres clôturés | 1 % |
| Shared Storage (sélection d'URL) + Fenced Frames | 1 % |
| Thèmes | 1 % |
À partir du jeudi 16 mars, vous commencerez à recevoir 1 % de trafic Chrome Stable supplémentaire pour les API listées ci-dessus, en plus des 5 % de trafic que vous recevez déjà de l'expérience unifiée existante. Les nouveaux utilisateurs seront répartis dans chaque test.
Répartition du trafic
Voici la répartition actuelle du trafic des versions d'évaluation unifiées des origines au mardi 28 février :
| API | Répartition du trafic du test unifié en cours : |
|---|---|
| Rapports sur l'attribution | 5 % |
| Frames cloisonnés | 5 % |
| API Protected Audience | 4 % |
| Shared Storage (sélection d'URL) | 5 % |
| Thèmes | 5 % |
Voici à quoi ressemblera la répartition du trafic à partir du jeudi 16 mars, une fois l'API Protected Audience réactivée et les nouveaux tests isolés lancés :
| API | Nouvelle répartition du trafic | État |
|---|---|---|
| Rapports sur l'attribution | Unifié : 5 % | 6 % du trafic stable à partir du 16 mars 2023 |
| Isolé – 1 % – ARA uniquement | ||
| Frames cloisonnés | Unifié : 5 % | 7 % du trafic stable à partir du 16 mars 2023 |
| Isolé – 1 % – Stockage partagé (sélection d'URL) + Frames isolés uniquement | ||
| Isolé : 1 % (API Protected Audience et cadres clôturés uniquement) | ||
| API Protected Audience | Unifié : 5 % (4 % d'allocation actuelle + 1 % de retour à la normale) | 6 % du trafic stable à partir du 16 mars 2023 |
| Isolé : 1 % (API Protected Audience et cadres clôturés uniquement) | ||
| Shared Storage (sélection d'URL) |
Unifié : 5 % | 6 % du trafic stable à partir du 16 mars 2023 |
| Isolé – 1 % – Stockage partagé (sélection d'URL) + Frames isolés uniquement | ||
| Thèmes | Unifié : 5 % | 6 % du trafic stable à partir du 16 mars 2023 |
| Isolé – 1 % – Sujets uniquement |
Ces modifications n'auront aucune incidence sur la configuration de votre jeton d'évaluation de l'origine existant. Vous n'aurez pas à renouveler ni à générer de nouveau jeton d'évaluation de l'origine.
Janvier 2023
Dans le cadre d'une étude sur la régression de Chrome, nous allons réduire temporairement le trafic de la phase d'évaluation de l'API Protected Audience de 5 % à 4 % de Chrome stable, à partir du 26 janvier 2023. Nous estimons que l'enquête prendra environ un mois. Nous vous préviendrons lorsque le trafic sera rétabli.
Ce changement s'effectuera automatiquement et n'aura aucune incidence sur vos jetons d'essai d'origine existants. Pour les utilisateurs du trafic de 1 % qui sera réduit, les groupes d'intérêt resteront dans leur navigateur. Les mêmes utilisateurs feront partie de la reprise, et leurs groupes d'intérêt pourront être réutilisés. Toutefois, les groupes d'intérêt expirent au bout de 30 jours, et l'étude de régression peut prendre plus de temps.
De plus, la phase d'évaluation de l'API URL Selection de Shared Storage passera à 5 % du trafic Chrome stable à partir du 26 janvier 2023.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, augmenté à 5 % depuis le 26 octobre 2022. |
| Thèmes | Disponible dans la version stable, augmenté à 5 % depuis le 26 octobre 2022. |
| API Protected Audience | Disponible dans la version stable, temporairement réduit à 4 % à partir du 26 janvier 2023. |
| Frames cloisonnés | Disponible dans la version stable, avec une augmentation à 5 % à partir du 9 novembre 2022. |
| Shared Storage | Disponible dans la version stable, augmentation de 5 % à partir du 26 janvier 2023. |
Novembre 2022
L'API `selectURL` de Shared Storage rejoindra la phase d'évaluation le 9 novembre, pour 1 % du trafic Chrome stable.
Comme annoncé précédemment dans l'article de blog Augmentation à 5 % de la phase d'évaluation de l'origine de la pertinence et de la mesure de la Privacy Sandbox, Attribution Reporting et Topics sont désormais à 5 %. L'API Protected Audience et les cadres isolés suivront également le 9 novembre.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, augmenté à 5 % à partir du 26 octobre. |
| Thèmes | Disponible dans la version stable, augmenté à 5 % à partir du 26 octobre. |
| API Protected Audience | Disponible dans la version stable, avec une augmentation à 5 % à partir du 9 novembre. |
| Frames cloisonnés | Disponible dans la version stable, avec une augmentation à 5 % à partir du 9 novembre. |
| Shared Storage | Disponible dans la version stable à partir du 9 novembre (1 %). |
Octobre 2022 : augmentation de 5 %
Attribution Reporting, Topics, l'API Protected Audience et Fenced Frames sont actuellement disponibles dans la version stable de Chrome et feront partie du trafic accru.
Nous commencerons à augmenter le trafic pour Attribution Reporting et Topics à partir de cette semaine. Pour l'API Protected Audience et Fenced Frames, l'augmentation commencera le 9 novembre.
Pour en savoir plus, consultez l'article de blog Augmentation à 5 % de l'étude pilote sur la pertinence et la mesure de la Privacy Sandbox.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, puis à 5 % après le 26 octobre. |
| Thèmes | Disponible dans la version stable, puis à 5 % après le 26 octobre. |
| API Protected Audience | Disponible dans la version stable, avec une augmentation à 5 % à partir du 9 novembre. |
| Frames cloisonnés | Disponible dans la version stable, avec une augmentation à 5 % à partir du 9 novembre. |
| Shared Storage | Pour le moment, cette fonctionnalité n'est disponible que dans les versions Canary, en développement et bêta M105+. |
Octobre 2022
- La phase d'évaluation a été étendue à Chrome 110.
- L'article Premiers pas avec les phases d'évaluation de Chrome explique comment renouveler l'inscription à une phase d'évaluation. Cela inclut la fourniture d'un nouveau jeton aux origines participantes, ce qui correspond au même processus que pour toute autre extension d'essai d'origine.
Cette prolongation a été accordée pour donner à l'écosystème le temps de continuer à tester et valider les améliorations de l'API dans le canal stable, tout en fournissant des commentaires cohérents avec notre calendrier public existant.
La chronologie globale de la Privacy Sandbox reste inchangée.
API incluses dans l'essai :
| API | Remarques |
|---|---|
| Attribution Reporting | Guide du développeur pour l'évaluation de l'origine |
| API Protected Audience | Guide du développeur pour l'évaluation de l'origine |
| Thèmes | Guide du développeur pour l'évaluation de l'origine |
| Frames cloisonnés | Consultez les consignes concernant l'utilisation de l'API Protected Audience pour la phase d'évaluation. |
| Shared Storage | Pour le moment, cette fonctionnalité n'est disponible que dans les versions Canary, en développement et bêta M105+. |
Août 2022
- La phase d'évaluation est disponible pour 1 % des utilisateurs d'ordinateurs de la version stable 104 de Chrome.
- Nous vous tiendrons informé lorsque la fonctionnalité sera disponible pour les utilisateurs mobiles.
- Les versions pré-stables (Canary et bêta) restent à 50 % des utilisateurs.
- Les API ne sont pas disponibles sur Chrome pour iOS.
Mai 2022
La phase d'évaluation est disponible pour 50 % des utilisateurs de la version bêta de Chrome 102.
API incluses dans l'essai :
| API | Remarques |
|---|---|
| Attribution Reporting | Guide du développeur pour l'évaluation de l'origine |
| API Protected Audience | Guide du développeur pour l'évaluation de l'origine |
| Thèmes | Guide du développeur pour l'évaluation d'origine Les thèmes ont été brièvement désactivés dans l'évaluation de l'origine en raison d'un bug qui affectait la stabilité du navigateur. |
| Frames cloisonnés | Ajout de cadres cloisonnés à l'essai d'origine. Consultez les consignes concernant l'API Protected Audience pour savoir comment utiliser les tests. |
Avril 2022
La phase d'évaluation commence avec une proportion limitée d'utilisateurs de la version bêta de Chrome 102.
API incluses dans l'essai :
| API | Remarques |
|---|---|
| Attribution Reporting | Post Intent to Experiment (I2E) (Intention de tester) individuel. L'API Attribution Reporting est également disponible en tant que phase d'évaluation individuelle. |
| API Protected Audience | Post Intent to Experiment (I2E) (Intention de tester) individuel. L'API Protected Audience n'est disponible que sur ordinateur et avec un sous-ensemble de fonctionnalités. |
| Thèmes | Post Intent to Experiment (I2E) (Intention de tester) individuel. |
S'inscrire à la phase d'évaluation et la configurer
Pour activer la version d'évaluation de l'origine sur votre site, vous devez vous inscrire et intégrer le jeton de version d'évaluation de l'origine qui vous a été attribué (une chaîne temporelle pour votre accès spécifique à la version d'évaluation de l'origine). Pour en savoir plus, consultez Premiers pas avec les phases d'évaluation d'origine de Chrome.
Les jetons d'essai d'origine sont accordés immédiatement. Vous pouvez les révoquer ou les recréer à tout moment.
Pour chaque page sur laquelle vous souhaitez utiliser l'évaluation d'origine, vous devrez inclure un jeton d'évaluation dans le code HTML ou la réponse de cette page spécifique.
Utilisez une balise <meta> dans la section <head> de la page :
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Vous pouvez également inclure l'en-tête HTTP suivant dans la réponse de la page :
Origin-Trial: TOKEN_GOES_HERE
Configurer avec un iFrame
Si vous utilisez des fonctionnalités en phase d'évaluation de l'origine dans un iFrame (comme joinAdInterestGroup() de l'API Protected Audience), le jeton doit être fourni dans l'iFrame et correspondre à l'origine de l'iFrame.
Configurer le suivi multisite avec JavaScript
Si vous utilisez des fonctionnalités d'origin trial via JavaScript multisite, c'est-à-dire si vous êtes le fournisseur de code JavaScript tiers inclus dans la page de premier niveau, vous devez :
- Sélectionnez l'option Correspondance tierce lorsque vous vous inscrivez à l'origin trial.
- Le champ "Origine Web" doit correspondre à l'origine de votre script.
- Injectez la balise
<meta>dans la page de premier niveau (c'est-à-dire la page propriétaire, et non votre propre contenu) à partir de votre script. Exemple :
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Déboguer l'origin trial
Vous pouvez vérifier l'état d'un test d'origine dans le panneau Outils de développement > Application.
- Faites défiler la page jusqu'au volet Cadres.
- Sélectionnez le frame dans lequel vous prévoyez de définir le jeton. Par exemple, le frame top pour la page de premier niveau ou l'iframe spécifique pour les pages intégrées.
- Dans le volet de droite, faites défiler la page jusqu'à la section Version d'évaluation de l'origine.
- Une entrée pour l'essai
PrivacySandboxAdsAPIsdoit s'afficher. - Développez cette entrée pour afficher l'état de la version d'évaluation et de vos jetons spécifiques.
L'étude d'origine est limitée à une fraction des utilisateurs de Chrome. Il est possible que votre navigateur ne fasse pas partie du groupe de test. Par conséquent, un message rouge TrialNotAllowed peut s'afficher à côté de PrivacySandboxAdsAPIs. Lorsque vous développez l'entrée pour vérifier l'état du jeton, si le message Success vert s'affiche, cela signifie que la configuration de votre version d'essai de l'origine est correcte. Les utilisateurs éligibles verront le message défini sur Enabled.
Si vous voyez d'autres messages, consultez Dépannage des versions d'essai des origines de Chrome pour obtenir une checklist détaillée permettant de valider la configuration de la version d'essai des origines.
Détecter des caractéristiques
Comme pour toutes les fonctionnalités Web, vous devez vérifier qu'elles sont signalées comme disponibles dans le navigateur avant de tenter de les utiliser. Pour ce faire, vérifiez l'existence de l'API concernée au bon emplacement :
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Déterminer l'éligibilité des utilisateurs
La phase d'évaluation est en cours pour une partie des utilisateurs de Chrome. Pour pouvoir bénéficier de l'essai, ils doivent également avoir activé la fonctionnalité correspondante dans leurs paramètres :
Paramètres du navigateur
Pour qu'un utilisateur puisse bénéficier de l'essai, il doit :
utiliser une version et un canal de Chrome sur lesquels la phase d'évaluation de l'origine est en cours.
- Pour connaître les configurations actuelles, consultez État des versions d'essai d'origine.
Faire partie du groupe de test actif dans Chrome.
Paramètres utilisateur
Pour qu'un utilisateur puisse bénéficier de l'essai, il doit également :
- avoir activé l'essai de Privacy Sandbox via Paramètres > Sécurité et confidentialité > Privacy Sandbox, également accessible via
chrome://settings/adPrivacy. - activer les cookies tiers dans Paramètres > Sécurité et confidentialité > Cookies et autres données de site, en sélectionnant "Autoriser tous les cookies" ou "Bloquer les cookies tiers en mode navigation privée". Vous pouvez également y accéder via
chrome://settings/cookies. - être dans une session de navigation standard et non en mode navigation privée.
Bien que l'origin trial ne s'affiche comme active que pour les utilisateurs éligibles, vous pouvez également utiliser les indicateurs pour les développeurs pour effectuer des tests sur votre propre site de production.
Contrôler votre participation à la phase d'évaluation
Le fonctionnement du test d'origine reste le même : vous obtenez des jetons de test d'origine pour les contextes dans lesquels vous souhaitez tester les API. Avec l'augmentation de la population de testeurs, vous devez vous assurer de surveiller et de contrôler activement le niveau de trafic pour lequel vous choisissez d'activer l'essai.
Voici une bonne approche :
- Incluez les jetons d'évaluation de l'origine par défaut dans tous les contextes où vous souhaitez effectuer des tests.
- Utilisez la détection de fonctionnalités pour vérifier les API actives.
- Si les API sont actives (et que le navigateur est donc éligible à ce test), choisissez de les utiliser ou non en fonction de vos propres critères de test. Par exemple, si vous disposez déjà d'une infrastructure de tests A/B pour tester un pourcentage de trafic, un échantillonnage ou un autre attribut, vous pouvez décider à ce stade quelles fonctionnalités vous allez utiliser activement.
Vous pouvez empêcher la participation à l'origin trial pour n'importe quelle instance de navigateur en n'incluant pas le jeton dans la réponse. Par exemple, si vous avez atteint votre propre quota pour un test ou si vous devez résoudre un problème pendant l'essai, le fait de ne pas inclure le jeton garantit qu'aucune fonctionnalité expérimentale ne sera disponible ni active sur la page.
Contrôle des versions d'essai par région géographique
Vous ne pouvez pas désactiver un essai d'origine pour des régions spécifiques. Les versions d'essai d'origine sont actives sur les pages qui contiennent le jeton, inclus via des en-têtes HTTP (côté serveur) ou des balises Meta HTML (côté client).
Si vous pouvez déterminer la position de l'utilisateur, vous pouvez écrire du code pour inclure le jeton d'évaluation de l'origine en fonction de ces informations de localisation. Par exemple, vous pouvez essayer d'utiliser les adresses IP pour déterminer la position d'un utilisateur. Les adresses IP peuvent être usurpées. Cette solution n'est donc pas garantie.
Toutefois, une origine géographique spécifique peut définir une Règle d'autorisation pour contrôler les fonctionnalités utilisables. Par exemple, us.example.com et uk.example.com sont des origines géographiques spécifiques qui peuvent être contrôlées. Cela ne signifie pas qu'une région a désactivé la phase d'évaluation.
Avec une stratégie d'autorisation, un site ajoute un petit extrait de code à ses pages, qui fournit des instructions au navigateur. Lorsque la page se charge, le navigateur lit les instructions de la règle d'autorisation et autorise ou bloque les fonctionnalités (ou les API) comme indiqué dans la règle d'autorisation. Si un site souhaite limiter une API dans une région spécifique, le développeur peut définir une règle pour toutes les pages demandées à partir de cette région.
Renouveler votre jeton
Les jetons d'essai d'origine expirent six semaines après leur date d'émission (ou à la fin de l'essai si cette date est antérieure).
Il est essentiel que vous renouveliez et déployiez vos nouveaux jetons pendant cette période pour pouvoir continuer à utiliser les fonctionnalités de la version d'évaluation de l'origine sans interruption.
Le renouvellement des jetons ne prend que quelques minutes. Vous pouvez déployer plusieurs jetons pour le même essai sur la même page. Vous pouvez déployer un jeton renouvelé avant l'expiration de votre jeton existant, afin que les utilisateurs ne subissent aucune interruption de service.
Tester en local
Pour obtenir des conseils spécifiques sur les tests effectués par les développeurs en local, consultez les articles suivants :
Les API ne sont pas activées par défaut et doivent être activées avec des indicateurs pour les tests. Assurez-vous d'avoir activé les mêmes paramètres de configuration que ceux ci-dessus, puis :
- Utilisez une version et un canal de Chrome où les fonctionnalités sont disponibles.
- Activez toutes les API de confidentialité des annonces sous
chrome://settings/adPrivacy.
Consultez les guides du développeur pour connaître la disponibilité d'API et de fonctionnalités spécifiques, ainsi que les indicateurs supplémentaires pour une configuration plus précise.