Aggiornare i dati sul pubblico e gli annunci

Quando crei un segmento di pubblico personalizzato, puoi specificare alcuni o tutti i metadati del segmento di pubblico personalizzato. Queste informazioni possono essere trasmesse direttamente durante la creazione di un oggetto CustomAudience. CustomAudience.Builder supporta anche un campo dailyUpdateUri che può fornire e aggiornare i metadati. La piattaforma eseguirà un job in background ogni 24 ore per recuperare i metadati aggiornati da dailyUpdateUri oppure ogni quattro ore se il segmento di pubblico personalizzato non dispone ancora del AdData necessario per partecipare a un'asta. La piattaforma può aggiornare i seguenti elementi dei metadati dei segmenti di pubblico personalizzati:

  • Indicatori di offerta dell'utente
  • Dati delle offerte attendibili
  • AdData elenco

Per aggiornare questi metadati, una procedura di aggiornamento in background giornaliera esegue query su dailyUpdateUri definito nel segmento di pubblico personalizzato, che potrebbe restituire una risposta JSON.

  • La risposta JSON può contenere uno qualsiasi dei campi dei metadati supportati che devono essere aggiornati.
  • Ogni campo JSON viene convalidato in modo indipendente. Il client ignora i campi con errori di formato, pertanto non vengono apportati aggiornamenti a quel particolare campo nella risposta.
  • Una risposta HTTP vuota o un oggetto JSON vuoto "{}" non comporta aggiornamenti dei metadati.
  • La dimensione del messaggio di risposta deve essere limitata a 10 KB.
  • Tutti gli URI devono utilizzare HTTPS.
  • trusted_bidding_uri deve condividere lo stesso ETLD+1 dell'acquirente.

Esempio: risposta JSON per l'aggiornamento giornaliero in background

{
    "user_bidding_signals" : { ... },  // Valid JSON object
    "trusted_bidding_data" : {
        "trusted_bidding_uri" : "example-dsp1-key-value-service.com",
        "trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
    },
    "ads" : [
        {
            "render_uri" : "www.example-dsp1.com/.../campaign123.html",
            "metadata" : { ... }  // Valid JSON object
        },
        {
            "render_uri" : "www.example-dsp1.com/.../campaign456.html",
            "metadata" : { ... }  // Valid JSON object
        },
        ...
    ]
}

Consulta questa definizione del server simulato per un esempio del tipo di dati che potrebbero essere inclusi nella risposta.