Memperbarui data audiens dan memperbarui 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 mendapatkan 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, sesuai dengan daftar pemasaran ulang. Setiap grup minat Protected Audience API memiliki pemilik.

Pemilik grup minat bertindak sebagai pembeli di 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 menampilkan 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. Nama ini harus memiliki origin 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 implementasi saat ini, atribut berikut dapat diubah:

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

Kolom 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 sudah ada.

Pembaruan 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 kapasitasnya hingga maksimum satu per hari.

Update dapat dibatalkan jika terlalu banyak waktu yang berdekatan yang dihabiskan untuk mengupdate, meskipun hal ini tidak menerapkan pembatasan kapasitas pada update yang dibatalkan (sisa). Update yang gagal karena error jaringan akan dicoba lagi setelah satu jam, dan update yang gagal karena koneksi internet terputus akan langsung 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 melakukan apa pun hingga periode batas kapasitas (saat ini satu hari) berlalu.

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

Update otomatis

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

Untuk setiap pemilik yang memiliki setidaknya satu grup minat yang berpartisipasi dalam lelang, navigator.updateAdInterestGroups() seakan-akan 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.