Kitle verilerini güncelleme ve reklamları yenileme

Protected Audience API ilgi alanı grubu için bir güncelleme URL'si yapılandırarak kitle verilerini nasıl güncelleyeceğinizi öğrenin. Protected Audience API'nin tam yaşam döngüsü için geliştirici kılavuzunu okuyun ve tarayıcıların ilgi alanı gruplarını nasıl kaydettiğine dair ayrıntılı bir teklif için Protected Audience API açıklayıcı belgesine bakın.

Geliştirici değil misiniz? Protected Audience API'ye genel bakış başlıklı makaleyi inceleyin.

Protected Audience API ilgi grupları

Protected Audience API ilgi alanı grubu, yeniden pazarlama listesine karşılık gelen, ortak ilgi alanına sahip bir grup kullanıcıyı temsil eder. Her Protected Audience API ilgi alanı grubunun bir sahibi vardır.

İlgi alanı grubu sahipleri, Protected Audience API reklam açık artırmasında alıcı olarak hareket eder. İlgi grubu üyeliği, tarayıcı tarafından kullanıcının cihazında saklanır ve tarayıcı tedarikçisiyle ya da başka biriyle paylaşılmaz.

API işlevleri

Örnek kullanım

İlgi alanı grubu oluşturmayı ve tarayıcıdan gruba katılmasını istemeyi gösteren, kitle verilerini tanımlama hakkındaki kılavuzda yer alan örneği aşağıda bulabilirsiniz.

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, ilgi alanı grubu özelliklerini güncellemek için JSON döndüren bir URL sağlar. Bu, owner ile aynı kaynağa sahip olmalıdır.

Özellikleri güncelleme

updateUrl, joinAdInterestGroup()'ye iletilen ilgi alanı grubu nesnesine karşılık gelen, ilgi alanı grubu özelliklerini tanımlayan JSON'u döndüren bir web sunucusunu belirtir.

Bu sayede grubun sahibi, ilgi alanları grubunun özelliklerini düzenli olarak güncelleyebilir. Mevcut uygulamada aşağıdaki özellikler değiştirilebilir:

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

JSON'da belirtilmeyen hiçbir alanın üzerine yazılmaz. Yalnızca JSON'da belirtilen alanlar güncellenir. navigator.joinAdInterestGroup() çağrısı ise mevcut tüm ilgi gruplarının üzerine yazar.

Güncellemeler en iyi çabayla yapılır ve aşağıdaki koşullarda başarısız olabilir:

  • Ağ isteği zaman aşımı (şu anda 30 saniye).
  • Diğer ağ hataları.
  • JSON ayrıştırma hatası.

Güncellemeler, günde en fazla bir kez olacak şekilde sıklık sınırına tabidir.

Güncelleme işlemi için çok fazla kesintisiz zaman harcandıysa güncellemeler iptal edilebilir. Ancak bu durum, iptal edilen (kalan) güncellemeler için herhangi bir hız sınırlaması getirmez. Ağ hataları nedeniyle başarısız olan güncellemeler bir saat sonra, internet bağlantısının kesilmesi nedeniyle başarısız olan güncellemeler ise yeniden bağlandıktan sonra hemen tekrar denenir.

El ile güncellemeler

Mevcut çerçeveye ait olan ilgi alanları gruplarındaki güncellemeler, navigator.updateAdInterestGroups() kullanılarak manuel olarak tetiklenebilir.

Hız sınırlaması, güncellemelerin çok sık yapılmasını önler: navigator.updateAdInterestGroups() için tekrarlanan çağrılar, hız sınırı dönemi (şu anda bir gün) geçene kadar herhangi bir işlem yapmaz.

Aynı ilgi alanı grubu owner ve name için navigator.joinAdInterestGroup() tekrar çağrılırsa hız sınırı sıfırlanır.

Otomatik güncellemeler

Bir açık artırma için yüklenen tüm ilgi alanları grupları, açık artırma tamamlandıktan sonra manuel güncellemelerle aynı sıklık sınırlarına tabi olarak otomatik olarak güncellenir.

Bir açık artırmaya katılan en az bir ilgi alanı grubu olan her sahip için, kaynakları bu sahiple eşleşen bir iFrame'den navigator.updateAdInterestGroups() çağrılmış gibi olur.

Tüm Protected Audience API referansları

API referans kılavuzları mevcuttur:

Protected Audience API açıklayıcısı da özellik desteği ve kısıtlamalar hakkında ayrıntılı bilgi sağlar.