Cette page a été traduite par l'API Cloud Translation.

Rapports sur les enchères de l'API Protected Audience

Mesurer les données des enchères et les résultats de l'API Protected Audience

Cet article présente dans les grandes lignes les différents mécanismes vous permettant de transmettre les données d'enchères de l'API Protected Audience à votre serveur, ainsi que les mécanismes de transition disponibles dès maintenant pendant la migration, jusqu'à ce que d'autres solutions soient prêtes.

Pour générer des rapports sur les métriques importantes que vous collectez à partir d'une enchère publicitaire, l'API Protected Audience est compatible avec:

Private Aggregation, qui collecte les signaux et les résultats d'enchères pour générer des rapports récapitulatifs.
L'API Ads Reporting pour les cadres Fenced et les iFrames, qui est un canal au sein des frames pour communiquer avec les Worklets de l'API Protected Audience. L'API permet d'associer les données au niveau de l'événement aux signaux des enchères. La création de rapports au niveau des événements de l'API Ads Reporting constitue un mécanisme de transition jusqu'à ce qu'un mécanisme de reporting plus privé soit conçu.
Attribution Reporting, qui vous permet d'associer les données de conversion aux signaux des enchères
Stockage partagé, qui vous permet d'écrire des signaux d'enchères dans un stockage multi-origine, puis de générer des rapports sur ces données ultérieurement à l'aide de l'agrégation privée.

Présentation des rapports de l'API Protected Audience

Workflow global de l'API Protected Audience

Il existe trois périodes principales au cours desquelles les données du flux d'enchères de l'API Protected Audience peuvent être transmises à votre serveur: la date et l'heure de la mise aux enchères lorsque la mise aux enchères est exécutée à partir du site de l'éditeur, le délai d'affichage lorsque l'annonce est diffusée dans un cadre cloisonné ou dans un iFrame sur le site de l'éditeur, et la date et l'heure de la conversion lorsque l'utilisateur effectue une action sur un autre site qui peut être attribuée à l'enchère.

Au moment de la mise aux enchères, vous pouvez créer des rapports sur les données d'enchères à l'aide de Worklets de création de rapports. Pendant le délai d'affichage, vous pouvez générer des rapports sur les données d'engagement à partir d'un iFrame ou d'un frame cloisonné. Au moment de la conversion, vous pouvez créer des rapports sur les données d'attribution depuis la page de destination à l'aide de l'API Attribution Reporting.

Zones géographiques des rapports

Lors d'une mise aux enchères, les acheteurs peuvent signaler les signaux disponibles dans les Worklets generateBid() et reportWin(), tandis que les vendeurs peuvent signaler les signaux disponibles dans scoreAd() et reportResult(). En dehors d'une mise aux enchères, les acheteurs et les vendeurs peuvent générer des rapports sur les données provenant d'un frame ayant affiché l'annonce et du site à partir duquel la conversion a été effectuée.

Période	Destination	Emplacement	Données disponibles	API Reporting disponibles
Enchères	Revendeur	`generateBid()`	Signaux, résultats et performances des enchères	API Private Aggregation
	Revendeur	`reportWin()`		API Private Aggregation API Ads Reporting
	Vendeur	`scoreAd()`		API Private Aggregation
	Vendeur	`reportResult()`		API Private Aggregation API Ads Reporting
Rendu	Acheteur / Vendeur	Cadre sur le site de l'éditeur	Données au niveau des événements dans le frame de l'annonce	API Private Aggregation API Ads Reporting
Conversion	Acheteur / Vendeur	Site de conversion	Données au niveau des événements et des conversions provenant du site de conversion	API Attribution Reporting API Private Aggregation API Ads Reporting

Au cours de chacune des périodes listées, les acheteurs et les vendeurs auront accès à diverses API de reporting disponibles pour générer des rapports sur des données telles que les signaux d'enchères, les données au niveau des événements et les données de conversion.

Données disponibles dans les enchères de l'API Protected Audience

Les données suivantes peuvent être enregistrées à partir d'un worklet d'API Protected Audience lors de la mise aux enchères.

Signaux

Les signaux sont les données contextuelles sur les enchères, les données utilisateur, les données en temps réel et les données de navigateur disponibles pour les acheteurs et les vendeurs dans un worklet. Ils permettent de générer une enchère, d'évaluer une annonce et de générer un rapport sur les résultats d'une mise aux enchères.

Signal	Description	Définir le lieu	Utilisateurs	Disponibilité
auctionSignals	Données disponibles concernant le lieu de la mise aux enchères. Il peut s'agir d'informations sur le contenu des pages, de données utilisateur first party, etc.	Défini par le vendeur à partir du site de l'éditeur dans la configuration de la mise aux enchères.	Acheteur Vendeur	generateBid scoreAd reportWin reportResult
directFromSellerSignals	Les données sont les mêmes pour `auctionSignals`, `perBuyerSignals` et `sellerSignals`, mais les signaux sont assurés de provenir du vendeur spécifié.	Défini via les en-têtes de réponse HTTP du vendeur	Acheteur Vendeur	generateBid scoreAd reportWin reportResult
browserSignals	Diverses données fournies par le navigateur (`topWindowHostname`, `interestGroupOwner`, `renderUrl`, `adComponents`, `biddingDurationMsec`, `IGJoinCount`, `IGRecency`, `modelingSignals`)	Défini par le navigateur.	Acheteur Vendeur	generateBid scoreAd reportWin reportResult
sellerSignals	Signaux fournis au vendeur pour l'évaluation des annonces.	Défini par le vendeur à partir du site de l'éditeur dans la configuration de la mise aux enchères.	Vendeur	scoreAd rapportWin reportResult
trustedScoringSignals	Signaux en temps réel fournis au vendeur pour l'évaluation des annonces.	L'URL est définie par le vendeur à partir du site de l'éditeur dans la configuration de la mise aux enchères.	Vendeur	scoreAd reportResult
perBuyerSignals	Données contextuelles sur les enchères fournies à des acheteurs spécifiques. Le vendeur peut récupérer les valeurs à fournir aux acheteurs avant le début des enchères. Il s'agit des informations que l'acheteur connaît sur l'opportunité d'annonce.	Défini par le vendeur à partir du site de l'éditeur dans la configuration de la mise aux enchères.	Revendeur	generateBid scoreAd reportWin reportResult
trustedBiddingSignals	Signaux en temps réel fournis aux acheteurs pour les enchères publicitaires.	L'acheteur définit l'URL à partir du site de l'annonceur lorsque le groupe de centres d'intérêt est défini.	Revendeur	generateBid
userBiddingSignals	Données utilisateur fournies par l'acheteur.	Défini par l'acheteur à partir du site de l'annonceur lorsque le groupe de centres d'intérêt est défini .	Revendeur	generateBid

L'objet configuration des enchères est la principale source de données fournies pour être disponibles en tant que signaux dans les Worklets. L'éditeur et le vendeur peuvent fournir des données contextuelles et des données first party dans la configuration de l'enchère. Ces signaux peuvent être enrichis avec les données sur les groupes de centres d'intérêt de l'acheteur, les données au niveau de l'événement provenant du cadre de rendu de l'annonce et les données d'attribution de la page de clic. Les données enregistrées peuvent être utilisées pour la création de rapports acheteur/vendeur, la facturation, la budgétisation, l'entraînement de modèles de ML, etc.

Autres données disponibles

Données de résultats liées aux données sur les enchères remportées et perdues, telles que le prix de l'enchère gagnante et le motif de refus de l'enchère.
Données de performances qui contiennent des informations de latence, telles que le temps nécessaire pour récupérer et exécuter le worklet d'enchères.

Données disponibles en dehors d'une mise aux enchères de l'API Protected Audience

En dehors des enchères de l'API Protected Audience, les données sont disponibles pour les rapports sur deux périodes différentes.

Pendant le délai d'affichage, lorsque l'annonce est diffusée sur le site de l'éditeur, les données au niveau des événements provenant de l'iFrame ou du cadre clôturé peuvent être associées aux données d'enchères de l'API Protected Audience et communiquées à votre serveur. Voici quelques exemples de données au niveau des événements : impression d'annonce, clic, survol et tout autre événement se produisant dans le cadre.

Au moment de la conversion, lorsqu'un utilisateur effectue une action sur la page de destination qui est attribuée à l'enchère, les données au niveau des événements de la page de conversion peuvent être associées aux données des enchères de l'API Protected Audience et transmises à votre serveur.

Création de rapports au niveau des événements

Les rapports au niveau des événements détaillent les informations concernant un ou plusieurs événements. Il peut s'agir d'une mise aux enchères, d'une impression d'annonce ou d'une conversion. Jusqu'en 2026, les rapports sur l'attribution des enchères au niveau des événements continueront d'être utilisés. Les cadres cloisonnés ne seront pas nécessaires pour afficher une annonce Protected Audience, et un iFrame avec un accès réseau illimité pourra être utilisé pour les rapports au niveau des événements. En outre, l'API Ads Reporting est disponible dans les cadres cloisonnés et les cadres iFrame. Vous pouvez ainsi associer les données sur les enchères et les conversions aux données au niveau des événements provenant du frame. Cette approche vise à faciliter la migration de l'écosystème, car vous pouvez continuer à utiliser votre infrastructure de reporting existante jusqu'en 2026 au moins, le temps de migrer votre système vers Protected Audience.

Rapports sur les enchères remportées au niveau des événements avec `sendReportTo()`

Un mécanisme permettant de créer des rapports sur les données au niveau des événements dans une mise aux enchères Protected Audience est le sendReportTo() function en cas d'enchère remportée. La fonction est disponible dans les Worklets de création de rapports de l'acheteur et du vendeur. Le navigateur envoie une requête GET à la chaîne d'URL fournie au début de l'affichage de l'annonce. Vous pouvez encoder n'importe quel signal disponible dans vos Worklets en tant que paramètres de requête de l'URL.

Par exemple, un acheteur peut indiquer le montant de l'enchère gagnante à partir du worklet reportWin() pour la facturation:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

La fonction sendReportTo() permet de générer un rapport sur les offres remportées pour le vendeur lorsqu'elle est appelée depuis reportResult(), et un rapport sur les gains pour l'acheteur lorsqu'elle est appelée depuis reportWin(). La fonction sendReportTo() est disponible jusqu'en 2026 au moins.

Rapport sur l'engagement

Un rapport sur l'engagement contient des données au niveau des événements provenant d'une création publicitaire, telles que les données sur les impressions ou les clics qui sont associées aux signaux de la mise aux enchères de l'API Protected Audience ayant diffusé l'annonce. Étant donné que l'annonce est diffusée une fois l'enchère terminée, les signaux des enchères ne sont pas disponibles dans le cadre qui affiche l'annonce. Afin d'associer ces données pour différentes périodes, nous vous proposons deux mécanismes de transition permettant de générer des rapports sur l'engagement.

La fonction sendReportTo() décrite ci-dessus peut être utilisée pour associer des données d'enchères aux données au niveau de l'événement provenant d'un iFrame. Toutefois, elle ne fonctionne pas pour un frame cloisonné, car un ID unique ne peut pas être transmis à partir de l'intégrateur, car la communication entre celui-ci et le frame cloisonné est limitée. L'API Ads Reporting permet d'associer les données des enchères aux données au niveau de l'événement d'une annonce frame cloisonnée.

API Ads Reporting pour les cadres cloisonnés et les iFrames

L'API Ads Reporting pour les cadres cloisonnés et les iFrames vous permet d'associer des données au niveau de l'événement utilisateur provenant d'un frame d'annonce à des signaux lors d'une mise aux enchères Protected Audience.

Dans un worklet de reporting de l'API Protected Audience, vous pouvez enregistrer une balise publicitaire avec la fonction registerAdBeacon() et transmettre votre URL de reporting avec les signaux ajoutés en tant que paramètres de requête. Vous devez également spécifier l'événement personnalisé que vous souhaitez associer à l'URL du rapport. Ensuite, lorsque l'annonce sera diffusée dans un frame cloisonné, vous pourrez déclencher l'événement personnalisé en appelant la fonction window.fence.reportEvent(). Les données disponibles dans la trame cloisonnée peuvent être ajoutées en tant que charge utile.

La fonction registerAdBeacon() n'est disponible que dans les fonctions de reporting. Elle n'est pas disponible dans la logique d'enchères de l'acheteur ni dans la logique d'évaluation du vendeur.

Dans l'exemple suivant, un ID de campagne est associé à une charge utile au niveau de l'événement avec les coordonnées de clic:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

L'API Fenced Frames Ads Reporting sera également disponible jusqu'en 2026 au moins pour les mêmes raisons que le reporting sur les annonces gagnantes.

Pour en savoir plus, consultez cette explication.

Accès réseau sans contrainte

Les cadres cloisonnés permettent de charger des ressources réseau de la même manière qu'un iFrame. Vous pouvez également envoyer à votre serveur des données au niveau des événements dans des cadres cloisonnés. Par la suite, vous pourrez générer des rapports côté serveur côté serveur en associant les données au niveau des événements d'un frame cloisonné aux données d'enchères envoyées avec sendReportTo(), comme expliqué dans la section Mécanisme de création de rapports au niveau des événements d'enchères ci-dessus.

L'accès au réseau sera limité de temps en temps après l'abandon des cookies tiers.

Les mécanismes de création de rapports au niveau des événements qui existent aujourd'hui dans l'API Protected Audience sont des mécanismes de transition, et une autre solution sera conçue pour mieux répondre aux cas d'utilisation existants.

Rapport sur l'attribution

Un rapport sur l'attribution vous permet d'associer une conversion sur un site Web à une annonce choisie dans une mise aux enchères de l'API Protected Audience. Par exemple, un utilisateur peut cliquer sur une annonce produit que vous diffusez, être redirigé vers le site de l'annonceur, y effectuer un achat, et vous souhaitez attribuer cet achat à l'annonce qui a été diffusée. L'API Attribution Reporting sera intégrée à l'API Protected Audience afin de combiner les données d'enchères du site de l'éditeur et les données de conversion du site de l'annonceur.

Nous concevons une solution plus permanente. Toutefois, vous pouvez utiliser l'API Ads Reporting pour les cadres cloisonnés en tant que mécanisme de transition pour générer un rapport agrégable au niveau des événements avec Attribution Reporting. Notez que ces rapports permettent de mesurer les conversions. Ils sont distincts des rapports sur l'engagement au niveau de l'événement et agrégables générés à partir de la mise aux enchères et du frame de l'annonce. Nous publierons un message explicatif pour proposer une solution plus permanente lorsqu'il sera prêt.

Mécanisme de transition

Lorsque vous enregistrez une balise publicitaire, vous pouvez utiliser le mot clé reserved.top_navigation. Celui-ci ajoute automatiquement l'en-tête Attribution-Reporting-Eligible afin que la balise puisse être enregistrée en tant que source d'attribution.

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

Pour associer des données au niveau de l'événement à la balise que vous avez enregistrée, vous pouvez appeler setReportEventDataForAutomaticBeacons() à partir de la trame cloisonnée avec la charge utile de l'événement.

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

Pour en savoir plus, consultez la section sur l'attribution des rapports de la vidéo d'explication de l'API Ads Reporting.

Exemple de rapport sur l'engagement et les conversions

Dans cet exemple, nous allons l'examiner du point de vue de l'acheteur, qui souhaite associer les données de la mise en concurrence, du cadre publicitaire et du site de conversion.

Dans ce workflow, l'acheteur se coordonne avec le vendeur pour envoyer un identifiant unique à la mise aux enchères. Lors de l'enchère, l'acheteur envoie cet identifiant unique avec les données d'enchères. Au moment de l'affichage et de la conversion, les données du frame cloisonné ou de l'iFrame sont également envoyées avec le même identifiant unique. Par la suite, l'identifiant unique pourra être utilisé pour associer ces rapports.

Procédure :

Avant le début de l'enchère, l'acheteur envoie un identifiant unique au vendeur dans le cadre de sa réponse à l'enchère en temps réel (RTB) programmatique. L'ID peut être défini en tant que variable, par exemple auctionId. L'ID est transmis en tant que perBuyerSignals dans auctionConfig et il devient disponible dans les Worklets de l'acheteur.
Au moment des enchères, l'acheteur peut enregistrer une balise publicitaire à déclencher pendant l'affichage de l'annonce et la conversion (registerAdBeacon()).
1. Pour associer des signaux d'enchères à un événement de frame d'annonce, définissez auctionId comme paramètre de requête de l'URL de la balise.
2. Pour associer des signaux d'enchères à un événement de conversion, définissez auctionId dans l'URL de la balise.
Pendant le délai d'affichage de l'annonce, les balises que vous avez enregistrées au moment des enchères peuvent être déclenchées ou améliorées à l'aide de données au niveau des événements.
1. Déclenchez l'événement de frame avec reportEvent() et transmettez les données au niveau de l'événement.
2. Ajoutez la charge utile au niveau de l'événement à la balise d'attribution avec setReportEventDataForAutomaticBeacons().
3. Enregistrez l'annonce auprès de l'API Attribution Reporting en répondant aux requêtes de balise publicitaire avec l'en-tête Attribution-Reporting-Register-Source.
Au moment de la conversion, vous pouvez déclencher la source que vous avez enregistrée lors des enchères.

Une fois le processus ci-dessus terminé, l'acheteur dispose d'un rapport sur les enchères, d'un rapport sur l'engagement et d'un rapport sur les conversions. Ces données sont regroupées par une seule clé unique pouvant être utilisée pour s'associer les uns aux autres.

Un workflow similaire s'applique à un vendeur s'il a besoin d'accéder aux données d'attribution. Le vendeur peut également utiliser un identifiant unique à envoyer avec registerAdBeacon(). Dans le cadre, l'appel reportEvent() contient une propriété de destination qui peut être utilisée pour envoyer le rapport à l'acheteur et au vendeur. Notez que la SSP doit également être présente sur la page de destination pour que le déclencheur soit attribué à la source.

Agréger les données Protected Audience

L'API Private Aggregation est le mécanisme utilisé pour générer des rapports sur les données Protected Audience afin de générer un rapport récapitulatif, qui est un rapport agrégé bruyant des données collectées dans des buckets. Un bucket est représenté par une clé d'agrégation, et certaines informations peuvent y être encodées.

Par exemple, un événement d'impression d'annonce peut être comptabilisé dans différents segments, chaque segment représentant une campagne publicitaire différente. Un rapport récapitulatif diffère d'un rapport au niveau des événements en ce sens qu'il n'inclut pas d'informations sur chaque événement. Avec un rapport au niveau des événements, vous pouvez déterminer que les utilisateurs A, B et C ont vu la campagne 123. Grâce aux rapports récapitulatifs, vous pouvez mesurer le nombre d'utilisateurs qui ont vu la campagne 123 et du bruit est ajouté pour protéger la confidentialité des utilisateurs.

Pour en savoir plus sur l'API, consultez l'article Private Aggregation.

l'agrégation des signaux d'enchères ;

Vous pouvez agréger les signaux disponibles dans les worklets sur votre serveur à l'aide de l'agrégation privée. Pour l'agrégation des signaux, vous pouvez utiliser la méthode privateAggregation.contributeToHistogram() disponible dans le Worklet d'enchères de l'acheteur, le Worklet d'évaluation du vendeur et les Worklets de création de rapports acheteur/vendeur.

Dans cet exemple, l'enchère gagnante est cumulée dans l'ensemble propriétaire du groupe de centres d'intérêt:

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
}

Il s'agit du mécanisme général à utiliser lorsque les signaux que vous souhaitez agréger ne sont pas associés à des données au niveau des événements et ne sont pas déclenchés par un événement en dehors de l'enchère. Pour en savoir plus sur la création de rapports sur les signaux d'enchères, consultez cette explication.

Agréger les signaux d'enchères avec les données d'événement

Vous pouvez agréger des signaux d'enchères avec des informations limitées sur un événement qui se produit dans un frame d'annonce. Par exemple, vous pouvez agréger le nombre de clics reçus par une annonce pour une campagne en créant un bucket qui représente cette campagne et l'événement de clic. Notez que, à partir du frame de l'annonce, vous pouvez spécifier l'événement qui s'est produit, mais vous ne pouvez pas associer de charge utile au niveau de l'événement.

Pour agréger les signaux d'enchères par événement, vous pouvez utiliser privateAggregation.contributeToHistogramOnEvent(eventType, contribution), qui accepte une chaîne spécifiant le type d'événement et la contribution à enregistrer lorsque cet événement est déclenché. Vous pouvez appeler la méthode avec un type d'événement personnalisé, puis appeler window.fence.reportEvent(eventType) à partir du frame de l'annonce pour déclencher l'envoi du rapport.

Imaginons que vous souhaitiez mesurer le nombre de clics enregistrés par une annonce pour une campagne.

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

Dans la fonction de génération d'enchères, vous pouvez définir un ensemble en combinant l'ID de campagne et l'événement de clic, puis augmenter la valeur de cet ensemble de 1 chaque fois que l'événement est déclenché.

// Ad frame
window.fence.reportEvent('click');

Ensuite, plus tard, à partir du frame de l'annonce, vous pouvez déclencher l'envoi du rapport en appelant reportEvent(eventType):

Pour en savoir plus sur le déclenchement des contributions de l'agrégation privée à partir d'un frame, consultez l'explication.

Créer des rapports sur les performances et les résultats des enchères

Vous pouvez également regrouper les résultats des enchères lorsqu'ils sont déclenchés par un événement d'enchères remportées ou perdues avec contributeToHistogramOnEvent(eventType, contribution) lorsque vous transmettez des mots clés de type d'événement réservé (reserved.win, reserved.loss et reserved.always).

L'agrégation privée fournit une liste de valeurs de base à partir desquelles vous pouvez calculer le bucket et la valeur de votre contribution. Les valeurs de base disponibles pour les résultats de la mise aux enchères sont la valeur de l'enchère de l'annonce gagnante, la valeur de l'enchère obtenue en deuxième position la plus élevée et le motif du refus d'une enchère.

Lorsqu'une valeur de base est fournie, comme le montant de l'enchère gagnante, vous pouvez définir le montant à ajouter ou soustraire de cette valeur, puis générer le rapport final. Par exemple, si l'enchère gagnante de 5 € est fournie comme valeur de base, vous pouvez soustraire votre enchère de 2 € pour calculer la valeur réelle de 3 € de la perte de votre enchère.

Rapports sur les résultats des enchères

Imaginons, par exemple, que vous ayez perdu une enchère et que vous souhaitiez connaître la distance entre votre enchère et le prix d'équilibre des enchères.

Pour connaître le montant de votre enchère perdue, vous pouvez soustraire le prix de votre enchère à celui de l'enchère gagnante:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

Une fois le rapport envoyé, la valeur réelle signalée est la valeur ajustée (baseValue) décalée de la valeur de offset. Pour en savoir plus, consultez cette explication.

Rapports sur les performances

Les acheteurs et les vendeurs peuvent indiquer le temps nécessaire à l'exécution d'un script, ainsi que le temps nécessaire pour extraire les signaux de confiance. Les vendeurs peuvent collecter l'heure de génération des enchères et l'heure du signal d'enchères de confiance de chaque acheteur avec leur autorisation.

Pour en savoir plus, consultez l'explication.

Stocker des signaux d'enchères dans un espace de stockage partagé

Le stockage partagé est un stockage multi-origine non partitionné dans lequel vous pouvez écrire librement, mais il est protégé par des portes lors de la lecture et du traitement des valeurs stockées. L'une des portes disponibles pour l'API Shared Storage est l'agrégation privée. Vous ne pouvez lire les valeurs du stockage partagé qu'à partir d'un worklet, et vous pouvez signaler ces valeurs à l'aide de l'agrégation privée du worklet.

Vous pouvez également écrire sur un espace de stockage partagé à partir des Worklets d'enchères, d'évaluation et de création de rapports de l'API Protected Audience. Vous pourrez ultérieurement enregistrer ces valeurs dans l'espace de stockage partagé sur votre serveur à l'aide de l'agrégation privée . Vous pouvez également utiliser les valeurs enregistrées pour l'opération de sélection d'URL.

À partir d'un worklet d'API Protected Audience, vous pouvez écrire n'importe quelle clé et valeur dans un espace de stockage partagé:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

Par la suite, vous pourrez charger un worklet de stockage partagé pour lire et envoyer cette valeur avec l'agrégation privée:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

Pour en savoir plus sur le stockage partagé, consultez la section sur l'espace de stockage partagé du guide du développeur de rapports de l'API Protected Audience, une explication, une démonstration en direct et le code de démonstration sur GitHub.

Étape suivante

Nous souhaitons discuter avec vous d'une API adaptée à tous les utilisateurs.

Discuter de l'API

Comme d'autres API de la Privacy Sandbox, cette API est documentée et consultée publiquement.

Tester l'API

Vous pouvez tester l'API Protected Audience et y participer.