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 mendalam tentang cara browser mencatat 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 contoh dari panduan tentang cara menentukan data audiens yang menunjukkan cara membuat grup minat dan meminta browser untuk bergabung dengan 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. Objek ini harus memiliki asal yang sama dengan owner.

Memperbarui 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 untuk 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 diperbarui—sedangkan memanggil navigator.joinAdInterestGroup() akan menimpa grup minat yang ada.

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

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

Pembaruan dibatasi hingga maksimum satu per hari.

Update dapat dibatalkan jika terlalu banyak waktu berurutan yang dihabiskan untuk mengupdate, meskipun hal ini tidak membatasi kecepatan pada update yang dibatalkan (tersisa). Pembaruan yang gagal karena error jaringan akan dicoba lagi setelah satu jam, dan pembaruan yang gagal karena terputus dari internet akan dicoba lagi segera setelah terhubung kembali.

Pembaruan manual

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

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

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

Update otomatis

Semua grup minat yang dimuat untuk lelang diperbarui secara otomatis setelah lelang selesai, tunduk pada batas frekuensi yang sama dengan update 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

Panduan referensi API tersedia:

Penjelasan Protected Audience API juga memberikan detail tentang dukungan dan batasan fitur.