Tester les API de mesure et de pertinence des annonces de la Privacy Sandbox

La Privacy Sandbox comprend une sélection de propositions pour permettre des cas d'utilisation publicitaires sans avoir à effectuer de suivi intersites. Les phases d'évaluation permettent aux développeurs d'évaluer les nouvelles technologies Web et d'envoyer des commentaires à leur sujet par le biais de tests concrets. Lors de précédentes phases d'évaluation, les sites pouvaient tester des API individuelles. Pour les API Topics, FLEDGE et Attribution Reporting, nous fournissons une phase d'évaluation unique qui permet aux sites d'exécuter des tests unifiés sur les API qui constituent une version initiale du cycle de vie publicitaire de bout en bout. Les API sont disponibles à des fins de test dans Chrome 101 bêta et versions ultérieures. La version bêta de Chrome 101 voit également des mises à jour des commandes utilisateur à mesure que nous continuons à itérer sur les options de configuration.

En tant que développeur, vous pourrez vous inscrire à cette phase d'évaluation unique qui vous permettra d'effectuer des tests sur les API Topics, FLEDGE et Attribution Reporting. Ce guide décrit les étapes de configuration pour accéder aux API, explique comment valider votre configuration et fournit d'autres ressources pour tester les API.

Que contient la phase d'évaluation ?

L'objectif de cette phase d'évaluation est de permettre des tests pertinents tout au long du cycle de vie des annonces sur plusieurs sites. Pour couvrir ce parcours, la phase d'évaluation comprend les éléments suivants:

  • Topics pour observer et accéder aux sujets d'un navigateur via document.browsingTopics().
  • FLEDGE pour gérer les groupes de centres d'intérêt d'un navigateur, ainsi que les enchères et la sélection des annonces en fonction de ces groupes et d'autres signaux.
  • Fenced frames (Cadres cloisonnés) pour afficher l'URL opaque du gagnant des enchères publicitaires FLEDGE
  • Attribution Reporting pour mesurer et générer des rapports sur les performances tout au long du cycle de vie des annonces.
    • Dans le cadre d'Attribution Reporting, les rapports agrégables doivent être traités et agrégés par un service d'agrégation pour produire des rapports récapitulatifs. Nous publierons bientôt des outils et des guides supplémentaires pour les tests en local et la phase d'évaluation.
    • Si vous avez participé à des phases d'évaluation précédentes pour Attribution Reporting, sachez que vous devrez effectuer la mise à jour conformément aux dernières modifications de l'API. Consultez le guide de migration pour en savoir plus.

Bien que cette configuration permette des tests unifiés pour toutes ces API, vous pouvez choisir les aspects à implémenter, en fonction de vos besoins.

Comment les développeurs s'inscrivent-ils à la phase d'évaluation ?

Inscrivez-vous à l'essai Pertinence et mesures de la Privacy Sandbox. À l'aide des balises HTML suivantes, fournissez un jeton d'essai sur chaque page sur laquelle vous souhaitez exécuter le code de l'API:

  • Balise <meta> dans la section <head> de la page de premier niveau : <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • En-tête HTTP dans la réponse de la page de premier niveau : Origin-Trial: TOKEN_GOES_HERE

Certaines fonctionnalités disponibles dans la phase d'évaluation sont destinées à être utilisées dans des contextes intersites, par exemple lorsque vous fournissez un service en tant que tiers sur le site de premier niveau. Si vous devez activer votre phase d'évaluation pour ces contextes supplémentaires, assurez-vous de sélectionner l'option "Correspondance tierce". Pour activer la phase d'évaluation à partir d'un script JavaScript tiers, 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);

Pour en savoir plus, consultez le guide de démarrage avec les phases d'évaluation de Chrome.

Comment les développeurs effectuent-ils des tests en local ?

La documentation individuelle destinée aux développeurs pour Topics, FLEDGE et Attribution Reporting fournit des conseils spécifiques sur les tests pour les développeurs locaux pour chaque API. Les API ne sont pas activées par défaut et doivent être activées avec des options pour les tests.

Pour activer les API à des fins de test, vous devez:

  • Utilisez Chrome 101 bêta ou une version ultérieure.
    • FLEDGE nécessite l'installation de Chrome pour ordinateur.
    • Les API ne sont pas disponibles sur les versions iOS de Chrome.
  • Activez les API à l'aide de l'option chrome://flags/#privacy-sandbox-ads-apis.
    • Cet indicateur force l'activation des API pour faciliter les tests. Si vous souhaitez répliquer un utilisateur éligible pour la phase d'évaluation et que ses paramètres supplémentaires peuvent toujours désactiver les API, vous devez lancer Chrome à l'aide des indicateurs CLI : --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs.
    • Chaque API peut disposer d'options supplémentaires pour une configuration plus précise. Consultez les guides individuels pour en savoir plus.
    • Des indicateurs supplémentaires peuvent entrer en conflit avec celui-ci. Par conséquent, ne définissez cet indicateur que si vous rencontrez des problèmes.
  • Activez les essais de la Privacy Sandbox dans les paramètres de Chrome: Paramètres > Sécurité et confidentialité > Privacy Sandbox. Ce fichier est également accessible à l'adresse chrome://settings/adPrivacy.
  • Activez les cookies tiers dans les paramètres de Chrome: Paramètres > Sécurité et confidentialité. Définissez Cookies et autres données de site sur "Autoriser tous les cookies" ou "Bloquer les cookies tiers en mode navigation privée". Ce fichier est également accessible à l'adresse chrome://settings/cookies.
  • être dans une session de navigation standard ; N'utilisez pas le mode navigation privée.

Comment les développeurs vérifient-ils si la phase d'évaluation est correctement configurée ?

La page Dépannage des phases d'évaluation de Chrome fournit une checklist détaillée pour valider votre configuration de la phase d'évaluation.

Outils de développement affichant l&#39;état de la phase d&#39;évaluation sous &quot;Applications&quot;

Les outils de développement affichent l'état d'une phase d'évaluation dans l'onglet "Applications" sous "Frames".

Bien que la phase d'évaluation ne s'affiche que comme active pour les utilisateurs éligibles, comme indiqué ci-dessous, vous pouvez également utiliser les indicateurs de développeur pour effectuer un test sur votre propre site de production.

Quels utilisateurs sont éligibles à la phase d'évaluation ?

De par leur conception, les phases d'évaluation sont destinées à ne s'exécuter que sur une petite partie du trafic Chrome global. Par conséquent, vous devez toujours partir du principe que, même lorsque vous avez activé la phase d'évaluation sur votre site, l'API peut ne pas être active pour l'utilisateur. Le groupe actif dans la phase d'évaluation commencera avec une faible proportion d'utilisateurs et augmentera probablement à mesure que la phase d'évaluation progresse. Sachez que le pourcentage d'utilisateurs de Chrome participant au test peut ne pas correspondre au pourcentage d'utilisateurs activés sur votre site.

Toutefois, pour permettre un test unifié entre les sites, cet ensemble d'utilisateurs éligibles doit rester globalement cohérent. Par exemple, si un utilisateur est éligible à la phase d'évaluation lorsqu'il voit une annonce sur le site d'un éditeur participant, il doit toujours être éligible lorsqu'il effectue une conversion sur le site d'un annonceur participant.

Pour être éligible, un utilisateur doit:

  • doivent utiliser Chrome 101 bêta ou une version ultérieure.
    • FLEDGE nécessite l'installation de Chrome pour ordinateur.
    • aucune phase d'évaluation n'est disponible sur les versions iOS de Chrome.
  • naviguent pendant la période d'évaluation active.
  • avoir les essais de la Privacy Sandbox activés via Paramètres > Sécurité et confidentialité > Privacy Sandbox, également accessible via chrome://settings/adPrivacy ;
  • activer les cookies tiers via Paramètres > Sécurité et confidentialité > Cookies et autres données de site sur "Autoriser tous les cookies" ou "Bloquer les cookies tiers en mode navigation privée", également accessible via chrome://settings/cookies.
  • être en session de navigation standard et non en mode navigation privée ;
  • faire partie du groupe de test actif dans Chrome ;

Comment les développeurs doivent-ils détecter la compatibilité avec les API ?

Comme pour toute fonctionnalité de plate-forme Web, vous devez vérifier sa compatibilité avant de l'utiliser.

Sujets

Vérifiez la fonction browsingTopics() dans document et les règles d'autorisation (https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) pour "browsing-topics".

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

Si vous souhaitez rejoindre un groupe de centres d'intérêt associé à une annonce, recherchez la fonction joinAdInterestGroup dans navigator et les règles relatives aux autorisations pour "join-ad-interest-group".

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

Si vous voulez lancer une mise aux enchères, vérifiez la fonction runAdAuction dans navigator, ainsi que la règle relative aux autorisations pour "run-ad-auction".

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

Rapports sur l'attribution

Recherchez l'objet attributionReporting dans window et les règles relatives aux autorisations pour "attribution-reporting".

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

Où les développeurs peuvent-ils envoyer des commentaires et obtenir de l'aide ?

La page de présentation des commentaires détaille les différents itinéraires permettant de donner son avis sur différents aspects de la Privacy Sandbox. Il existe des sections spécifiques pour Topics, FLEDGE et Attribution Reporting, qui fournissent les liens individuels pour chaque API.

Nous publions régulièrement des informations sur les progrès de la série Privacy Sandbox, qui présentent un résumé des actualités importantes.