Kitle verilerini tanımlama

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

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() öğesini çağırır.

joinAdInterestGroup() için çağrı bağlamının kaynağı, ilgi alanı grubu sahibinin kaynağıyla eşleşmelidir. Bu nedenle, ilgi alanı grubu sahibinin kaynağı geçerli dokümanın kaynağıyla (örneğin, kendi ilgi alanı gruplarına sahip bir web sitesi) eşleşmediği sürece joinAdInterestGroup() öğesinin, iFrame'den (ör. bir TTP'den) çağrılması gerekir.

joinAdInterestGroup(), şu kişilerden izin gerektiriyor:

Bu, dsp.example.com izni olmadan malicious.example ürününün, sahibi olduğu bir ilgi alanı grubu için joinAdInterestGroup() yöntemini çağıramayacağı anlamına gelir.dsp.example.com

Ziyaret edilen sitenin izni

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

Örnek kullanım

Bir ilgi alanı grubunun nasıl tanımlanabileceği ve tarayıcıdan gruba katılmasının nasıl istenebileceğiyle ilgili bir örnek aşağıda verilmiştir.

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 büyük olmamalıdır. Aksi takdirde çağrı başarısız olur. İkinci parametre, ilgi alanı grubunun 30 günle sınırlı süresini belirtir. Art arda yapılan çağrılar, daha önce depolanan değerlerin üzerine yazılır.

Zorunlu özellikler

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

Özellik Örnek Rol
owner https://dsp.example İlgi alanı grubu sahibinin kaynağı.
name custom-bikes İlgi grubunun 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: İş akışında çalışan teklif JavaScript'inin URL'si.
biddingWasmHelperUrl1, 2
Örnek: https://dsp.example/bid/custom-bikes/bid.wasm
Rol: biddingLogicUrl kaynağından alınan WebAssembly kodunun URL'si.
updateUrl2
Örnek: https://dsp.example/bid/custom-bikes/update
Rol: İlgi alanı grubu özelliklerini güncellemek için JSON değerini döndüren URL. (Kitle verilerini güncelleme ve reklamları yenileme bölümünü inceleyin.)
trustedBiddingSignalsUrl2
Örnek: https://dsp.example/trusted/bidding-signals
Rol: Teklif verenin güvenilir Anahtar/Değer Çifti hizmetine yapılan anahtar/değer çifti istekleri için temel URL.
trustedBiddingSignalsKeys
Örnek: ['key1', 'key2' ...]
Rol: Güvenilir Anahtar/Değer Çifti hizmetine yapılan istekler için anahtarlar.
userBiddingSignals
Örnek: {...}
Rol: Öğe sahibinin teklif verme sırasında kullanabileceği ek meta veriler.
ads1
Örnek: [bikeAd1, bikeAd2, bikeAd3]
Rol: Bu ilgi alanı 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 mülkleri isteğe bağlıdır ancak açık artırmaya katılmak için zorunludur. Bu özelliklerin bulunmadığı bir ilgi alanı grubu oluşturmaya yönelik kullanım alanları olabilir. Örneğin, bir ilgi alanı grubu sahibi, henüz yayınlanmayan bir kampanya için veya ileride başka amaçlarla kullanım için bir ilgi alanı grubuna tarayıcı eklemek isteyebilir ya da geçici olarak reklam bütçesi tükenmiş olabilir.

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

Bir ilgi alanı grubuna ilişkin reklamları belirtme

ads ve adComponents nesneleri arasında reklam öğesi URL'si ve isteğe bağlı olarak teklif verme sırasında kullanılabilecek rastgele meta veriler bulunur.

Ö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 alanı grubunu üyelik listesinden kaldırır.

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

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

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

Sık sorulan sorular

Tek bir kullanıcı için grup sahibi başına en fazla kaç ilgi alanı grubu oluşturabilirsiniz?

Chrome sahip başına 1.000 ilgi alanı grubuna ve 1.000 ilgi alanı grubu sahibine izin verir. Bu sınırlar koruma rayları olarak tanımlanmış olup normal çalışma sırasında isabet etmemelidir.

K-anon eşiklerini karşılayan ilgi alanı grubu reklamlarını nasıl en üst düzeye çıkarabilirim?

Herkese açık açıklayıcının belirttiği gibi, tek bir ilgi alanı grubu gösterebileceği birden fazla olası reklam içerebildiğinden, grup "yedek reklam" olarak göstermek üzere başka bir reklamına yeniden teklif verme fırsatına sahip olur. eşiğin altında olduğu her an tercih edebilir. Bu, k-anonimlik eşiğinin altında kalan küçük ve özel bir reklamın yine de açık artırmalara katılmayı seçebileceği ve ilgi alanı grubunun, daha özel olan reklam yeterince geniş bir kitleye sahip olana kadar daha genel bir reklama yönelebileceği anlamına gelir.

Taktiksel açıdan şunları düşünebilirsiniz:

  • Yeni bir reklamın gösterilmeye başlaması için, gösterilmesini istediğiniz durumlarda bu reklamla teklif vermeye başlamanız yeterlidir. Yapmanız gereken başka bir işlem yoktur.
  • Yeni reklamlar k-anon olduğunda kullanabileceğiniz bir yedek reklamınız olabilir. Yedek reklamınızın k-anon olma riski vardır. Bu nedenle bazen yalnızca yedek reklamla teklif vermeyi düşünebilirsiniz. Bu işlemi, zamanın% 1'inde yapabilirsiniz. Örneğin, bu iyi bir seviyeyse yedeğin eşiğin üzerinde kalmasını beklediğinizden emin olun.

Son zamanlarda işlerin ne olduğuyla ilgili birtakım tartışmalar yapıldı. Bu nedenle, bu mekanizmanın sorun oluşturabileceği bir kullanım alanınız varsa API'nin nasıl iyileştirilebileceğiyle ilgili halka açık görüşmelere katılmaya devam edin.

Tüm Protected Audience API referansları

API reference guides are available:

The Protected Audience API explainer also provides detail about feature support and constraints.