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 découvrir le cycle de vie complet de l'API Protected Audience. Reportez-vous également à la présentation de l'API Protected Audience pour obtenir une proposition détaillée sur la façon dont les navigateurs enregistrent les groupes d'intérêt.
Vous n'êtes pas développeur ? Consultez la présentation de l'API Protected Audience.
Groupes d'intérêt de l'API Protected Audience
Un groupe d'intérêt de l'API Protected Audience représente un groupe de personnes ayant un intérêt commun, ce qui correspond à une liste de remarketing. Chaque groupe d'intérêt de l'API Protected Audience a un propriétaire.
Les propriétaires de groupes d'intérêt agissent en tant qu'acheteur dans les enchères d'annonces de l'API Protected Audience. L'appartenance à un groupe d'intérêt est stockée par le navigateur sur l'appareil de l'utilisateur, et n'est pas partagée 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 qui montre comment créer un groupe 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 d'intérêt. Cette valeur 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 du groupe 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 d'intérêt. Dans l'implémentation actuelle, les attributs suivants peuvent être modifiés :
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Tout champ non spécifié dans le fichier JSON ne sera pas écrasé. Seuls les champs spécifiés dans le fichier JSON seront mis à jour. En revanche, l'appel de navigator.joinAdInterestGroup() écrase tout groupe d'intérêt existant.
Les mises à jour sont traitées aussi efficacement que possible et peuvent échouer dans les cas suivants :
- Délai avant expiration de la requête réseau (actuellement 30 secondes).
- Autre échec réseau.
- Échec de l'analyse JSON.
Les mises à jour sont limitées à une par jour maximum.
Les mises à jour peuvent être annulées si trop de temps consécutif a été consacré à la mise à jour, mais cela n'impose aucune limitation de débit aux mises à jour annulées (restantes). Les mises à jour qui échouent en raison d'erreurs réseau sont relancées au bout d'une heure. Celles qui échouent en raison d'une déconnexion d'Internet sont relancées immédiatement aprè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 de se produire trop fréquemment : les appels répétés à navigator.updateAdInterestGroups() ne font rien tant que la période de limitation du débit (actuellement un jour) n'est pas écoulée.
La limite de débit est réinitialisée si navigator.joinAdInterestGroup() est appelé à nouveau pour le même groupe d'intérêt owner et name.
Mises à jour automatiques
Tous les groupes d'intérêt chargés pour une enchère sont mis à jour automatiquement une fois l'enchère terminée, sous réserve des mêmes limites de fréquence que les mises à jour manuelles.
Pour chaque propriétaire ayant au moins un groupe d'intérêt participant à une enchère, 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
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.