Kitle verilerini güncelleyin ve reklamları yenileyin

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 tüm yaşam döngüsü için geliştirici kılavuzunu okuyun ve tarayıcıların ilgi alanı gruplarını nasıl kaydettiği hakkında ayrıntılı bir teklif için Protected Audience API açıklayıcısına bakın.

Geliştirici değil misiniz? Protected Audience API'ye genel bakış sayfasını inceleyin.

Protected Audience API ilgi alanı grupları

Protected Audience API ilgi alanı grubu, bir yeniden pazarlama listesine karşılık gelen, ortak bir ilgi alanına sahip kullanıcı grubunu 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 alanı grubu üyeliği tarayıcı tarafından ve kullanıcının cihazında depolanır, tarayıcının sağlayıcısı veya başka biriyle paylaşılmaz.

API işlevleri

Örnek kullanım

Rehberdeki, bir ilgi alanı grubu oluşturmayı ve tarayıcıdan gruba katılmasını istemeyi gösteren kitle verilerini tanımlama örneğini 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 değerini döndüren bir URL sağlar. Bu, owner ile aynı kaynağa sahip olmalıdır.

Özellikleri güncelle

updateUrl, joinAdInterestGroup() hizmetine iletilen ilgi alanı grubu nesnesine karşılık gelen JSON tanımlayıcı ilgi alanı grubu özelliklerini döndüren bir web sunucusu belirtir.

Bu sayede grup sahibi, ilgi alanı 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. Buna karşılık, navigator.joinAdInterestGroup() çağrısı, mevcut herhangi bir ilgi alanı grubunun üzerine yazılır.

Güncellemeler en iyi sonucu verir ve aşağıdaki koşullarda başarısız olabilir:

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

Güncellemeler, günde en fazla bir kez olacak şekilde sınırlandırılır.

Güncelleme sırasında çok fazla kesintisiz zaman harcanırsa güncellemeler iptal edilebilir. Ancak bu işlem, iptal edilen (kalan) güncellemelere herhangi bir hız sınırlaması uygulamaz. Ağ hataları nedeniyle başarısız olan güncellemeler bir saat sonra yeniden denenir ve internet bağlantısı kesildiğinden dolayı başarısız olan güncellemeler, yeniden bağlandığınızda hemen yeniden denenir.

El ile güncellemeler

Geçerli çerçevenin kaynağına ait ilgi alanı gruplarında yapılan 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, oran sınırı dönemi (şu anda bir gün) sona erene kadar hiçbir şey yapmaz.

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

Otomatik güncellemeler

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

Açık artırmaya en az bir ilgi alanı grubuna katılan her sahip için navigator.updateAdInterestGroups(), kaynağı bu sahiple eşleşen bir iframe'den çağrılır.

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.