Scopri come aggiornare i dati sul pubblico configurando un URL di aggiornamento per un gruppo basato sugli interessi dell'API Protected Audience. Leggi la guida per gli sviluppatori per conoscere l'intero ciclo di vita dell'API Protected Audience e consulta il messaggio esplicativo dell'API Protected Audience per una proposta approfondita su come i browser registrano i gruppi basati sugli interessi.
Non sei uno sviluppatore? Consulta la panoramica dell'API Protected Audience.
Gruppi basati sugli interessi dell'API Protected Audience
Un gruppo basato sugli interessi dell'API Protected Audience rappresenta un gruppo di persone con un interesse comune, corrispondente a un elenco per il remarketing. Ogni gruppo basato sugli interessi dell'API Protected Audience ha un proprietario.
I proprietari di gruppi di interesse agiscono come acquirente nell'asta dell'annuncio dell'API Protected Audience. L'appartenenza ai gruppi di interesse viene memorizzata dal browser sul dispositivo dell'utente e non viene condivisa con il fornitore del browser né con altri.
Funzioni API
Esempio di utilizzo
Ecco un esempio tratto dalla guida su come definire i dati sul pubblico, che mostra come creare un gruppo basato sugli interessi e chiedere al browser di unirsi al gruppo.
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 fornisce un URL che restituisce JSON per aggiornare gli attributi dei gruppi di interesse. Deve avere la stessa origine di owner.
Aggiorna attributi
updateUrl specifica un server web che restituisce un file JSON che definisce le proprietà del gruppo di interesse, corrispondente all'oggetto gruppo di interesse passato a joinAdInterestGroup().
In questo modo, il proprietario del gruppo può aggiornare periodicamente gli attributi del gruppo basato sugli interessi. Nell'implementazione corrente, è possibile modificare i seguenti attributi:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Tutti i campi non specificati nel file JSON non verranno sovrascritti (solo i campi specificati nel file JSON vengono aggiornati), mentre la chiamata a navigator.joinAdInterestGroup() sovrascrive qualsiasi gruppo di interesse esistente.
Gli aggiornamenti fanno del suo meglio e possono non riuscire se presenti le seguenti condizioni:
- Timeout richiesta di rete (attualmente 30 secondi).
- Altro errore di rete.
- Errore di analisi JSON.
Gli aggiornamenti sono limitati a un massimo di uno al giorno.
Gli aggiornamenti possono essere annullati se è stato speso troppo tempo contiguo per l'aggiornamento, anche se ciò non impone alcuna limitazione di frequenza per gli aggiornamenti annullati (rimanenti). Gli aggiornamenti non riusciti a causa di errori di rete vengono tentati di nuovo dopo un'ora, mentre quelli non riusciti a causa della disconnessione da internet vengono tentati di nuovo immediatamente al momento della riconnessione.
Aggiornamenti manuali
Gli aggiornamenti ai gruppi di interesse appartenenti all'origine del frame corrente possono essere attivati manualmente utilizzando navigator.updateAdInterestGroups().
La limitazione di frequenza impedisce che gli aggiornamenti vengano aggiornati troppo spesso: le chiamate ripetute a navigator.updateAdInterestGroups() non eseguono alcuna azione fino a quando non è trascorso il periodo di limite di frequenza (attualmente un giorno).
Il limite di tasso viene reimpostato se navigator.joinAdInterestGroup() viene richiamato per lo stesso gruppo basato sugli interessi owner e name.
Aggiornamenti automatici
Tutti i gruppi di interesse caricati per un'asta vengono aggiornati automaticamente al termine dell'asta, con gli stessi limiti di frequenza degli aggiornamenti manuali.
Per ogni proprietario con almeno un gruppo di interesse che partecipa a un'asta, è come se navigator.updateAdInterestGroups() venisse chiamato da un iframe la cui origine corrisponde a quel proprietario.
Tutti i riferimenti all'API Protected Audience
Sono disponibili guide di riferimento API:
- Guida per gli sviluppatori relativa all'API Protected Audience.
- Guida per gli acquirenti di annunci ai gruppi di interesse e alla generazione di offerte di Protected Audience.
- Guida per i venditori di annunci alle aste degli annunci di Protected Audience.
- Guida per generare report sui risultati dell'asta
- Best practice per la latenza dell'asta dell'annuncio di Protected Audience
- Risolvere i problemi relativi a Protected Audience
Il messaggio esplicativo dell'API Protected Audience fornisce anche dettagli sul supporto e sui vincoli delle funzionalità.