Topics, Fenced Frames et Shared Storage. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
La Privacy Sandbox inclut une sélection de propositions permettant d'utiliser la publicité sans avoir besoin de suivre les utilisateurs d'un site à un autre. Les tests Origin permettent aux développeurs d'évaluer et de donner leur avis sur les nouvelles technologies Web via des tests réels. La phase d'évaluation de la pertinence et de la mesure de la Privacy Sandbox fournit une seule phase d'évaluation permettant 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 pour une origine qui leur permet de tester les API Topics, Protected Audience et Attribution Reporting. Ce guide vous explique les étapes de configuration pour accéder aux API, vous indique comment valider votre configuration et fournit d'autres ressources pour les tests avec les API.
Vérifier l'état du test d'origine
Juin 2023
Accélération de Private Aggregation de 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 de la phase d'évaluation de l'origine unifiée (5%), le groupe isolé Protected Audience (1%) et le groupe isolé Shared Storage (1%). L'allocation du trafic pour Protected Audience et Shared Storage ne changera pas, car Private Aggregation est ajouté aux tests isolés existants.
Répartition du trafic au 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 | ||
| Cadres cloisonnés | Unifié : 5% | 7% du trafic stable au 13 mars 2023 |
| Isolé : 1% - Stockage partagé + Private Aggregation + Cadres clôturés 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% - Stockage partagé + Private Aggregation + Cadres clôturés uniquement | ||
| Stockage partagé | Unifié : 5% | 6% du trafic stable au 13 mars 2023 |
| Isolé : 1% - Stockage partagé + Private Aggregation + Cadres clôturés uniquement | ||
| Thèmes | Unifié : 5% | 6% du trafic stable au 13 mars 2023 |
| Isolé : 1% - Thèmes uniquement |
Actualités précédentes
Consultez les précédentes informations sur le test de l'origine.
Avril 2023
Déploiement de Private Aggregation à 1% dans la version stable
La phase d'évaluation de l'API Private Aggregation sera disponible pour 1% du trafic de test unifié Chrome Stable à partir du lundi 17 avril. La fonction sendHistogramReport() de Private Aggregation peut être utilisée dans les worklets de l'API Protected Audience et de Shared Storage.
L'allocation du trafic sera la suivante à partir du lundi 17 avril:
| 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 | ||
| Cadres cloisonnés | Unifié : 5% | 7% du trafic stable à partir du 13 mars 2023 |
| Isolé : 1% - Stockage partagé (sélection d'URL) + Cadres clôturés uniquement | ||
| Isolé - 1% - API Protected Audience + cadres protégés uniquement | ||
| API Protected Audience | Unifié : 5% | 6% du trafic stable à partir du 13 mars 2023 |
| Isolé - 1% - API Protected Audience + cadres protégés uniquement | ||
| Private Aggregation | Unifié : 1% | 1% du trafic stable à partir du 17 avril 2023 |
| Stockage partagé (sélection d'URL) | Unifié : 5% | 6% du trafic stable à partir du 13 mars 2023 |
| Isolé : 1% - Stockage partagé (sélection d'URL) + Cadres clôturés uniquement | ||
| Thèmes | Unifié : 5% | 6% du trafic stable à partir du 13 mars 2023 |
| Isolé : 1% - Thèmes uniquement |
Mars 2023
Mise à jour de Vos trajets
Nous avions initialement annoncé que nous commencerions les tests isolés le lundi 13 mars 2023, mais les nouveaux tests commenceront désormais le jeudi 16 mars 2023, car nous avons besoin de plus de temps pour les configurer. Le passage de 4 % à 5 % de l'API Protected Audience aura également lieu le jeudi 16 mars 2023.
Remise en service 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 tests initiaux sont terminés. Nous prévoyons de réaugmenter l'API Protected Audience de 4% à 5% pour l'expérimentation unifiée le jeudi 16 mars 2023.
Les utilisateurs concernés par l'augmentation seront les mêmes que ceux qui ont été concernés par la réduction. Toutefois, ses anciens groupes de centres d'intérêt ont expiré, car plus de 30 jours se sont écoulés depuis la réduction.
Expériences isolées
Pour améliorer notre processus de test et continuer à observer les métriques des API de test d'origine, nous créons des tests isolés pour chaque API, en plus du test unifié existant. De nouvelles expériences seront créées pour Attribution Reporting, Topics, une combinaison de l'API Protected Audience et de Fenced Frames, et 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 du test isolé |
|---|---|
| Rapports sur l'attribution | 1 % |
| API Protected Audience + Fenced Frames | 1 % |
| Stockage partagé (sélection d'URL) + Cadres clôturés | 1 % |
| Thèmes | 1 % |
À partir du jeudi 16 mars, vous commencerez à recevoir 1% de plus du trafic Chrome stable pour les API listées ci-dessus, en plus des 5% de trafic que vous recevez de l'expérience unifiée existante. Les nouveaux utilisateurs seront attribués à chaque test.
Répartition du trafic
L'allocation actuelle du trafic des tests de l'origine unifiée au mardi 28 février est la suivante:
| API | Répartition du trafic de l'expérience unifiée actuelle |
|---|---|
| Rapports sur l'attribution | 5 % |
| Cadres cloisonnés | 5 % |
| API Protected Audience | 4 % |
| Stockage partagé (sélection de l'URL) | 5 % |
| Thèmes | 5 % |
L'allocation du trafic sera la suivante à partir du jeudi 16 mars, après la réactivation de l'API Protected Audience et le début des nouveaux tests isolé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 | ||
| Cadres cloisonnés | Unifié : 5% | 7% du trafic stable à partir du 16 mars 2023 |
| Isolé : 1% - Stockage partagé (sélection d'URL) + Cadres clôturés uniquement | ||
| Isolé - 1% - API Protected Audience + cadres protégés uniquement | ||
| API Protected Audience | Unifié : 5% (4% d'allocation actuelle + 1% de reprise) | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé - 1% - API Protected Audience + cadres protégés uniquement | ||
| Shared Storage (sélection de l'URL) |
Unifié : 5% | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé : 1% - Stockage partagé (sélection d'URL) + Cadres clôturés uniquement | ||
| Thèmes | Unifié : 5% | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé : 1% - Thèmes uniquement |
Ces modifications n'auront aucune incidence sur la configuration de votre jeton de test d'origine existant, et vous n'aurez pas besoin de le renouveler ni de générer un nouveau jeton de test d'origine.
Janvier 2023
Dans le cadre d'une étude de régression Chrome, nous allons temporairement réduire le trafic de la phase d'évaluation de l'API Protected Audience de 5% à 4% du trafic Chrome stable à partir du 26 janvier 2023. L'enquête devrait prendre 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 de test d'origine existants. Pour les utilisateurs du trafic de 1% qui sera réduit, les groupes de centres d'intérêt resteront dans leurs navigateurs. Les mêmes utilisateurs seront concernés par la reprise progressive, et leurs groupes de centres d'intérêt pourront être réutilisés. Toutefois, les groupes de centres d'intérêt expirent au bout de 30 jours, et l'analyse de régression peut prendre plus de temps.
De plus, la phase d'évaluation de l'API Selection d'URL de Shared Storage sera étendue à 5% du trafic Chrome stable à partir du 26 janvier 2023.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, augmenté à 5% à partir du 26 octobre 2022. |
| Thèmes | Disponible dans la version stable, augmenté à 5% à partir du 26 octobre 2022. |
| API Protected Audience | Disponible dans la version stable, avec une réduction temporaire à 4% à partir du 26 janvier 2023. |
| Cadres cloisonnés | Disponible dans la version stable, avec un taux de 5% à partir du 9 novembre 2022. |
| Stockage partagé | Disponible dans la version stable, avec une augmentation de 5% à partir du 26 janvier 2023. |
Novembre 2022
L'API "selectURL" de Shared Storage rejoindra la phase d'évaluation de l'origine sur 1% du trafic Chrome stable à partir du 9 novembre.
Comme annoncé précédemment dans l'article de blog Augmenter la phase d'évaluation de la Privacy Sandbox pour la pertinence et la mesure à 5%, Attribution Reporting et Topics sont désormais disponibles à 5 %, et l'API Protected Audience et les cadres limités le seront également le 9 novembre.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, augmenté à 5% depuis le 26 octobre. |
| Thèmes | Disponible dans la version stable, augmenté à 5% depuis le 26 octobre. |
| API Protected Audience | Disponible dans la version stable, et passera à 5% à partir du 9 novembre. |
| Cadres cloisonnés | Disponible dans la version stable, et passera à 5% à partir du 9 novembre. |
| Stockage partagé | 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 Chrome stable et feront partie de l'augmentation du trafic.
Nous commencerons à augmenter le trafic pour Attribution Reporting et Topics à partir de cette semaine, et pour l'API Protected Audience et Fenced Frames à partir du 9 novembre.
Pour en savoir plus, consultez l'article de blog Augmenter l'essai de la Privacy Sandbox pour la pertinence et la mesure à 5%.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible dans la version stable, avec un taux de 5% à partir du 26 octobre. |
| Thèmes | Disponible dans la version stable, avec un taux de 5% à partir du 26 octobre. |
| API Protected Audience | Disponible dans la version stable, et passera à 5% à partir du 9 novembre. |
| Cadres cloisonnés | Disponible dans la version stable, et passera à 5% à partir du 9 novembre. |
| Stockage partagé | Pour le moment, cette fonctionnalité n'est disponible que dans les versions Canary, en développement et bêta de M105 et versions ultérieures. |
Octobre 2022
- La phase d'évaluation Origin Trial a été étendue à Chrome 110.
- Premiers pas avec les phases d'évaluation d'origine de Chrome explique comment renouveler l'inscription à une phase d'évaluation d'origine. Cela inclut la fourniture d'un nouveau jeton aux origines participantes, ce qui est le même processus suivi pour toute autre extension d'essai d'origine.
Cette extension a été accordée pour laisser le temps à l'écosystème du canal stable de poursuivre les tests et la validation des améliorations apportées aux API, tout en fournissant des commentaires conformes à 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 le test de l'origine |
| API Protected Audience | Guide du développeur pour le test de l'origine |
| Thèmes | Guide du développeur pour le test de l'origine |
| Cadres cloisonnés | Consultez les conseils sur l'utilisation de la phase d'évaluation de l'API Protected Audience. |
| Stockage partagé | Pour le moment, cette fonctionnalité n'est disponible que dans les versions Canary, en développement et bêta de M105 et versions ultérieures. |
Août 2022
- La phase d'évaluation de l'origine est disponible pour 1% des utilisateurs de bureau à partir de Chrome 104 stable.
- Nous vous tiendrons informé lorsque la disponibilité inclura les utilisateurs mobiles.
- Les versions préstables (Canary, bêta) restent réservées à 50% des utilisateurs.
- Les API ne sont pas disponibles sur Chrome pour iOS.
Mai 2022
La phase d'évaluation de l'origine est disponible pour 50% des utilisateurs à partir de la version bêta de Chrome 102.
API incluses dans l'essai:
| API | Remarques |
|---|---|
| Attribution Reporting | Guide du développeur pour le test de l'origine |
| API Protected Audience | Guide du développeur pour le test de l'origine |
| Thèmes | Guide du développeur pour le test de l'origine Topics a été brièvement désactivé dans le test d'origine en raison d'un bug affectant la stabilité du navigateur. |
| Cadres cloisonnés | Cadres délimités ajoutés au test d'origine. Consultez les conseils sur l'API Protected Audience pour l'utilisation des tests. |
Avril 2022
La phase d'évaluation commence avec un nombre limité d'utilisateurs de la version bêta de Chrome 102.
API incluses dans l'essai:
| API | Remarques |
|---|---|
| Attribution Reporting | Post Intent to Experiment (I2E) individuel. Attribution Reporting est également disponible en tant qu'essai individuel pour les origines. |
| API Protected Audience | Post Intent to Experiment (I2E) individuel. L'API Protected Audience n'est disponible que sur ordinateur avec un sous-ensemble de fonctionnalités. |
| Thèmes | Post Intent to Experiment (I2E) individuel. |
S'inscrire et configurer l'essai de l'origine
Pour activer le test d'origine sur votre site, vous devez enregistrer et intégrer le jeton de test d'origine attribué (une chaîne basée sur le temps pour votre accès spécifique au test d'origine). Pour en savoir plus, consultez Premiers pas avec les essais 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 le test d'origine, vous devez inclure un jeton de test avec 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 de test 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 script intersites avec JavaScript
Si vous utilisez des fonctionnalités de test d'origine via du code JavaScript intersites, c'est-à-dire que vous êtes le fournisseur du code JavaScript tiers inclus dans la page de niveau supérieur, vous devez:
- Sélectionnez l'option Correspondance tierce lorsque vous vous inscrivez au test de l'origine.
- Le champ Origine Web doit correspondre à l'origine de votre script.
- Injectez la balise
<meta>dans la page de niveau supérieur (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'essai Origin Trial
Vous pouvez vérifier l'état d'un test d'origine dans le panneau DevTools > Applications.
- Faites défiler la page jusqu'au volet Cadres.
- Sélectionnez le frame dans lequel vous souhaitez définir le jeton. Par exemple, le cadre supérieur 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 Tests Origin.
- Une entrée pour l'essai
PrivacySandboxAdsAPIsdoit s'afficher. - Développez cette entrée pour afficher l'état du test d'origine et de vos jetons spécifiques.
L'essai de l'origine est limité à une partie des utilisateurs de Chrome, et il est possible que votre navigateur ne fasse pas partie du groupe de test. Par conséquent, un message TrialNotAllowed rouge peut s'afficher à côté de PrivacySandboxAdsAPIs. Lorsque vous développez l'entrée pour vérifier l'état du jeton, si un message Success vert s'affiche, la configuration de votre test d'origine est correcte. Le message Enabled s'affichera pour les utilisateurs éligibles.
Si vous voyez d'autres messages, consultez Dépannage des essais d'origine de Chrome pour obtenir une checklist détaillée permettant de valider votre configuration de l'essai d'origine.
Détecter des éléments géographiques
Comme pour toutes les fonctionnalités Web, vous devez vérifier qu'elles sont signalées comme disponibles dans le navigateur avant de les utiliser. Pour ce faire, vérifiez l'existence de l'API appropriée à l'emplacement approprié:
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 être éligible à l'essai, ils doivent également avoir activé la fonctionnalité appropriée dans leurs paramètres:
Paramètres du navigateur
Pour pouvoir bénéficier de l'essai, l'utilisateur 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 de l'essai de l'origine.
Vous devez faire partie du groupe de test actif dans Chrome.
Paramètres utilisateur
Pour être éligible à l'essai, l'utilisateur doit également:
- avoir activé l'essai de la Privacy Sandbox via Paramètres > Sécurité et confidentialité > Privacy Sandbox, également accessible via
chrome://settings/adPrivacy; - les cookies tiers sont activés via Paramètres > Sécurité et confidentialité > Cookies et autres données des sites, avec l'option "Autoriser tous les cookies" ou "Bloquer les cookies tiers en navigation privée", également accessible via
chrome://settings/cookies. - être dans une session de navigation standard et non en mode navigation privée ;
Bien que l'essai d'origine ne s'affiche comme actif que pour les utilisateurs éligibles, vous pouvez également utiliser les options de développement pour effectuer des tests sur votre propre site de production.
Contrôler votre participation à l'essai de l'origine
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 la population de test étendue, vous devez vous assurer de surveiller et de contrôler activement le niveau de trafic pour lequel vous choisissez d'activer le test.
Voici une bonne approche à suivre:
- Incluez les jetons de test d'origine par défaut dans tous les contextes dans lesquels vous souhaitez effectuer des tests.
- Utilisez la détection de fonctionnalités pour rechercher les API actives.
- Si les API sont actives (et donc que le navigateur est é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 test A/B pour tester un pourcentage de trafic, un échantillonnage ou un autre attribut, vous pouvez à ce stade choisir les fonctionnalités que vous utiliserez activement.
Vous pouvez empêcher complètement la participation à l'essai d'origine 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 le test, ne pas inclure le jeton garantit qu'aucune fonctionnalité expérimentale ne sera disponible ni active sur la page.
Contrôle des tests d'origine par région géographique
Vous ne pouvez pas désactiver un test d'origine pour des régions spécifiques. Les essais d'origine sont actifs 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 de test d'origine en fonction de ces informations de localisation. Par exemple, vous pouvez essayer d'utiliser des adresses IP pour déterminer la position d'un utilisateur. Les adresses IP peuvent être falsifiées. Il ne s'agit donc pas d'une solution garantie.
Toutefois, une origine géographique spécifique peut définir une règle d'autorisation pour contrôler les fonctionnalités disponibles. 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 de Topics.
Avec une politique d'autorisations, 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 stratégie d'autorisation et autorise ou bloque les fonctionnalités (ou API) comme indiqué dans la stratégie 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 Origin expirent six semaines à compter de la date d'émission (ou à la fin de l'essai si cela est plus tôt).
Vous devez impérativement renouveler et déployer vos nouveaux jetons pendant cette période pour utiliser les fonctionnalités de test de l'origine sans interruption.
Le renouvellement des jetons ne prend que quelques minutes, et vous pouvez déployer plusieurs jetons pour le même essai sur la même page. Vous pouvez déployer un jeton renouvelé avant que votre jeton existant n'expire, de sorte qu'il n'y ait pas d'interruption du service pour les utilisateurs.
Tester en local
Pour obtenir des conseils spécifiques sur les tests en local pour les développeurs, consultez les ressources suivantes:
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 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 d'options supplémentaires pour une configuration plus précise.