Phase d'évaluation unifiée : pertinence et mesure

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

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

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">
</ph> État &quot;Token Success&quot; (Réussite du jeton) et activé.
État "Token Success" (Réussite du jeton) et activé.
  1. Faites défiler la page jusqu'au volet Frames.
  2. 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.
  3. Dans le volet de droite, faites défiler la page jusqu'à la section Phases d'évaluation.
  4. Vous devriez voir une entrée pour l'essai PrivacySandboxAdsAPIs.
  5. 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.

<ph type="x-smartling-placeholder">
</ph> État &quot;Jeton réussi&quot; et n&#39;est pas activé.
État "Token Success" (Réussite du jeton) et non activé.

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.

  • 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:

  1. Incluez les jetons d'essai d'origine par défaut dans tous les contextes où vous souhaitez test.
  2. Utilisez la détection de fonctionnalités pour rechercher les API actives.
  3. 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.