Memperbarui data audiens dan memuat ulang iklan

Pelajari cara memperbarui data audiens dengan mengonfigurasi URL pembaruan untuk grup minat Protected Audience API. Baca panduan developer untuk mengetahui siklus proses lengkap Protected Audience API, dan lihat penjelasan Protected Audience API untuk mengetahui proposal mendetail tentang cara browser merekam grup minat.

Bukan developer? Lihat ringkasan Protected Audience API.

Grup minat Protected Audience API

Grup minat Protected Audience API mewakili sekelompok orang dengan minat yang sama, yang sesuai dengan daftar pemasaran ulang. Setiap grup minat Protected Audience API memiliki pemilik.

Pemilik grup minat bertindak sebagai pembeli dalam lelang iklan Protected Audience API. Keanggotaan grup minat disimpan oleh browser, di perangkat pengguna, dan tidak dibagikan kepada vendor browser atau orang lain.

Fungsi API

Contoh penggunaan

Berikut adalah contoh dari panduan tentang cara menentukan data audiens yang menunjukkan cara membuat grup minat dan meminta browser untuk bergabung ke grup.

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 menyediakan URL yang menampilkan JSON untuk memperbarui atribut grup minat. ID ini harus memiliki origin yang sama dengan owner.

Perbarui atribut

updateUrl menentukan server web yang menampilkan JSON yang menentukan properti grup minat, yang sesuai dengan objek grup minat yang diteruskan ke joinAdInterestGroup().

Hal ini memungkinkan pemilik grup memperbarui atribut grup minat secara berkala. Dalam penerapan saat ini, atribut berikut dapat diubah:

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

Kolom apa pun yang tidak ditentukan dalam JSON tidak akan ditimpa—hanya kolom yang ditentukan dalam JSON yang akan diperbarui—sedangkan memanggil navigator.joinAdInterestGroup() akan menimpa grup minat yang ada.

Update adalah upaya terbaik, dan bisa gagal dalam kondisi berikut:

  • Waktu tunggu permintaan jaringan habis (saat ini 30 detik).
  • Kegagalan jaringan lainnya.
  • Kegagalan penguraian JSON.

Update dibatasi kapasitasnya hingga maksimum satu per hari.

Update dapat dibatalkan jika terlalu banyak waktu yang berdampingan dihabiskan untuk mengupdate, meskipun hal ini tidak memaksakan pembatasan kapasitas pada update yang dibatalkan (sisanya). Update yang gagal karena error jaringan akan dicoba lagi setelah satu jam, dan update yang gagal karena pemutusan koneksi ke internet akan segera dicoba lagi saat terhubung kembali.

Pembaruan manual

Pembaruan pada grup minat yang dimiliki oleh asal frame saat ini dapat dipicu secara manual menggunakan navigator.updateAdInterestGroups().

Pembatasan kapasitas mencegah update terjadi terlalu sering: panggilan berulang ke navigator.updateAdInterestGroups() tidak akan melakukan apa pun hingga periode batas kapasitas (saat ini satu hari) telah berlalu.

Batas kapasitas akan direset jika navigator.joinAdInterestGroup() dipanggil lagi untuk owner dan name grup minat yang sama.

Update otomatis

Semua grup minat yang dimuat untuk lelang diperbarui secara otomatis setelah lelang selesai, tunduk pada batas kapasitas yang sama seperti pembaruan manual.

Untuk setiap pemilik dengan setidaknya satu grup minat yang berpartisipasi dalam lelang, seolah-olah navigator.updateAdInterestGroups() dipanggil dari iframe yang asalnya cocok dengan pemilik tersebut.

Semua referensi Protected Audience API

API reference guides are available:

The Protected Audience API explainer also provides detail about feature support and constraints.