Aggiornare i dati sul pubblico e gli annunci

Quando crei un segmento di pubblico personalizzato, puoi specificare alcuni o tutti i metadati dei segmenti di pubblico personalizzati. 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 dal dailyUpdateUri o 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 metadati dei segmenti di pubblico personalizzati:

  • Indicatori di offerta per gli utenti
  • Dati di offerte attendibili
  • AdData elenco

Per aggiornare questi metadati, un processo di aggiornamento in background giornaliero esegue query sul dailyUpdateUri definito nel segmento di pubblico personalizzato, che può restituire una risposta in 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 eventuali campi con formato non corretto, il che comporta l'assenza di aggiornamenti per quel determinato campo nella risposta.
  • Una risposta HTTP vuota o un oggetto JSON vuoto "{}" non comporta aggiornamenti dei metadati.
  • Le dimensioni del messaggio di risposta devono essere limitate 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 di server simulato per un esempio del tipo di dati che potrebbe essere incluso nella risposta.