Memperbarui data audiens dan memuat ulang iklan

Saat membuat audiens kustom, Anda dapat menentukan beberapa atau semua metadata audiens kustom. Informasi ini dapat diteruskan langsung saat membuat objek CustomAudience. CustomAudience.Builder juga mendukung kolom dailyUpdateUri yang dapat menyediakan dan memperbarui metadata. Platform akan menjalankan tugas latar belakang setiap 24 jam untuk mengambil metadata yang diperbarui dari dailyUpdateUri, atau setiap empat jam jika audiens kustom belum memiliki AdData yang diperlukan untuk berpartisipasi dalam lelang. Platform ini dapat mengupdate bagian metadata audiens kustom berikut:

  • Sinyal bidding pengguna
  • Data bidding tepercaya
  • Daftar AdData

Untuk memperbarui metadata ini, proses update latar belakang harian mengajukan kueri terhadap dailyUpdateUri yang ditentukan dalam audiens kustom yang dapat menampilkan respons JSON.

  • Respons JSON mungkin berisi salah satu kolom metadata yang didukung dan perlu diperbarui.
  • Setiap kolom JSON divalidasi secara terpisah. Klien mengabaikan kolom yang rusak, sehingga tidak ada update pada kolom tersebut dalam respons.
  • Respons HTTP kosong atau objek JSON kosong "{}" tidak akan menghasilkan update metadata.
  • Ukuran pesan respons harus dibatasi hingga 10 KB.
  • Semua URI diperlukan untuk menggunakan HTTPS.
  • trusted_bidding_uri harus memiliki ETLD+1 yang sama dengan pembeli.

Contoh: Respons JSON untuk update harian latar belakang

{
    "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
        },
        ...
    ]
}

Lihat definisi server tiruan ini untuk mengetahui contoh jenis data yang mungkin disertakan dalam respons.