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 için geliştirici kılavuzu.
- Korunan Kitle ilgi alanı grupları ve teklif oluşturma ile ilgili reklam alıcı rehberi.
- Korunan Kitle reklam açık artırmaları ile ilgili reklam satıcısı kılavuzu.
- Açık artırma sonuçlarını raporlama kılavuzu
- Korunan Kitle için en iyi uygulamalar reklam açık artırması gecikmesi
- Korunan Kitle ile ilgili sorunları giderme
Protected Audience API açıklayıcısı da özellik desteği ve kısıtlamalar hakkında ayrıntılı bilgi sağlar.