Topics, Fenced Frames et Shared Storage. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Débutant
La Privacy Sandbox inclut une sélection de propositions pour permettre l'utilisation publicitaire sans avoir besoin d'un suivi intersites. Origine d'évaluation permettent aux développeurs d'évaluer et donner leur avis sur les nouvelles technologies Web par le biais de tests réels. La Pertinence de la Privacy Sandbox et Phase d'évaluation des mesures permet aux sites d'exécuter des tests unifiés sur l'ensemble Attribution Reporting, API Protected Audience, Topics, Fenced Frames et Shared Cloud 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 vous guide à travers les étapes de configuration permettant d'accéder aux API, vous indique comment valider votre configuration et fournit d'autres ressources pour les tests à l'aide des API.
Vérifier l'état de la phase d'évaluation
Juin 2023
Montée en puissance de 7% de Private Aggregation dans la version stable
API Private Aggregation disponible dans 7% du trafic stable de Chrome à partir du mardi 6 juin 2023. L'API sera disponible dans le principal groupe d'évaluation unifié pour l'origine (5%), groupe isolé d'audience (1%) et groupe isolé de stockage partagé (1%). La la répartition 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 à 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 | ||
| Cadres cloisonnés | Unifié – 5% | 7% du trafic stable au 13 mars 2023 |
| Isolé – 1 % – Stockage partagé + Agrégation privée + Cadres cloisonnés uniquement | ||
| Isolé – 1 % – Protected Audience + Agrégation privée + Cadres cloisonnés uniquement | ||
| Protected Audience | Unifié – 5% | 6% du trafic stable au 13 mars 2023 |
| Isolé – 1 % – Protected Audience + Agrégation privée + Cadres cloisonnés uniquement | ||
| Agrégation privée | Unifié – 5% | 7% du trafic stable au 6 juin 2023 |
| Isolé – 1 % – Protected Audience + Agrégation privée + Cadres cloisonnés uniquement | ||
| Isolé – 1 % – Stockage partagé + Agrégation privée + Cadres cloisonnés uniquement | ||
| Stockage partagé | Unifié – 5% | 6% du trafic stable au 13 mars 2023 |
| Isolé – 1 % – Stockage partagé + Agrégation privée + Cadres cloisonné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 la phase d'évaluation.
Avril 2023
Montée en puissance de 1% de Private Aggregation dans la version stable
La page Privé
La phase d'évaluation de l'API Aggregation sera disponible dans 1% de la version stable de Chrome
le trafic de test unifié à partir du lundi 17 avril. sendHistogramReport()
de Private Aggregation peut être utilisée dans l'API Protected Audience
et stockage partagé
des Worklets.
À partir du lundi 17 avril, la répartition du trafic se présentera comme suit:
| 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 cloisonnés uniquement | ||
| Isolé - 1% - API Protected Audience + Cadres cloisonnés uniquement | ||
| API Protected Audience | Unifié – 5% | 6% du trafic stable à partir du 13 mars 2023 |
| Isolé - 1% - API Protected Audience + Cadres cloisonnés uniquement | ||
| Agrégation privée | 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 cloisonné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 allions commencer les tests isolés lundi, 13 mars 2023, mais les nouveaux tests commenceront le jeudi 16 mars 2023 en raison du temps supplémentaire nécessaire pour configurer les tests. Le 1% La montée en puissance de l'API Protected Audience de 4% à 5% aura également lieu le jeudi, 16 mars 2023.
1% de reprise d'activité de l'API Protected Audience
Le mois dernier, nous avons réduit temporairement le trafic de la phase d'évaluation de l'API Protected Audience de 5% à 4% de la version stable de Chrome à des fins de test. Les tests initiaux sont terminés, et nous prévoyons de ramener l'API Protected Audience à 5 % (contre 4 %) pour le test unifié le jeudi 16 mars 2023.
Les utilisateurs ayant atteint la montée en puissance seront les mêmes que ceux qui ont été accélérés. Cependant, ses groupes de centres d'intérêt précédents ont expiré, car plus de 30 jours se sont écoulés depuis la diminution de la capacité.
Tests isolés
Pour améliorer notre processus de test et continuer à observer les métriques des API d'évaluation de l'origine, nous créons des tests isolés pour chaque API, en plus du test unifié existant. De nouveaux tests seront créés pour Attribution Reporting, Topics, une combinaison de l'API Protected Audience et de cadres cloisonnés, ainsi que pour l'opération de sélection d'URL et les cadres cloisonnés de Shared Storage. Dans chaque test isolé, seules les API attribuées sont 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 cloisonnés | 1 % |
| Thèmes | 1 % |
À partir du jeudi 16 mars, vous commencerez à bénéficier d'un pourcentage supplémentaire de 1 % Trafic stable de Chrome pour les API listées ci-dessus, en plus des 5% de trafic que vous reçoivent de la part du test unifié existant. Les nouveaux utilisateurs seront affectés à chaque test.
Répartition du trafic
La répartition actuelle du trafic pour les tests d'origine unifiée au mardi 28 février est la suivante:
| API | Répartition du trafic du test unifié actuel |
|---|---|
| Rapports sur l'attribution | 5 % |
| Cadres cloisonnés | 5 % |
| API Protected Audience | 4 % |
| Stockage partagé (sélection d'URL) | 5 % |
| Thèmes | 5 % |
La répartition du trafic se présentera comme suit à partir du jeudi 16 mars, après la reprise 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 cloisonnés uniquement | ||
| Isolé - 1% - API Protected Audience + Cadres cloisonnés uniquement | ||
| API Protected Audience | Unifiée : 5% (4% de l'allocation actuelle + 1% d'augmentation progressive) | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé - 1% - API Protected Audience + Cadres cloisonnés uniquement | ||
| Stockage partagé (sélection d'URL) |
Unifié – 5% | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé - 1% - Stockage partagé (sélection d'URL) + Cadres cloisonnés uniquement | ||
| Thèmes | Unifié – 5% | 6% du trafic stable à partir du 16 mars 2023 |
| Isolé – 1 % – Thèmes uniquement |
Ces modifications n'affecteront pas la configuration existante de votre jeton d'évaluation d'origine, et vous n'aurez pas à le renouveler ni à en générer un nouveau.
Janvier 2023
Dans le cadre d'une enquête 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 la version stable de Chrome à partir du 26 janvier 2023. Nous estimons que l'enquête prendra environ un mois et nous vous informerons lorsque le trafic reprendra.
Ce changement sera automatique et n'aura aucune incidence sur vos jetons d'évaluation existants. Pour les utilisateurs inclus dans la tranche de 1% du trafic qui sera réduite, les groupes de centres d'intérêt resteront dans leur navigateur. Les mêmes utilisateurs participeront à la montée en puissance, 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'examen 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 stable de Chrome à partir du 26 janvier 2023.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible en version stable, avec une augmentation de 5% par rapport au 26 octobre 2022. |
| Thèmes | Disponible en version stable, avec une augmentation de 5% par rapport au 26 octobre 2022. |
| API Protected Audience | Disponible en version stable, passant temporairement à 4% à partir du 26 janvier 2023. |
| Cadres cloisonnés | Disponible en version stable, avec une augmentation de 5% à partir du 9 novembre 2022. |
| Stockage partagé | Disponible en version stable, avec une augmentation de 5% à partir du 26 janvier 2023. |
Novembre 2022
À partir du 9 novembre, l'API `selectURL` de Shared Storage participera à la phase d'évaluation pour 1% du trafic de la version stable de Chrome.
Comme annoncé précédemment dans l'article de blog Augmentation de la phase d'évaluation de la pertinence et des mesures de la Privacy Sandbox à 5%, Attribution Reporting et Topics sont désormais à 5% avec l'API Protected Audience et Fenced Frames après le 9 novembre.
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible en version stable, avec une augmentation de 5% à partir du 26 octobre. |
| Thèmes | Disponible en version stable, avec une augmentation de 5% à partir du 26 octobre. |
| API Protected Audience | Disponible en version stable, avec une augmentation de 5% à partir du 9 novembre. |
| Cadres cloisonnés | Disponible en version stable, avec une augmentation de 5% à partir du 9 novembre. |
| Stockage partagé | Sera disponible en version stable, à partir de 1% à partir du 9 novembre. |
Octobre 2022: augmentation de 5 %
Attribution Reporting, Topics, l'API Protected Audience et Fenced Frames sont actuellement tous disponibles dans la version stable de Chrome et feront partie de l'augmentation du trafic.
Nous allons commencer à augmenter le trafic pour Attribution Reporting et Topics à partir de cette semaine, ainsi que pour l'API Protected Audience et Fenced Frames à partir du 9 novembre.
Pour en savoir plus, consultez l'article de blog Augmentation de la phase d'évaluation de la pertinence et des mesures de la Privacy Sandbox à 5% (en anglais).
| API | Remarques |
|---|---|
| Attribution Reporting | Disponible en version stable, jusqu'à 5% après le 26 octobre. |
| Thèmes | Disponible en version stable, jusqu'à 5% après le 26 octobre. |
| API Protected Audience | Disponible en version stable, avec une augmentation de 5% à partir du 9 novembre. |
| Cadres cloisonnés | Disponible en version stable, avec une augmentation de 5% à partir du 9 novembre. |
| Stockage partagé | Disponible uniquement dans M105+ Canary, en développement et bêta pour le moment. |
Octobre 2022
- La phase d'évaluation a été étendue à Chrome 110.
- Consultez la page Premiers pas avec les phases d'évaluation de Chrome pour savoir comment renouveler votre inscription à cette phase. Cela inclut la fourniture d'un nouveau jeton aux origines participantes. La procédure est la même que pour toute autre extension d'évaluation d'origine.
Cette prolongation a été accordée pour donner à l'écosystème le temps de disposer d'une version stable Continuez à tester et à valider les améliorations de l'API, tout en donnant votre avis conformément à notre calendrier public actuel.
Le calendrier global de la Privacy Sandbox reste inchangé.
API incluses dans l'essai:
| API | Remarques |
|---|---|
| L'attribution Création de rapports | Développeur pour la phase d'évaluation. |
| API Protected Audience | Développeur pour la phase d'évaluation. |
| Thèmes | Développeur pour la phase d'évaluation. |
| Clôturé Cadres | Consultez les conseils de l'API Protected Audience concernant l'utilisation de la phase d'évaluation. |
| Partagées Stockage | Disponible uniquement dans M105+ Canary, en développement et bêta pour le moment. |
Août 2022
- La phase d'évaluation permet de faire passer jusqu'à 1% des utilisateurs d'ordinateurs de bureau de la version 104 de Chrome à la version stable.
- Les mises à jour s'afficheront lorsque cette fonctionnalité concernera les utilisateurs mobiles.
- Les versions préstables (Canary, bêta) restent à 50% des utilisateurs.
- Les API ne sont pas disponibles sur Chrome pour iOS.
Mai 2022
La phase d'évaluation permet à 50% des utilisateurs de rejoindre la version bêta de Chrome 102 de plus.
API incluses dans l'essai:
| API | Remarques |
|---|---|
| L'attribution Création de rapports | Développeur pour la phase d'évaluation. |
| API Protected Audience | Développeur pour la phase d'évaluation. |
| Thèmes | Guide du développeur pour phase d'évaluation. Topics a été brièvement désactivé lors de la phase d'évaluation en raison d'un bug qui la stabilité du navigateur est affectée. |
| Clôturé Cadres | Cadres cloisonnés ajoutés à la phase d'évaluation. Consultez les conseils de l'API Protected Audience pour 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 |
|---|---|
| L'attribution Création de rapports | Intent individuel à la section "Test" (I2E). Attribution Reporting est également disponible en tant que une phase d'évaluation individuelle. |
| API Protected Audience | Intent individuel à la section "Test" (I2E). L'API Protected Audience n'est disponible que sur ordinateur avec un sous-ensemble de fonctionnalités. |
| Thèmes | Intent individuel à la section "Test" (I2E). |
S'inscrire et configurer la phase d'évaluation
Pour activer la phase d'évaluation sur votre site, vous devez vous enregistrer et l'intégrer le jeton d'évaluation attribué (une chaîne temporelle pour votre accès spécifique la phase d'évaluation). Pour en savoir plus, consultez Premiers pas avec l'origine de Chrome d'évaluation.
Les jetons d'essai Origin Trial sont accordés immédiatement, et vous pouvez les révoquer ou les recréer à tout moment.
Pour chaque page sur laquelle vous souhaitez utiliser la phase d'évaluation, vous devez inclure un jeton d'essai 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 d'évaluation de l'origine dans un iFrame (comme l'API Protected Audience
joinAdInterestGroup()), le jeton doit être fourni dans l'iFrame.
et faire correspondre l'origine de l'iFrame.
Configurer un site intersite avec JavaScript
Si vous utilisez des fonctionnalités d'évaluation via le code JavaScript intersites, comme c'est le cas le fournisseur du code JavaScript tiers inclus dans la page de premier niveau, vous devez alors:
- Sélectionnez l'option Mise en correspondance tierce lors de l'enregistrement de l'origine. essai sans frais.
- Le champ Origine Web doit indiquer l'origine de votre script.
- Injectez la balise
<meta>dans la page de premier niveau (c'est-à-dire dans la page et non le vôtre) à 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 la phase d'évaluation
Vous pouvez vérifier l'état d'une phase d'évaluation dans DevTools > Applications panneau.
<ph type="x-smartling-placeholder">
- Faites défiler la page jusqu'au volet Frames.
- Sélectionnez le cadre dans lequel vous souhaitez définir le jeton. Par exemple, la valeur top cadre de la page de premier niveau ou le cadre iFrame spécifique pour les pages intégrées.
- Dans le volet de droite, faites défiler la page jusqu'à la section Phases d'évaluation.
- Vous devriez voir une entrée pour l'essai
PrivacySandboxAdsAPIs. - Développez cette entrée pour afficher l'état de la phase d'évaluation et de vos de jetons.
La phase d'évaluation est limitée à une petite partie des utilisateurs de Chrome, et votre navigateur peut
ne font pas partie du groupe de test. Il se peut donc qu'un TrialNotAllowed rouge s'affiche
message à l'attention de PrivacySandboxAdsAPIs. Lorsque vous développez l'entrée pour vérifier
État du jeton, si un message Success vert s'affiche, votre phase d'évaluation
est correcte. Les utilisateurs éligibles verront le message Enabled.
Si vous voyez des messages différents, consultez Résoudre les problèmes liés à l'origine de Chrome d'essais pour valider votre configuration de la phase d'évaluation.
Détecter des caractéristiques
Comme pour toutes les fonctionnalités Web, vérifiez qu'elles sont bien disponibles dans le navigateur avant d'essayer de les utiliser. Pour ce faire, il vous suffit de vérifier 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 petite partie des utilisateurs de Chrome. Elles doivent également avoir la fonctionnalité correspondante activée dans ses paramètres pour être éligible essai:
Paramètres du navigateur
Pour qu'un utilisateur soit éligible à l'essai, il doit:
utiliser une version et un canal de Chrome associés à la phase d'évaluation ; en cours d'exécution.
- Consultez la section État de la phase d'évaluation pour connaître les configurations actuelles.
faire partie du groupe de test actif dans Chrome ;
Paramètres utilisateur
Pour qu'un utilisateur soit éligible à l'essai, il doit également:
- avoir activé l'essai de la Privacy Sandbox dans Paramètres > Sécurité et
confidentialité > Privacy Sandbox, également accessible via
chrome://settings/adPrivacy - Activez les cookies tiers dans Paramètres > Sécurité et confidentialité >
Cookies et autres données de site définis sur "Autoriser tous les cookies" ou "Bloquer"
en mode navigation privée, également accessibles via
chrome://settings/cookies - être en session de navigation standard et non en mode navigation privée ;
Même si la phase d'évaluation n'apparaît comme active que pour les utilisateurs éligibles, vous pouvez aussi Utilisez les indicateurs de développeur pour effectuer des tests par rapport à votre propre production. sur votre site.
Contrôler votre participation à la phase d'évaluation
Le fonctionnement de la phase d'évaluation reste le même: vous obtenez une phase d'évaluation. pour les contextes dans lesquels vous souhaitez tester les API. Avec l'attribut élargissant le groupe de testeurs, vous devez vous assurer que vous surveillez activement et de contrôler le niveau de trafic pour lequel vous choisissez d'activer l'essai.
Voici une bonne approche:
- Incluez les jetons d'essai d'origine par défaut dans tous les contextes où vous souhaitez test.
- Utilisez la détection de fonctionnalités pour rechercher les API actives.
- Si les API sont actives (et que, par conséquent, le navigateur est éligible pour cette choisissez de les utiliser ou non en fonction de votre propre test. critères. Par exemple, si vous disposez déjà d'une infrastructure de tests A/B pour effectuer des tests sur un pourcentage du trafic, un échantillonnage ou un autre attribut, à ce stade, vous pouvez décider des fonctionnalités que vous utiliserez activement.
Vous pouvez empêcher complètement la participation à la phase d'évaluation depuis n'importe quel navigateur. une instance en n'incluant pas le jeton dans la réponse. Par exemple, si vous avez avez atteint votre propre quota pour un test ou avez besoin de résoudre un problème essai, l'exclusion du jeton garantit qu'aucune fonctionnalité expérimentale disponibles ou actives sur la page.
Contrôle de l'essai Origin Trial par région géographique
Vous ne pouvez pas désactiver une phase d'évaluation pour des régions spécifiques. Les essais Origin Trial sont actifs sur les pages contenant les 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 zone géographique de l'utilisateur, vous pourriez écrire un code pour inclure en fonction de ces informations d'emplacement. Par exemple : pourrait tenter d'utiliser les adresses IP pour déterminer la localisation d'un utilisateur. Adresses IP peut faire l'objet de spoofing, ce qui n'est donc pas garanti.
Toutefois, une origine géographique peut définir un niveau d'autorisation
des règles 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'un
a désactivé la phase d'évaluation.
Avec une règle d'autorisation, un site ajoute un petit extrait de code à ses pages qui fournit des instructions au navigateur. Une fois la page chargée, le navigateur lit les instructions du règlement relatif aux autorisations et autorise ou bloque les fonctionnalités (ou les API) comme décrit dans le règlement relatif aux autorisations. Si un site souhaite restreindre une API dans une région spécifique, le développeur peut définir une règle pour toutes les pages demandées de cette région.
Renouveler votre jeton
Les jetons d'essai Origin Trial expirent six semaines après leur date d'émission (ou à la fin de la essai s'il est plus tôt).
Vous devez impérativement renouveler et déployer votre nouvelle des jetons dans cette période pour sans interruption des fonctionnalités de la phase d'évaluation.
Le renouvellement des jetons ne prend que quelques minutes. Vous pouvez déployer plusieurs jetons le même essai sur la même page. Vous pouvez déployer un jeton renouvelé avant que votre le jeton existant expire, donc le service n'est pas interrompu pour les utilisateurs.
Tester en local
Pour obtenir des conseils spécifiques sur les tests en local pour les développeurs, consultez les pages suivantes:
Les API ne sont pas activées par défaut et doivent être activées avec de paramètres pour tests. Assurez-vous que les mêmes paramètres de configuration sont activés ci-dessus, puis:
- Utilisez une version et un canal de Chrome dans lesquels les fonctionnalités sont disponibles.
- Activez toutes les API Ad Privacy sous
chrome://settings/adPrivacy.
Consultez les guides du développeur pour connaître la disponibilité d'API et de fonctionnalités spécifiques des options supplémentaires pour une configuration plus précise.