Aste degli annunci on-device per pubblicare segmenti di pubblico personalizzati e per il remarketing, senza il monitoraggio di terze parti tra siti.
A chi è destinato questo articolo?
Questo articolo illustra le nozioni di base dell'API Protected Audience e spiega alcune nozioni di base. concetti, ma non scende molto nei dettagli tecnici.
- Se lavori nel settore pubblicitario o di tecnologia pubblicitaria, visualizzerai una panoramica delle come funziona Protected Audience.
- Se sei uno sviluppatore o un ingegnere informatico, il La guida per gli sviluppatori dell'API Protected Audience offre maggiori informazioni e fornire dettagli tecnici approfonditi sull'API. Leggi lo stato più recente delle funzionalità di Protected Audience in attesa.
Consulta il glossario per i termini utilizzati in documentazione di Protected Audience. Alla fine di questo articolo, puoi scoprire come coinvolgere e condividere feedback.
Che cos'è l'API Protected Audience?
L'API Protected Audience è una Privacy Sandbox per gestire casi d'uso di remarketing e segmenti di pubblico personalizzati, progettati in modo da le terze parti non possono monitorare il comportamento di navigazione degli utenti tra i siti.
L'API Protected Audience attiva le aste on-device da parte del browser per scegliere annunci pertinenti da siti web visitati in precedenza dall'utente.
L'API Protected Audience è il primo esperimento a essere implementato in Chromium all'interno del Famiglia di proposte TURTLEDOVE. La le differenze tra Protected Audience e TURTLEDOVE riguardano principalmente la separazione il ruolo on-device di acquirente e venditore dell'annuncio. Le sezioni seguenti spiegano come funziona l'API Protected Audience.
API Protected Audience in un minuto
Per una panoramica più approfondita dell'API Protected Audience, leggi l' Guida per gli sviluppatori dell'API Protected Audience.
![Una panoramica di ogni fase del ciclo di vita dell'API Protected Audience](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/protected-audience-overview.png?authuser=19&hl=it)
L'API Protected Audience utilizza i gruppi di interesse per consentire ai siti di visualizzare annunci pertinenti per gli utenti.
Ad esempio, quando un utente visita un sito che vuole pubblicizzare i suoi prodotti, Il proprietario di un gruppo basato sugli interessi (ad esempio Demand-Side Platform (DSP) può chiedere al browser dell'utente di aggiungere l'appartenenza al gruppo basato sugli interessi. Se la richiesta ha esito positivo, il browser registra:
- Il nome del gruppo di interesse, ad esempio "custom-bikes".
- Il proprietario del gruppo basato sugli interessi, ad esempio "https://dsp.example".
- Informazioni di configurazione del gruppo di interesse per consentire al browser di accedere codice di offerta, codice dell'annuncio e dati in tempo reale, se il proprietario del gruppo è invitato a fare un'offerta in un'asta dell'annuncio.
In seguito, quando l'utente visita un sito con spazio pubblicitario disponibile, il venditore dello spazio pubblicitario
(un fornitore di servizi lato vendite o il sito
stessa) possono utilizzare Protected Audience per eseguire un'asta dell'annuncio e selezionare gli annunci più appropriati
da mostrare all'utente. Il venditore chiama navigator.runAdAuction()
, che fornisce un elenco di proprietari di gruppi di interesse invitati a fare offerte.
Le offerte possono essere fornite solo dai gruppi di interesse di cui il browser è membro e i cui proprietari sono stati invitati a fare offerte.
Il codice di offerta viene recuperato da un URL fornito nella proprietà configurazione. Questo codice fornisce dati sul gruppo di interesse e informazioni fornite dal venditore, oltre a dati contestuali sul pagina e dal browser.
Ogni gruppo basato sugli interessi che fornisce un'offerta è chiamato acquirente.
Quando il browser chiama la funzione per eseguire l'asta dell'annuncio, il codice di ogni acquirente genera un'offerta con l'aiuto dei dati in tempo reale forniti dai propri Servizio chiave/valore Protected Audience. Quindi, il venditore riceve queste offerte, nonché i dati e i punteggi di proprietà del venditore offerta. L'offerta con il punteggio più alto vince l'asta.
L'annuncio vincente viene visualizzato in frame recintata. L'URL della creatività dell'annuncio è specificato nell'offerta e l'origine deve corrispondere a uno in all'elenco fornito dalla configurazione del gruppo di interesse.
Il venditore può segnalare il risultato dell'asta (reportResult()
) e gli acquirenti possono
Segnala i risultati ottenuti (reportWin()
).
Scopri di più sui report sulle aste di Protected Audience.
Perché abbiamo bisogno dell'API Protected Audience?
Comprendere gli interessi degli utenti può consentire la pubblicazione di annunci più pertinenti rispetto alla sola scelta Annunci basati sui contenuti del sito (targeting contestuale) o sull'utilizzo di informazioni forniti da un utente al sito su cui viene visualizzato l'annuncio (targeting per dati proprietari).
Tradizionalmente, le piattaforme pubblicitarie apprendono gli interessi degli utenti monitorandone il comportamento degli utenti tra i siti. I browser hanno bisogno di un modo per consentire alle piattaforme pubblicitarie di selezionare annunci pertinenti, in modo che i publisher di contenuti possano ottenere entrate pubblicitarie senza il monitoraggio delle conversioni.
L'API Protected Audience mira ad avvicinare la piattaforma web a uno stato in cui del browser dell'utente sul suo dispositivo (non dell'inserzionista o delle piattaforme di tecnologia pubblicitaria) informazioni sugli interessi della persona in questione.
Come posso provare l'API Protected Audience?
Nella guida per gli sviluppatori dell'API Protected Audience viene descritta la come usare l'API e come eseguire test localmente.
protected-audience-demo.web.app offre una procedura dettagliata dell'implementazione di base di Protected Audience tra inserzionisti e publisher siti. Il video dimostrativo di Protected Audience spiega come funziona questo codice e mostra un'anteprima. come utilizzare Chrome DevTools per il debug.
Quale configurazione del browser è disponibile?
Gli utenti possono modificare la propria partecipazione alle prove di Privacy Sandbox in Chrome
l'attivazione o la disattivazione dell'impostazione di primo livello in
chrome://settings/adPrivacy
. Durante il test iniziale, gli utenti possono disattivare l'API Protected Audience utilizzando il
Impostazioni di Privacy Sandbox.
Chrome prevede di consentire agli utenti di visualizzare e gestire l'elenco dei gruppi di interesse a cui sono state aggiunte su tutti i siti che hanno visitato. Come per le Norme sulla Tecnologie sandbox, impostazioni utente possono evolversi in base al feedback degli utenti enti regolatori e altri.
Aggiorneremo le impostazioni disponibili in Chrome man mano che l'API Protected Audience procede, in base a test e feedback. In futuro, offriremo impostazioni più granulari per gestire Protected Audience e e i dati associati.
I chiamanti dell'API non possono accedere alle iscrizioni ai gruppi quando gli utenti navigano in modalità di navigazione in incognito e l'appartenenza viene rimossa quando gli utenti cancellano i dati dei loro siti.
Posso disattivare l'API Protected Audience?
Scopri come bloccare l'accesso all'API Protected Audience. come proprietario del sito o come singolo utente.
Concetti fondamentali
Cerchi ulteriori informazioni sulla terminologia di Protected Audience? Consulta le Glossario di Privacy Sandbox.
Che cos'è un gruppo basato sugli interessi?
Un gruppo di interesse relativo all'API Protected Audience rappresenta un gruppo di persone con un interesse comune, corrispondente a un elenco per il remarketing.
Ogni gruppo di interesse dell'API Protected Audience ha un proprietario. I diversi tipi di proprietari creano diversi tipi di gruppi di interesse con casi d'uso differenti.
Il proprietario chiede al browser dell'utente di aggiungere l'appartenenza al suo gruppo basato sugli interessi
chiamando la funzione JavaScript navigator.joinAdInterestGroup()
, fornendo
informazioni quali dati sugli annunci pertinenti al gruppo basato sugli interessi e un URL
per JavaScript usato nelle offerte. I dati dei gruppi di interesse (come gli annunci) possono essere
aggiornato e un gruppo basato sugli interessi può essere attivato per un massimo di 30 giorni.
Tipi di gruppi di interesse
La tabella che segue fornisce esempi di diversi tipi di proprietari e gruppi di interesse dell'API Protected Audience.
Proprietario | Esempio | Interesse | Esempio | Casi d'uso |
---|---|---|---|---|
Inserzionista | Produttore di biciclette | Prodotti | Persone che hanno visualizzato le pagine di prodotto per una determinata categoria di biciclette. | Remarketing per gli utenti che hanno già interagito con il brand. |
Publisher | Sito web di notizie | Contenuti | Persone che leggono il ciclismo. | I publisher possono usare i dati proprietari per consentire agli inserzionisti acquistare annunci pertinenti per i lettori sul loro sito. R gruppo basato sugli interessi di un publisher potrebbe consentire ai publisher di fare lo stesso quando questi utenti navigano su altri siti. I publisher potrebbero essere in grado permette di mostrare gli annunci a segmenti specifici dei loro pubblico. |
Ad tech | DSP | Categoria di prodotti | Persone che hanno mostrato interesse per le attrezzature da ciclismo. | Un'azienda di ad tech può creare e gestire un gruppo basato sugli interessi di persone che ritiene siano disponibili sul mercato per una determinata categoria di articoli. Questo gruppo basato sugli interessi potrebbe quindi essere utilizzato per pubblicizzare i prodotti sui siti che vendono articoli appartenenti a quella categoria (e che lavorano con l'azienda di ad tech). |
Chrome consente fino a 1000 gruppi di interesse per proprietario e fino a 1000 gruppi di interesse proprietari. Questi limiti sono intesi come guard rail, non devono essere raggiunti durante il normale funzionamento.
Che cos'è un acquirente?
Nell'API Protected Audience, un acquirente è una parte che possiede un gruppo di interesse e fa offerte in un'asta dell'annuncio.
Ad esempio:
- Inserzionista: agisce per se stesso.
- Demand-Side Platform (DSP): agisce per gli inserzionisti.
- Proprietario del gruppo di interesse: lavoro per più inserzionisti.
Gli acquirenti hanno tre compiti:
- Scegli se partecipare a un'asta.
- Scegli gli annunci e calcola un'offerta.
- Segnala il risultato dell'asta.
Questi job vengono eseguiti in modo programmatico, nel codice fornito dall'acquirente che viene eseguito durante un'asta dell'annuncio dell'API Protected Audience.
Quando un acquirente chiede al browser di un utente di aggiungere un gruppo di interesse ai gruppi di cui fa parte (chiamando il metodo
funzione JavaScript navigator.joinAdInterestGroup()
), l'acquirente fornisce al browser:
- Un URL per il codice di offerta, che verrà utilizzato quando il venditore esegue un'asta dell'annuncio.
- Possibilmente, URL per le creatività degli annunci per il gruppo di interesse. (possono essere aggiunti URL degli annunci) in seguito con un aggiornamento.
- Un elenco di chiavi di dati su cui eseguire query e l'URL del servizio chiave/valore dell'acquirente. per consentire al codice di offerta di ottenere dati in tempo reale durante un'asta.
Il codice dell'acquirente può anche includere una funzione reportWin()
per segnalare il risultato dell'asta.
Chi esegue un'asta dell'annuncio?
Più parti potrebbero eseguire un'asta per vendere spazio pubblicitario.
Ad esempio:
- Publisher di contenuti: agisce per conto proprio per ospitare i contenuti dell'annuncio sul proprio sito web.
- Supply-Side Platform (SSP): collaborazione con il publisher e fornitura di altri servizi.
- Script di terze parti, che agisce per conto di un publisher, per consentire la partecipazione alle aste dell'annuncio.
Con l'API Protected Audience, un venditore di spazi pubblicitari ha tre job:
- Applicare le regole per i publisher, che stabiliscono quali acquirenti e quali offerte sono idonei.
- Logica di esecuzione dell'asta: esecuzione di JavaScript in worklet per calcolare un punteggio di desiderabilità per ogni offerta.
- Segnala il risultato dell'asta.
Questi lavori vengono eseguiti in modo programmatico, nel codice fornito dal venditore quando avvia un annuncio
richiamando la funzione JavaScript navigator.runAdAuction()
.
Come funziona un'asta dell'annuncio con l'API Protected Audience?
Il seguente diagramma illustra ogni fase di un'asta dell'annuncio dell'API Protected Audience:
![Sei fasi di un'asta dell'annuncio dell'API Protected Audience](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/protected-audience-steps.png?authuser=19&hl=it)
Nell'API Protected Audience, un'asta dell'annuncio è una raccolta di piccoli programmi JavaScript eseguiti dal browser dispositivo per scegliere un annuncio. Per tutelare la privacy, viene eseguito tutto il codice dell'asta dell'annuncio del venditore e degli acquirenti in worklet JavaScript isolati che non possono comunicare con il mondo esterno.
Un venditore (un publisher o una Supply-Side Platform) avvia un'asta dell'annuncio Protected Audience su un sito che vende spazio pubblicitario, ad esempio un sito sito). Il venditore sceglie gli acquirenti che partecipano all'asta indica quale spazio è in vendita e fornisce criteri aggiuntivi per l'annuncio. Ogni acquirente rappresenta proprietario di un gruppo basato sugli interessi.
Il venditore fornisce al browser il codice per assegnare un punteggio alle offerte, che include il valore di ciascuna offerta, creatività dell'annuncio e altri dati restituiti da ciascun acquirente. Durante l'asta, le offerte degli acquirenti e il codice per il punteggio delle offerte del venditore può ricevere dati dai loro Servizi chiave/valore. Dopo aver scelto un annuncio visualizzate (in un frame recintato per mantenere privacy), il venditore e l'acquirente vincente possono segnalare il risultato dell'asta.
- Un utente visita un sito che visualizza annunci.
- Il codice del venditore avvia un'asta. Il venditore specifica quale spazio pubblicitario per la vendita e chi può fare offerte, nonché un metodo per assegnare un punteggio a tali offerte.
- Il codice dell'acquirente invitato viene eseguito per generare un'offerta, un URL per un annuncio pertinente creatività e altri dati. Lo script di offerta può eseguire query per ottenere dati in tempo reale, ad esempio il budget residuo della campagna, dal valore-chiave/valore dell'acquirente Google Cloud.
- Il codice del venditore assegna un punteggio a ciascuna offerta e seleziona un vincitore. Questa logica utilizza valore dell'offerta e altri dati per restituire l'attrattiva di un'offerta e rifiutare un annuncio che è in grado di battere il vincitore dell'annuncio contestuale. Il venditore può utilizzare i propri Servizio chiave/valore per dati in tempo reale. Prima del giorno inizia un'asta, il venditore trova il miglior annuncio contestuale area annuncio.
- L'annuncio vincente viene restituito come oggetto di configurazione del frame recintato quando nella configurazione dell'asta viene impostato il flag
resolveToConfig
. La configurazione viene utilizzata per indirizzare il frame recintato alla creatività dell'annuncio e l'URL della creatività viene nascosto sia dal venditore sia dal publisher. Se il flagresolveToConfig
è impostato sufalse
o non viene trasmesso, l'annuncio vincente viene restituito come una URN opaca che può essere utilizzata per visualizzare l'annuncio in un iframe. L'oggetto di configurazione del frame recintato è disponibile a partire dalla versione M114. - L'asta viene segnalata al venditore e agli acquirenti vincitori.
È in discussione un meccanismo di segnalazione per la perdita di acquirenti.
Che cos'è un servizio chiave/valore dell'API Protected Audience?
Il servizio chiave/valore dell'API Protected Audience consente ai tecnici pubblicitari di eseguire query sui dati in tempo reale quando viene fatta un'offerta dall'acquirente e ai venditori di assegnare un punteggio agli annunci nel rispetto della privacy. Puoi trovare informazioni sul servizio chiave/valore dell'API Protected Audience e altro ancora in Servizi dell'API Protected Audience.
Il servizio chiave/valore viene distribuito nell'infrastruttura cloud della tecnologia pubblicitaria e il servizio viene eseguito in un ambiente di esecuzione affidabile. Una richiesta a un servizio chiave/valore non può comportare la registrazione a livello di evento o avere altri effetti collaterali. Il servizio chiave/valore supporterà anche le funzioni definite dall'utente che consentono ai tecnici pubblicitari di eseguire la propria logica personalizzata all'interno del servizio chiave/valore.
Un acquirente o un venditore fornisce un elenco di "chiavi" per specificare i dati richiesti da un servizio chiave/valore dell'API Protected Audience. Il servizio chiave/valore risponde con un valore per ogni chiave.
Il codice del servizio chiave/valore dell'API Protected Audience è ora disponibile in un repository GitHub di Privacy Sandbox. Questo servizio può essere utilizzato dagli sviluppatori di Chrome e Android.
Scopri di più sul servizio chiave/valore dell'API Protected Audience dal Messaggio esplicativo API e la spiegazione del modello di attendibilità.
Come vengono incorporati i dati in tempo reale nelle aste?
Gli acquirenti o il venditore in un'asta dell'annuncio potrebbero dover accedere ai report e i dati di Google Cloud. Ad esempio, gli acquirenti potrebbero voler calcolare il budget rimanente in una campagna pubblicitaria oppure il venditore potrebbe essere tenuto a controllare le creatività degli annunci per verificare che rispettino le norme per i publisher.
Per soddisfare i requisiti di privacy dell'API Protected Audience, i dati in tempo reale richiesti durante un'asta dell'annuncio sono forniti dal servizio chiave/valore. Quando ogni acquirente chiama navigator.joinAdInterestGroup()
, specifica un URL del servizio chiave/valore e specifica le chiavi da interrogare al servizio durante un'asta. Allo stesso modo, quando il venditore esegue un'asta dell'annuncio chiamando navigator.runAdAuction()
, il venditore fornisce un URL per il suo servizio chiave/valore. Verrà eseguita una query al servizio chiave/valore del venditore con l'URL di rendering della creatività.
Per il test iniziale, viene utilizzato il modello "Bring Your Own Server". A lungo termine, i tecnici pubblicitari dovranno utilizzare i servizi chiave/valore open source dell'API Protected Audience in esecuzione in ambienti di esecuzione attendibili per recuperare dati in tempo reale.
Per garantire che l'ecosistema abbia tempo sufficiente per i test, non prevediamo di richiedere l'utilizzo di servizi chiave/valore open source o di ambienti di esecuzione attendibili fino a un po' di tempo dopo il ritiro dei cookie di terze parti. Daremo agli sviluppatori un preavviso significativo per iniziare i test e l'adozione prima che avvenga questa transizione.
Come vengono utilizzati i dati proprietari in un'asta Protected Audience?
I dati proprietari sono dati di proprietà del sito sui suoi utenti. Ad esempio, se un utente ha specificato il suo colore preferito sul sito dell'inserzionista o del publisher, quel colore è considerato dati proprietari.
In un'asta Protected Audience, l'inserzionista può utilizzare i propri dati proprietari per determinare l'appartenenza al gruppo di interesse dell'annuncio e anche trasmettere i dati al gruppo basato sugli interessi come userBiddingSignals
. I dati proprietari dell'inserzionista saranno disponibili solo per gli acquirenti durante la fase di generazione dell'offerta e non sono disponibili per i venditori.
Ad esempio, se l'inserzionista conosce il colore preferito dell'utente, il valore può essere impostato nella configurazione del gruppo di interesse su userBiddingSignals
quando l'utente viene aggiunto a un gruppo di interesse:
const interestGroup = {
owner: 'https://example-buyer.com',
name: 'running-shoes',
userBiddingSignals: {
favoriteColor: 'blue' // First-party data
},
// ...other interest group settings
};
navigator.joinAdInterestGroup(interestGroup, 3600);
Il publisher può anche trasferire i dati proprietari impostando gli indicatori nella configurazione delle aste quando avvia l'asta e può controllare chi riceve i dati proprietari. Quando un publisher trasmette i dati proprietari come auctionSignals
, questi sono disponibili sia per gli acquirenti sia per i venditori. Quando i dati vengono trasmessi come sellerSignals
, sono disponibili solo per il venditore, mentre, se trasmessi come perBuyerSignals
, sono disponibili solo per gli acquirenti specificati. Il publisher può anche trasferire i dati proprietari alle aste dei componenti. Il publisher e i partecipanti all'asta devono prima accordarsi su quali dati proprietari devono essere condivisi e su come devono essere formattati.
L'esempio seguente descrive in che modo il publisher può trasferire i dati proprietari a vari partecipanti all'asta:
const auctionConfig = {
seller: 'https://example-seller.com',
auctionSignals: {
favoriteColor: 'blue', // Both buyer and seller will receive this signal
},
sellerSignals: {
favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
},
perBuyerSignals: {
'https://example-buyer.com': {
favoriteDrink: 'tea', // Only a specific buyer will receive this signal
},
},
// The same pattern applies to the component auction
componentAuctions: [{
seller: 'https://example-component-seller.com',
auctionSignals: { ... },
sellerSignals: { ... },
perBuyerSignals { ... }
}],
// ...other auction settings
};
navigator.runAdAuction(auctionConfig);
Scopri di più
Per una panoramica più approfondita dell'API Protected Audience, leggi l' Guida per gli sviluppatori dell'API Protected Audience.
Sviluppatori
Se vuoi iniziare a utilizzare l'API Protected Audience, leggi sperimentare e partecipare.
Abbiamo scritto una guida per gli sviluppatori di API e creato una demo dell'API Protected Audience, che offre una procedura dettagliata del deployment di base dell'API Protected Audience. Il video dimostrativo dell'API Protected Audience spiega come funziona il codice demo e come utilizzare Chrome DevTools per il debug dell'API Protected Audience.
Interagisci e condividi il feedback
- GitHub: leggi la spiegazione, sollevare domande e seguire la discussione.
- Comunicazioni: partecipa o visualizza gli annunci precedenti nella mailing list dell'API Protected Audience.
- W3C: illustra i casi d'uso del settore nel corso Improving Web Advertising Business. Raggruppa.
- Assistenza per gli sviluppatori: poni domande sull'implementazione e sulle best practice o partecipa alle discussioni sul Repository di assistenza per gli sviluppatori di Privacy Sandbox.
- Implementazione attuale: per domande sull'implementazione di Protected Audience da parte di Chrome, segnala un bug di Chromium.