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. Lisez le guide du développeur pour découvrir le cycle de vie complet de l'API Protected Audience, et reportez-vous à la présentation 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 centre d'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 et sur l'appareil de l'utilisateur. Ils ne sont pas partagés avec le fournisseur du navigateur ni avec qui que ce soit.
Fonctions de l'API
Exemples d'utilisation
Voici l'exemple issu du guide qui explique comment définir les 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 au format 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 au format JSON les propriétés de groupes de centres d'intérêt correspondant à l'objet de groupe de centres d'intérêt transmis à joinAdInterestGroup().
Cela permet au propriétaire du groupe de mettre régulièrement à jour les attributs du groupe de centres d'intérêt. Dans l'implémentation 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 les champs spécifiés dans le fichier JSON sont mis à jour, tandis que l'appel de navigator.joinAdInterestGroup() écrase les groupes de centres d'intérêt existants.
Les mises à jour s'effectuent dans la mesure du possible et peuvent échouer dans les conditions suivantes:
- Délai avant expiration de la requête réseau (actuellement 30 secondes).
- Autre défaillance réseau.
- Échec de l'analyse JSON.
La fréquence des mises à jour est limitée à une par jour.
Les mises à jour peuvent être annulées si trop de temps contigus a été consacré à la mise à jour, bien que cela n'impose aucune limite de débit pour les mises à jour annulées (restantes). Les mises à jour ayant échoué en raison d'erreurs réseau font l'objet d'une nouvelle tentative au bout d'une heure. Celles qui échouent en raison d'une déconnexion d'Internet font l'objet d'une nouvelle tentative immédiatement après la reconnexion.
Mises à jour manuelles
Les mises à jour des groupes de centres 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 à navigator.updateAdInterestGroups() n'ont aucun effet avant la fin de la période de limitation du débit (actuellement un jour).
La limite du taux est réinitialisée si navigator.joinAdInterestGroup() est appelé de nouveau pour les mêmes groupes de centres d'intérêt owner et name.
Mises à jour automatiques
Tous les groupes de centres d'intérêt chargés pour une mise aux enchères sont mis à jour automatiquement une fois l'enchère terminée. Ils sont soumis aux mêmes limites de taux que les mises à jour manuelles.
Pour chaque propriétaire ayant au moins un groupe de centres d'intérêt participant à une mise aux enchères, navigator.updateAdInterestGroups() est appelé à partir d'un iFrame dont l'origine correspond à ce propriétaire.
Toutes les documentations de référence de l'API Protected Audience
Des guides de référence de l'API sont disponibles:
- Guide du développeur de l'API Protected Audience
- Guide des acheteurs d'annonces pour les groupes de centres d'intérêt et la génération d'enchères de l'API Protected Audience
- Guide des vendeurs publicitaires pour les enchères publicitaires Protected Audience
- Guide sur la création de rapports sur les résultats des enchères
- Bonnes pratiques concernant la latence des enchères publicitaires Protected Audience
- Résoudre les problèmes liés à Protected Audience
L'article explicatif de l'API Protected Audience fournit également des informations détaillées sur la compatibilité des fonctionnalités et les contraintes.