Questa pagina è stata tradotta dall'API Cloud Translation.

Report sulle aste dell'API Protected Audience

Misurare i dati e i risultati delle aste dell'API Protected Audience

In questo articolo troverai una panoramica generale dei vari meccanismi disponibili per segnalare i dati sulle aste dell'API Protected Audience al tuo server, insieme ai meccanismi di transizione attualmente disponibili durante la migrazione fino a quando non saranno disponibili soluzioni alternative.

Per generare report su metriche importanti raccolte da un'asta dell'annuncio, l'API Protected Audience funziona con:

Aggregazione privata che raccoglie gli indicatori delle aste e i risultati per generare report di riepilogo.
L'API Ads Reporting per Fenced Frames e iframe, che è un canale all'interno dei frame per comunicare con i worklet dell'API Protected Audience. L'API consente di associare i dati a livello di evento agli indicatori delle aste. I report a livello di evento dell'API Ads Reporting rappresentano un meccanismo di transizione fino a quando non viene progettato un meccanismo di generazione di report più privato.
Report sull'attribuzione, che ti consente di associare i dati sulle conversioni agli indicatori delle aste.
Spazio di archiviazione condiviso, che ti consente di scrivere indicatori delle aste in uno spazio di archiviazione multiorigine e di registrare i dati in un secondo momento utilizzando l'aggregazione privata.

Panoramica dei report dell'API Protected Audience

Flusso di lavoro complessivo di Protected Audience

Esistono tre periodi di tempo principali in cui i dati del flusso di asta dell'API Protected Audience possono essere segnalati al tuo server: il momento in cui viene eseguita l'asta dal sito del publisher, l'ora di rendering in cui l'annuncio viene visualizzato in un frame isolato o un iframe sul sito del publisher e l'ora in cui l'utente esegue un'azione su un altro sito attribuibile all'asta.

Al momento dell'asta, puoi generare report sui dati dell'asta utilizzando i worklet dei report. Durante il tempo di rendering, puoi generare report sui dati sul coinvolgimento da un iframe o da un frame isolato. Durante il periodo di conversione, puoi registrare i dati di attribuzione dalla pagina di destinazione utilizzando l'API Attribution Reporting.

Segnalazioni

Nell'ambito di un'asta, gli acquirenti possono segnalare gli indicatori disponibili nei worklet generateBid() e reportWin(), mentre i venditori possono segnalare gli indicatori disponibili in scoreAd() e reportResult(). Al di fuori di un'asta, gli acquirenti e i venditori possono registrare i dati di un frame che ha visualizzato l'annuncio e del sito da cui è stata effettuata la conversione.

Periodo di tempo	Destinazione	Località	Dati disponibili	API di reporting disponibili
Asta	Responsabile acquisti	`generateBid()`	Indicatori, risultati delle aste e rendimento delle aste	API Private Aggregation
	Responsabile acquisti	`reportWin()`		API Private Aggregation API Ads Reporting
	Venditore	`scoreAd()`		API Private Aggregation
	Venditore	`reportResult()`		API Private Aggregation API Ads Reporting
Rendering	Acquirente / venditore	Frame sul sito del publisher	Dati a livello di evento all'interno del frame dell'annuncio	API Private Aggregation API Ads Reporting
Conversione	Acquirente / venditore	Sito di conversione	Dati a livello di evento e sulle conversioni dal sito delle conversioni	API Attribution Reporting API Private Aggregation API Ads Reporting

Durante ciascuno dei periodi di tempo elencati, acquirenti e venditori avranno accesso a varie API di reporting disponibili per generare report con dati quali indicatori delle aste, dati a livello di evento e dati sulle conversioni.

Dati disponibili in un'asta dell'API Protected Audience

Durante l'asta è possibile generare report da un worklet dell'API Protected Audience per i seguenti dati.

Indicatori

Gli indicatori sono dati contestuali dell'asta, dati utente, dati in tempo reale e dati del browser disponibili per acquirenti e venditori all'interno di un worklet per generare un'offerta, assegnare un punteggio a un annuncio e generare report sui risultati di un'asta.

Indicatore	Descrizione	Imposta posizione	Utenti	Disponibilità
auctionSignals	Dati disponibili nel contesto del luogo in cui si tiene l'asta. Questi dati possono includere informazioni sui contenuti delle pagine, dati utente proprietari e altro ancora.	Impostata dal venditore dal sito del publisher nella configurazione dell'asta.	Acquirente Venditore	generare Punteggio offerta Rapporto annuncioWin reportRisultato
directFromSellerSignals	Gli stessi dati per `auctionSignals`, `perBuyerSignals` e `sellerSignals`, ma con la garanzia che gli indicatori provengano dal venditore specificato.	Impostata tramite intestazioni di risposta HTTP dal venditore	Acquirente Venditore	generare Punteggio offerta Rapporto annuncioWin reportRisultato
browserSignals	Vari dati forniti dal browser (`topWindowHostname`, `interestGroupOwner`, `renderUrl`, `adComponents`, `biddingDurationMsec`, `IGJoinCount`, `IGRecency`, `modelingSignals`).	Impostato dal browser.	Acquirente Venditore	generare Punteggio offerta Rapporto annuncioWin reportRisultato
sellerSignals	Indicatori forniti al venditore per il punteggio degli annunci.	Impostata dal venditore dal sito del publisher nella configurazione dell'asta.	Venditore	punteggioAnnuncio reportWin reportRisultato
trustedScoringSignals	Indicatori in tempo reale forniti al venditore per il punteggio degli annunci.	L'URL viene impostato dal venditore dal sito del publisher nella configurazione dell'asta.	Venditore	punteggioRapporto sull'annuncioRisultato
perBuyerSignals	Dati contestuali dell'asta forniti ad acquirenti specifici. Il venditore può recuperare i valori per gli acquirenti prima dell'inizio dell'asta. Si tratta della conoscenza dell'acquirente dell'opportunità di annuncio.	Impostata dal venditore dal sito del publisher nella configurazione dell'asta.	Responsabile acquisti	generare Punteggio offerta Rapporto annuncioWin reportRisultato
trustedBiddingSignals	Indicatori in tempo reale forniti agli acquirenti per le offerte pubblicitarie.	L'URL viene impostato dall'acquirente dal sito dell'inserzionista quando viene impostato il gruppo di interesse.	Responsabile acquisti	generateBid
userBiddingSignals	Dati utente forniti dall'acquirente.	Impostato dall'acquirente dal sito dell'inserzionista quando viene impostato il gruppo di interesse .	Responsabile acquisti	generateBid

L'oggetto auction config è l'origine principale dei dati forniti per diventare disponibili come indicatori nei worklet. Il publisher e il venditore possono fornire dati contestuali e dati proprietari nella configurazione dell'asta. Questi indicatori possono essere arricchiti con i dati sul gruppo di interesse dell'acquirente, i dati a livello di evento provenienti dal frame di rendering dell'annuncio e i dati di attribuzione dalla pagina di clickthrough. I dati riportati possono essere utilizzati per report su acquirenti/venditori, fatturazione, definizione del budget, addestramento dei modelli ML e altro ancora.

Altri dati disponibili

Dati relativi ai risultati relativi ai dati sulla vittoria e sulla perdita delle aste, ad esempio il prezzo dell'offerta vincente e il motivo del rifiuto dell'offerta.
Dati sul rendimento contenenti informazioni sulla latenza, ad esempio il tempo necessario per recuperare ed eseguire il worklet delle offerte.

Dati disponibili al di fuori di un'asta dell'API Protected Audience

Al di fuori di un'asta dell'API Protected Audience, esistono due periodi di tempo in cui i dati sono disponibili per essere registrati.

Durante il tempo di rendering, quando l'annuncio viene mostrato sul sito del publisher, i dati a livello di evento all'interno dell'iframe o del frame recintato possono essere associati ai dati delle aste dell'API Protected Audience e segnalati al tuo server. I dati a livello di evento di esempio includono l'impressione dell'annuncio, il clickthrough, il passaggio del mouse e qualsiasi altro evento che si verifica all'interno del frame.

Durante la fase di conversione, quando un utente esegue un'azione nella pagina clickthrough a cui viene attribuita nuovamente l'asta, i dati a livello di evento della pagina di conversione possono essere associati ai dati delle aste dell'API Protected Audience e riportati al tuo server.

Report a livello di evento

I report a livello di evento descrivono in dettaglio le informazioni relative a uno o più eventi. Un evento può essere una vittoria dell'asta, un'impressione dell'annuncio o una conversione. Almeno fino al 2026, i report sulle vincite delle aste a livello di evento continueranno a essere disponibili, i frame separati non saranno necessari per il rendering di un annuncio Protected Audience e per i report a livello di evento sarà possibile utilizzare un iframe con accesso alla rete senza limitazioni. Inoltre, l'API Ads Reporting è disponibile in frame e iframe separati che ti consentono di associare i dati sulle aste e sulle conversioni ai dati a livello di evento provenienti dal frame. Questa impostazione è pensata per consentire all'ecosistema di avere un percorso di migrazione più semplice, dato che potrai continuare a utilizzare la tua infrastruttura di reporting esistente almeno fino al 2026 durante la migrazione del tuo sistema a Protected Audience.

Report sulla vittoria dell'asta a livello di evento con `sendReportTo()`

Un meccanismo disponibile per generare report sui dati a livello di evento all'interno di un'asta Protected Audience è il sendReportTo() function su una vittoria dell'asta. La funzione è disponibile nei worklet dei report su acquirente e venditore e il browser invia una richiesta GET alla stringa URL fornita quando inizia il rendering dell'annuncio. Puoi codificare qualsiasi indicatore disponibile nei worklet come parametro di query dell'URL.

Ad esempio, ai fini della fatturazione, un acquirente può segnalare l'importo dell'offerta vincente dal worklet reportWin():

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

La funzione sendReportTo() può essere utilizzata per generare un report sulle vincite per il venditore quando viene chiamato dal giorno reportResult() e un report sulle vincite per l'acquirente quando viene chiamato dal giorno reportWin(). La funzione sendReportTo() è disponibile almeno fino al 2026,

Report Coinvolgimento

Un report sul coinvolgimento contiene i dati a livello di evento provenienti da una creatività dell'annuncio, ad esempio i dati sulle impressioni o sui clic associati agli indicatori dell'asta dell'API Protected Audience che ha visualizzato l'annuncio. Poiché l'annuncio viene visualizzato al termine dell'asta, gli indicatori dell'asta non sono disponibili all'interno del frame che mostra l'annuncio. Per associare questi dati di periodi di tempo diversi, mettiamo a disposizione due meccanismi di transizione per generare report sul coinvolgimento.

La funzione sendReportTo() descritta sopra può essere utilizzata per associare i dati delle aste ai dati a livello di evento da un iframe, ma non funziona per un frame isolato, poiché non è possibile trasmettere un ID univoco dall'incorporamento perché la comunicazione tra quest'ultimo e il frame isolato è limitata. Per associare i dati delle aste ai dati a livello di evento di un annuncio con frame isolato, puoi utilizzare l'API Ads Reporting.

API Ads Reporting per frame e iframe protetti

L'API Ads Reporting per frame e iframe separati ti offre un meccanismo per associare i dati a livello di evento utente provenienti da un frame dell'annuncio a indicatori all'interno di un'asta Protected Audience.

In un worklet dei report dell'API Protected Audience, puoi registrare un beacon pubblicitario con la funzione registerAdBeacon() e trasmettere l'URL del report con gli indicatori aggiunti come parametri di query. Devi specificare anche l'evento personalizzato che vuoi associare all'URL dei report. Poi, in un secondo momento, quando l'annuncio viene visualizzato in un frame isolato, puoi attivare l'evento personalizzato chiamando la funzione window.fence.reportEvent(). I dati disponibili all'interno del frame recintato possono essere aggiunti come payload.

La funzione registerAdBeacon() è disponibile solo nelle funzioni di generazione di report e non è disponibile nella logica di offerta dell'acquirente e nella logica di punteggio del venditore.

Nell'esempio seguente, un ID campagna è associato a un payload a livello di evento con le coordinate di 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']
});

Inoltre, l'API Fenced Frames Ads Reporting sarà disponibile almeno fino al 2026 per gli stessi motivi dei report sulle vincite.

Per un approfondimento più dettagliato, consulta la spiegazione.

Accesso alla rete senza limitazioni

I frame protetti consentono il caricamento delle risorse di rete come farebbe un iframe e potrai inviare dati a livello di evento all'interno di frame protetti al tuo server. Puoi generare report a livello di evento sul lato server in un secondo momento associando i dati a livello di evento di un frame isolato ai dati dell'asta inviati con sendReportTo() che sono stati discussi nella sezione Meccanismo di generazione di report a livello di evento dell'asta sopra.

L'accesso alla rete verrà limitato in un momento successivo al ritiro dei cookie di terze parti.

I meccanismi di generazione di report a livello di evento attualmente presenti nell'API Protected Audience sono meccanismi di transizione e verrà progettata una soluzione alternativa per supportare meglio i casi d'uso esistenti.

Report sull'attribuzione

Il report sull'attribuzione ti consente di associare una conversione su un sito web a un annuncio scelto in un'asta dell'API Protected Audience. Ad esempio, un utente potrebbe fare clic su un annuncio di prodotto che pubblichi, reindirizzato al sito dell'inserzionista, effettuare un acquisto sul sito dell'inserzionista e tu vorresti attribuire l'acquisto all'annuncio che è stato pubblicato. L'API Attribution Reporting verrà integrata con l'API Protected Audience per combinare i dati sulle aste provenienti dal sito del publisher con i dati sulle conversioni provenienti dal sito dell'inserzionista.

Mentre progettiamo una soluzione più permanente, puoi utilizzare l'API Ads Reporting per i frame recintati come meccanismo transitorio per generare un report aggregabile a livello di evento con i report sull'attribuzione. Tieni presente che questi report servono per misurare le conversioni e sono separati dai report sul coinvolgimento aggregabili a livello di evento generati dall'asta e dal frame dell'annuncio. Quando pronto, pubblicheremo un messaggio esplicativo per una soluzione più definitiva.

Meccanismo di transizione

Quando registri un beacon degli annunci, puoi utilizzare la parola chiave reserved.top_navigation, che aggiungerà automaticamente l'intestazione Attribution-Reporting-Eligible affinché il beacon diventi idoneo alla registrazione come origine di attribuzione.

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

Per collegare i dati a livello di evento al beacon registrato, puoi chiamare setReportEventDataForAutomaticBeacons() dal frame isolato con il payload degli eventi.

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

Per scoprire di più, consulta la sezione Attribution Reporting del messaggio esplicativo sull'API Ads Reporting.

Esempio di report sul coinvolgimento e sulle conversioni

In questo esempio, lo esamineremo dal punto di vista dell'acquirente, che è interessato ad associare i dati dell'asta, del frame dell'annuncio e del sito di conversione.

In questo flusso di lavoro, l'acquirente si coordina con il venditore per inviare un ID univoco nell'asta. Durante l'asta, l'acquirente invia questo ID univoco con i dati dell'asta. Durante la fase di rendering e di conversione, anche i dati del frame recintato o dell'iframe vengono inviati con lo stesso ID univoco. In seguito, l'ID univoco può essere utilizzato per associare questi report.

Flusso di lavoro:

Prima che inizi l'asta, l'acquirente invia un ID univoco al venditore come parte della sua risposta all'offerta per le offerte in tempo reale ("RTB") programmatiche. L'ID può essere impostato come una variabile, ad esempio auctionId. L'ID viene trasmesso come perBuyerSignals in auctionConfig e diventa disponibile nei worklet dell'acquirente.
Al momento dell'asta, l'acquirente può registrare un beacon dell'annuncio da attivare durante il rendering dell'annuncio e la fase di conversione (registerAdBeacon()).
1. Per associare gli indicatori delle aste a un evento del frame dell'annuncio, imposta auctionId come parametro di query dell'URL di beaconing.
2. Per associare gli indicatori delle aste per un evento di conversione, imposta auctionId nell'URL di beaconing.
Durante il rendering dell'annuncio, i beacon registrati al momento dell'asta possono essere attivati o migliorati con i dati a livello di evento.
1. Attiva l'evento frame con reportEvent() e trasmetti i dati a livello di evento.
2. Aggiungi il payload a livello di evento al beacon di attribuzione con setReportEventDataForAutomaticBeacons()
3. Registra l'annuncio con l'API Attribution Reporting rispondendo alle richieste di beaconing degli annunci con l'intestazione Attribution-Reporting-Register-Source.
Durante la fase di conversione, puoi attivare l'origine registrata al momento dell'asta.

Dopo la procedura descritta in precedenza, l'acquirente disporrà di un report sull'asta, un report sul coinvolgimento e un report sulle conversioni, tutti collegati tra loro da una singola chiave univoca che può essere utilizzata per l'associazione.

Un flusso di lavoro simile viene applicato a un venditore che ha bisogno di accedere ai dati di attribuzione e può utilizzare un ID univoco anche per l'invio con registerAdBeacon(). Dal frame, la chiamata reportEvent() contiene una proprietà di destinazione che può essere utilizzata per inviare il report sia all'acquirente che al venditore. Tieni presente che la SSP deve essere presente anche nella pagina di destinazione affinché l'attivatore venga attribuito alla sorgente.

Aggregazione dei dati di Protected Audience

L'API Private Aggregation è il meccanismo utilizzato per segnalare i dati di Protected Audience al fine di generare un report di riepilogo, ovvero un report aggregato e con rumore dei dati raccolti nei bucket. Un bucket è rappresentato da una chiave di aggregazione e alcune informazioni possono essere codificate nella chiave.

Ad esempio, un evento di impressione dell'annuncio può essere conteggiato in bucket diversi, in cui ogni bucket rappresenta una campagna pubblicitaria diversa. Un report di riepilogo è diverso da un report a livello di evento in quanto non rivela informazioni su ogni singolo evento. Con un report a livello di evento, puoi determinare che gli utenti A, B e C hanno visualizzato la campagna 123. Con i report di riepilogo, puoi misurare il numero di utenti che hanno visto la campagna 123 e che viene aggiunto rumore per proteggere la privacy degli utenti.

Consulta l'articolo Private Aggregation per saperne di più sull'API.

Aggregazione degli indicatori delle aste

Puoi aggregare gli indicatori disponibili all'interno dei worklet per il tuo server utilizzando l'aggregazione privata. Per l'aggregazione degli indicatori, puoi utilizzare il metodo privateAggregation.contributeToHistogram() disponibile nel worklet delle offerte dell'acquirente, nel worklet del punteggio del venditore e nei worklet dei report per acquirente/venditore.

In questo esempio, l'offerta vincente viene aggregata nel bucket del proprietario del gruppo di interesse:

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

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

Questo è il meccanismo generale da utilizzare quando gli indicatori che vuoi aggregare non sono associati a dati a livello di evento e non sono attivati da un evento al di fuori dell'asta. Per saperne di più su come generare report sugli indicatori delle aste, consulta questo spiegazione.

Aggregare gli indicatori delle aste con i dati sugli eventi

Puoi aggregare gli indicatori delle aste con informazioni limitate su un evento che si verifica in un frame dell'annuncio. Ad esempio, puoi misurare in modo aggregato il numero di clic ricevuti da un annuncio per una campagna creando un bucket che rappresenti la campagna e l'evento di clic. Tieni presente che, dal frame dell'annuncio, puoi specificare quale evento si è verificato, ma non puoi collegare un payload a livello di evento.

Per aggregare gli indicatori delle aste in base agli eventi, puoi utilizzare privateAggregation.contributeToHistogramOnEvent(eventType, contribution) che utilizza una stringa che specifica il tipo di evento e il contributo da registrare quando viene attivato l'evento. Puoi chiamare il metodo con un tipo di evento personalizzato e poi chiamare window.fence.reportEvent(eventType) dal frame dell'annuncio per attivare l'invio del report.

Supponiamo che tu voglia misurare quanti clic ha ricevuto un annuncio per una campagna.

// 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
  });
}

Nella funzione di generazione delle offerte, puoi definire un bucket come combinazione di ID campagna e evento di clic e aumentare il valore del bucket di 1 ogni volta che l'evento viene attivato.

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

Poi, in un secondo momento, dal frame dell'annuncio, puoi attivare l'invio del report chiamando reportEvent(eventType):

Scopri di più su come attivare i contributi per l'aggregazione privata da un frame nella sezione video esplicativo.

Generare report sui risultati delle aste e sul rendimento

Puoi anche aggregare i risultati delle aste quando viene attivato da un evento di vittoria o perdita dell'asta con contributeToHistogramOnEvent(eventType, contribution) quando passi parole chiave di tipo di evento riservato (reserved.win, reserved.loss e reserved.always).

L'aggregazione privata fornisce un elenco di valori base da cui puoi calcolare il bucket e il valore del tuo contributo. I valori di base disponibili per i risultati dell'asta sono il valore dell'offerta dell'annuncio vincente, il valore dell'offerta con un punteggio come il secondo più alto e il motivo per cui un'offerta è stata rifiutata dall'asta.

Quando viene fornito un valore base, ad esempio l'importo dell'offerta vincente, puoi impostare quanto aggiungere o sottrarre da tale valore e poi registrare il valore finale. Ad esempio, se viene indicata l'offerta vincente di 5 € come valore base, puoi sottrarre l'offerta di 2 € per calcolare il valore effettivo di 3 € dell'importo perduto dall'asta.

Report sui risultati delle aste

Esaminiamo un esempio in cui hai perso un'asta e vuoi sapere quanto era distante la tua offerta dal prezzo di compensazione dell'asta.

Per scoprire di quanto hai perso l'asta, puoi sottrarre il prezzo dell'offerta dal prezzo dell'offerta vincente:

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 
    }
  });
}

Quando il report viene inviato, il valore effettivo riportato sarà il valore di baseValue in scala e spostato del valore di offset. Per saperne di più, consulta il spiegatore.

Creazione di report sul rendimento

Gli acquirenti e i venditori possono segnalare il tempo necessario per l'esecuzione di uno script e il tempo necessario per recuperare gli indicatori attendibili. Con la loro autorizzazione, i venditori possono raccogliere la data e l'ora per la generazione delle offerte e l'ora dell'indicatore di offerta attendibile di ogni acquirente.

Per saperne di più, consulta la spiegazione.

Memorizzare gli indicatori delle aste in Spazio di archiviazione condiviso

Lo spazio di archiviazione condiviso è uno spazio di archiviazione multiorigine e non partizionato in cui puoi scrivere liberamente, ma è protetto da limiti durante la lettura e l'elaborazione dei valori archiviati. Una delle porte disponibili per l'API Shared Storage è l'aggregazione privata. Puoi leggere i valori nello spazio di archiviazione condiviso solo dall'interno di un worklet e puoi segnalarli utilizzando l'aggregazione privata dal worklet.

Puoi anche scrivere nello spazio di archiviazione condiviso dai worklet per le offerte, il punteggio e i report dell'API Protected Audience. In seguito, potrai utilizzare l'aggregazione privata per segnalare al server questi valori nello spazio di archiviazione condiviso . Puoi anche utilizzare i valori archiviati per l'operazione di selezione dell'URL.

Da un worklet dell'API Protected Audience, puoi scrivere chiavi e valori nello spazio di archiviazione condiviso:

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

In un secondo momento, puoi caricare un worklet dello spazio di archiviazione condiviso per leggere e inviare quel valore con l'aggregazione privata:

// 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);

Per scoprire di più sull'archiviazione condivisa, consulta la sezione dedicata allo spazio di archiviazione condiviso della guida per gli sviluppatori di reporting dell'API Protected Audience, il programma explainer, la demo dal vivo e il codice demo su GitHub.

Passaggi successivi

Vogliamo interagire con te per assicurarci di creare un'API che funzioni per tutti.

Informazioni sull'API

Come altre API di Privacy Sandbox, questa API è documentata e spiegata pubblicamente.

Sperimenta con l'API

Puoi sperimentare e partecipare alla conversazione sull'API Protected Audience.