Kitle verilerini tanımlama

Protected Audience API'yi kullanarak ilgi alanı grubu oluşturarak kitle tanımlamayı öğ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

joinAdInterestGroup()

Reklamverenin talep tarafı platformu (TTP) veya reklamverenin kendisi, tarayıcıdan tarayıcının üyelik listesine bir ilgi alanı grubu eklemesini istemek için navigator.joinAdInterestGroup() çağrısı yapar.

joinAdInterestGroup() için çağırma bağlamının kaynağı, ilgi grubu sahibinin kaynağıyla eşleşmelidir. Bu nedenle, ilgi grubu sahibinin kaynağı mevcut dokümanın kaynağıyla (ör. kendi ilgi grupları olan bir web sitesi) eşleşmediği sürece joinAdInterestGroup() bir iFrame'den (ör. bir TTP'den) çağrılmalıdır.

joinAdInterestGroup() için aşağıdaki kaynaklardan izin alınması gerekir:

Bu nedenle, malicious.example, dsp.example.com izin vermeden dsp.example.com'ın sahip olduğu bir ilgi grubu için joinAdInterestGroup()'u arayamaz.

Ziyaret edilen siteden alınan izin

İzin, aynı kaynaktan veya kaynaklar arası olarak verilebilir. Varsayılan olarak, ziyaret edilen siteyle aynı kaynaktan gelen joinAdInterestGroup() çağrıları için izin verilir (diğer bir deyişle, geçerli sayfanın üst düzey çerçevesiyle aynı kaynaktan gelen çağrılar için izin verilir).

Örnek kullanım

İlgi grubunun nasıl tanımlanabileceği ve tarayıcıdan gruba katılmasının nasıl istenebileceğine dair bir ö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);

İşleve iletilen interestGroup nesnesinin boyutu 50 KiB'tan fazla olmamalıdır. Aksi takdirde çağrı başarısız olur. İkinci parametre, ilgi alanları grubunun süresini belirtir ve bu süre en fazla 30 gün olabilir. Birbirini takip eden çağrılar, daha önce depolanan değerlerin üzerine yazar.

Zorunlu özellikler

İlgi alanı grupları için yalnızca owner ve name özellikleri zorunludur:

Mülk Örnek Rol
owner https://dsp.example İlgi alanı grubu sahibinin kaynağı.
name custom-bikes İlgi alanının adı.

İsteğe bağlı özellikler

Kalan özellikler isteğe bağlıdır:

biddingLogicUrl1, 2
Örnek: https://dsp.example/bid/custom-bikes/bid.js
Rol: İşlet içinde çalıştırılan teklif verme JavaScript'i için URL.
biddingWasmHelperUrl1, 2
Örnek: https://dsp.example/bid/custom-bikes/bid.wasm
Rol: biddingLogicUrl tarafından çalıştırılan WebAssembly kodu için URL.
updateUrl2
Örnek: https://dsp.example/bid/custom-bikes/update
Rol: İlgi alanı grubu özelliklerini güncellemek için JSON döndüren URL. (Kitle verilerini güncelleme ve reklamları yenileme başlıklı makaleyi inceleyin.)
trustedBiddingSignalsUrl2
Örnek: https://dsp.example/trusted/bidding-signals
Rol: Teklif verenin güvenilir anahtar/değer hizmetine yönelik anahtar/değer istekleri için temel URL.
trustedBiddingSignalsKeys
Örnek: ['key1', 'key2' ...]
Rol: Anahtar/değer güvenilir anahtar/değer hizmetine yapılan isteklerin anahtarları.
userBiddingSignals
Örnek: {...}
Rol: Sahibin teklif verme sırasında kullanabileceği ek meta veriler.
ads1
Örnek: [bikeAd1, bikeAd2, bikeAd3]
Rol: Bu ilgi grubu için oluşturulabilecek reklamlar.
adComponents
Örnek: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]
Rol: Birden fazla parçadan oluşan reklamlar için bileşenler.

1 biddingLogicUrl ve ads özellikleri isteğe bağlıdır ancak açık artırmaya katılmak için gereklidir. Bu özellikler olmadan bir ilgi alanı grubu oluşturmanın kullanım alanları olabilir. Örneğin, bir ilgi alanı grubu sahibi henüz yayınlanmayan bir kampanya veya gelecekteki başka bir kullanım için bir tarayıcıyı ilgi alanı grubuna eklemek isteyebilir ya da geçici olarak reklam bütçesi kalmamış olabilir.

2 Protected Audience API'nin mevcut uygulamasında biddingLogicUrl, biddingWasmHelperUrl, updateUrl ve trustedBiddingSignalsUrl, sahibiyle aynı kaynağa sahip olmalıdır. Bu durum uzun vadeli bir kısıtlama olmayabilir ve ads ile adComponents URL'lerinde böyle bir kısıtlama yoktur.

Bir ilgi alanı grubu için reklam belirtme

ads ve adComponents nesneleri, bir reklam öğesinin URL'sini ve isteğe bağlı olarak teklif verme sırasında kullanılabilecek rastgele meta verileri içerir.

Örneğin:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

leaveAdInterestGroup()

İlgi alanı grubu sahibi, bir tarayıcının ilgi alanı grubundan kaldırılmasını isteyebilir. Tarayıcı, ilgi alanları grubunu üyelik listesinden kaldırır.

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

Kullanıcı, tarayıcıdan ilgi grubu eklemesini isteyen siteye geri dönerse ilgi grubu sahibi, tarayıcıdan ilgi grubunu kaldırmasını istemek için navigator.leaveAdInterestGroup() işlevini çağırabilir.

Bir reklamın kodu, ilgi alanı grubu için bu işlevi de çağırabilir.

Sık sorulan sorular

Tek bir kullanıcı için grup sahibi başına maksimum ilgi alanı grubu sayısı nedir?

Chrome, sahip başına en fazla 1.000 ilgi grubuna ve en fazla 1.000 ilgi grubu sahibine izin verir. Bu sınırlar, normal çalışma sırasında aşılmaması gereken koruma sınırları olarak belirlenmiştir.

How can I maximize interest group ads that meet 𝑘-anon thresholds?

Herkese açık açıklayıcı belgede belirtildiği gibi, tek bir ilgi alanı grubu gösterebileceği birden fazla olası reklam taşıyabildiğinden, en çok tercih edilen seçeneği eşiğin altında olduğunda "yedek reklam" olarak hareket etmek için reklamlarından birine yeniden teklif verme fırsatı elde eder. Bu, 𝑘-anonimlik eşiğinin altında olan küçük ve uzmanlaşmış bir reklamın açık artırmalara katılmaya devam edebileceği ve ilgi alanına dayalı grubunun, daha uzmanlaşmış reklam yeterince büyük bir kitleye ulaşana kadar daha genel bir reklama geri dönme seçeneğinin olduğu anlamına gelir.

Taktiksel açıdan aşağıdaki noktaları göz önünde bulundurabilirsiniz:

  • Yeni bir reklamın gösterilmeye başlaması için, gösterilmesini istediğiniz durumlarda bu reklamla teklif vermeye başlamanız yeterlidir. Başka bir işlem yapmanız gerekmez.
  • Yeni reklamlar 𝑘-anonim olmadığında kullanabileceğiniz bir yedek reklamınız olabilir. Yedek reklamınızın kendisinin 𝑘-anon olmaması gibi bir risk vardır. Bu nedenle, bazen doğrudan yedek reklamla teklif vermeyi düşünebilirsiniz. Örneğin, yedeklemenin eşiğin üzerinde kalmasını sağlamak için iyi bir seviye olduğunu düşünüyorsanız bunu belki de zamanın% 1'inde yapabilirsiniz.

Son zamanlarda, işleyiş şeklinin farklı olabileceği yönünde bazı tartışmalar oldu. Bu nedenle, bu mekanizmanın sorun yaratacağı bir kullanım alanınız varsa API'nin nasıl iyileştirilebileceğiyle ilgili herkese açık tartışmaya katılmaya devam edin.

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.