Aggiornare i dati sul pubblico e gli annunci

Scopri come aggiornare i dati del pubblico configurando un URL di aggiornamento per un gruppo di interesse dell'API Protected Audience. Leggi la guida per gli sviluppatori per l'intero ciclo di vita dell'API Protected Audience e consulta la spiegazione dell'API Protected Audience per una proposta dettagliata su come i browser registrano i gruppi di interesse.

Non sei uno sviluppatore? Consulta la panoramica dell'API Protected Audience.

Gruppi basati sugli interessi 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 dei gruppi di interesse agiscono come acquirenti nell'asta dell'API Protected Audience. L'appartenenza al gruppo basato sugli interessi viene archiviata dal browser sul dispositivo dell'utente e non viene condivisa con il fornitore del browser o con altri.

Funzioni API

Esempio di utilizzo

Ecco l'esempio della guida su come definire i dati del segmento di pubblico che mostra come creare un gruppo di interesse e chiedere al browser di farne parte.

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 del gruppo di interesse. Deve avere la stessa origine di owner.

Aggiorna attributi

updateUrl specifica un server web che restituisce JSON che definisce le proprietà del gruppo di interesse, corrispondenti 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 attuale, è possibile modificare i seguenti attributi:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

Qualsiasi campo non specificato nel JSON non verrà sovrascritto. Verranno aggiornati solo i campi specificati nel JSON, mentre la chiamata di navigator.joinAdInterestGroup() sovrascrive qualsiasi gruppo di interesse esistente.

Gli aggiornamenti vengono eseguiti al meglio delle possibilità e possono non riuscire nelle seguenti condizioni:

  • Timeout della 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 per l'aggiornamento, anche se ciò non impone alcuna limitazione della velocità per gli aggiornamenti annullati (rimanenti). Gli aggiornamenti non riusciti a causa di errori di rete vengono ritentati dopo un'ora, mentre quelli non riusciti a causa della disconnessione da internet vengono ritentati immediatamente dopo la 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 della frequenza impedisce che gli aggiornamenti vengano eseguiti troppo spesso: le chiamate ripetute a navigator.updateAdInterestGroups() non fanno nulla finché non è trascorso il periodo di limitazione della frequenza (attualmente un giorno).

Il limite di frequenza viene reimpostato se navigator.joinAdInterestGroup() viene chiamato di nuovo per lo stesso gruppo di interesse owner e name.

Aggiornamenti automatici

Tutti i gruppi di interesse caricati per un'asta vengono aggiornati automaticamente al termine dell'asta, in base agli 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 quella del proprietario.

Tutti i riferimenti all'API Protected Audience

Sono disponibili guide di riferimento API:

Il messaggio esplicativo dell'API Protected Audience fornisce anche dettagli sul supporto e sui vincoli delle funzionalità.