Scopri come aggiornare i dati sul pubblico configurando un URL di aggiornamento per un gruppo di interesse dell'API Protected Audience. Leggi la guida per gli sviluppatori per informazioni sull'intero ciclo di vita dell'API Protected Audience e consulta la spiegazione dell'API Protected Audience per una proposta approfondita su come i browser registrano i gruppi di interesse.
Non sei uno sviluppatore? Consulta la panoramica dell'API Protected Audience.
Gruppi di interesse dell'API Protected Audience
Un gruppo di interesse dell'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 proprietari del gruppo di interesse agiscono come acquirente nell'asta dell'annuncio dell'API Protected Audience. L'appartenenza al gruppo di interesse viene memorizzata dal browser sul dispositivo dell'utente e non viene condivisa con il fornitore del browser o con nessun altro.
Funzioni API
Esempio di utilizzo
Ecco l'esempio della guida su come definire i dati sul pubblico, che mostra come creare un gruppo di interesse 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 codice JSON che definisce le proprietà dei gruppi di interesse, corrispondenti all'oggetto gruppo di interesse trasmesso a joinAdInterestGroup().
In questo modo il proprietario del gruppo può aggiornare periodicamente gli attributi del gruppo basato sugli interessi. Nell'implementazione attuale, puoi modificare i seguenti attributi:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
I campi non specificati nel JSON non verranno sovrascritti (vengono aggiornati solo i campi specificati nel JSON), mentre la chiamata a navigator.joinAdInterestGroup() sovrascrive i gruppi di interesse esistenti.
Gli aggiornamenti vengono eseguiti secondo il criterio del "best effort" e possono avere esito negativo se si verificano 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 trascorso troppo tempo contiguo, 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 riprovati dopo un'ora, mentre gli aggiornamenti non riusciti a causa della disconnessione da internet vengono riprovati immediatamente al momento della riconnessione.
Aggiornamenti manuali
Gli aggiornamenti ai gruppi di interesse di proprietà dell'origine del frame corrente possono essere attivati manualmente utilizzando navigator.updateAdInterestGroups().
La limitazione di frequenza impedisce che gli aggiornamenti si verifichino troppo spesso: le chiamate ripetute al numero navigator.updateAdInterestGroups() non comportano alcun effetto finché non è trascorso il periodo di limite di frequenza (attualmente di un giorno).
Il limite di tasso viene reimpostato se navigator.joinAdInterestGroup() viene richiamato di nuovo per lo stesso gruppo di interesse owner e name.
Aggiornamenti automatici
Tutti i gruppi basati sugli interessi caricati per un'asta vengono aggiornati automaticamente al termine dell'asta, soggetti agli stessi limiti di frequenza previsti dagli aggiornamenti manuali.
Per ogni proprietario con almeno un gruppo di interesse che partecipa a un'asta, è come se navigator.updateAdInterestGroups() venga richiamato da un iframe la cui origine corrisponde a quel proprietario.
Tutti i riferimenti dell'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à.