Découvrez comment mettre à jour les données d'audience en configurant une URL de mise à jour pour un groupe de centres d'intérêt de l'API Protected Audience. Consultez le guide du développeur pour connaître le cycle de vie complet de l'API Protected Audience, et reportez-vous à la vidéo explicative de l'API Protected Audience pour découvrir en détail comment les navigateurs enregistrent les groupes de centres d'intérêt.
Vous n'êtes pas développeur ? Consultez la présentation de l'API Protected Audience.
Groupes de centres d'intérêt de l'API Protected Audience
Un groupe de centres d'intérêt de l'API Protected Audience représente un groupe de personnes ayant un intérêt commun, correspondant à une liste de remarketing. Chaque groupe de centres d'intérêt de l'API Protected Audience a un propriétaire.
Les propriétaires de groupes de centres d'intérêt agissent en tant qu'acheteurs dans les enchères publicitaires de l'API Protected Audience. Les groupes de centres d'intérêt sont stockés par le navigateur sur l'appareil de l'utilisateur et ne sont partagés avec le fournisseur du navigateur ni avec qui que ce soit d'autre.
Fonctions de l'API
Exemple d'utilisation
Voici l'exemple du guide sur la définition des données d'audience. Il montre comment créer un groupe de centres d'intérêt et demander au navigateur de le rejoindre.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl fournit une URL qui renvoie un fichier JSON pour mettre à jour les attributs du groupe de centres d'intérêt. Il doit avoir la même origine que owner.
Mettre à jour les attributs
updateUrl spécifie un serveur Web qui renvoie un fichier JSON définissant les propriétés des groupes de centres d'intérêt, correspondant à l'objet de groupe d'intérêt transmis à joinAdInterestGroup().
Cela permet au propriétaire du groupe de mettre à jour périodiquement les attributs du groupe de centres d'intérêt. Dans la mise en œuvre actuelle, les attributs suivants peuvent être modifiés:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Les champs non spécifiés dans le fichier JSON ne seront pas écrasés (seuls ceux spécifiés dans le fichier JSON seront mis à jour), tandis que l'appel de navigator.joinAdInterestGroup() écrasera tout groupe d'intérêt existant.
Les mises à jour reposent sur le principe du "meilleur effort" et peuvent échouer dans les conditions suivantes:
- Délai avant expiration de la requête réseau (30 secondes actuellement).
- Autre défaillance du réseau.
- Échec de l'analyse JSON.
Les mises à jour sont limitées à une par jour au maximum.
Les mises à jour peuvent être annulées si leur durée de mise à jour est trop longue, bien que cela n'impose aucune limitation du débit pour les mises à jour annulées (résidentes). Les mises à jour qui échouent en raison d'erreurs réseau font l'objet d'une nouvelle tentative après une heure, et celles qui échouent en raison d'une déconnexion d'Internet font l'objet d'une nouvelle tentative dès la reconnexion.
Mises à jour manuelles
Les mises à jour des groupes d'intérêt appartenant à l'origine du frame actuel peuvent être déclenchées manuellement à l'aide de navigator.updateAdInterestGroups().
La limitation du débit empêche les mises à jour trop fréquentes: les appels répétés de navigator.updateAdInterestGroups() n'ont aucun effet tant que la période de limitation du débit (un jour actuellement) n'est pas écoulée.
La limite du taux est réinitialisée si navigator.joinAdInterestGroup() est rappelé pour le même groupe de centres d'intérêt owner et name.
Mises à jour automatiques
Tous les groupes d'intérêt chargés pour une mise aux enchères sont mis à jour automatiquement une fois la mise aux enchères terminée, selon les mêmes limites de taux que celles appliquées manuellement.
Pour chaque propriétaire avec au moins un groupe de centres d'intérêt participant à une mise aux enchères, c'est comme si navigator.updateAdInterestGroups() était appelé à partir d'un iFrame dont l'origine correspond à ce propriétaire.
Toutes les références de l'API Protected Audience
API reference guides are available:
- Developer guide for the Protected Audience API.
- Ad buyer guide to Protected Audience interest groups and bid generation.
- Ad seller guide to Protected Audience ad auctions.
- Guide to reporting auction results
- Best practices for Protected Audience ad auction latency
- Troubleshoot Protected Audience
The Protected Audience API explainer also provides detail about feature support and constraints.