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ını inceleyin.

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

Protected Audience API ilgi alanı grupları

Protected Audience API ilgi alanı grubu, 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, kullanıcının cihazında depolanır ve tarayıcının sağlayıcısıyla veya başka biriyle paylaşılmaz.

API işlevleri

Örnek kullanım

Bir ilgi alanı grubunun nasıl oluşturulacağını ve tarayıcıdan gruba katılmasının nasıl isteneceğini gösteren kitle verilerinin nasıl tanımlanacağı hakkındaki kılavuzdaki örneği burada 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 öğenin kaynağı owner ile aynı olmalıdır.

Özellikleri güncelleme

updateUrl, joinAdInterestGroup() işlevine iletilen ilgi alanı grubu nesnesine karşılık gelen ilgi alanı grubu özelliklerini tanımlayan JSON değeri döndüren bir web sunucusunu belirtir.

Bu, grup sahibinin ilgi alanı grubunun özelliklerini düzenli olarak güncellemesine olanak tanır. Mevcut uygulamada aşağıdaki özellikler değiştirilebilir:

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

JSON'da belirtilmeyen alanların üzerine yazılmaz. Yalnızca JSON'da belirtilen alanlar güncellenir. navigator.joinAdInterestGroup() çağrısı ise mevcut ilgi alanı gruplarının ü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).
  • Başka bir ağ hatası.
  • JSON ayrıştırma hatası.

Güncellemeler, günde en fazla bir taneyle sınırlandırılmıştır.

Sürekli güncelleme için çok fazla zaman harcanırsa güncellemeler iptal edilebilir. Ancak bu, iptal edilen (kalan) güncellemelere herhangi bir hız sınırlaması getirmez. Ağ hataları nedeniyle başarısız olan güncellemeler bir saat sonra yeniden denenir. İnternet bağlantısı kesildiği için başarısız olan güncellemeler ise yeniden bağlantı kurulduğunda 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ırlama, 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 hiçbir şey yapmaz.

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

Otomatik güncellemeler

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

Açık artırmaya en az bir ilgi alanı grubu katılan her bir 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.