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
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.