Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kitle verilerini tanımlama

Protected Audience API ile bir 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ı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

`joinAdInterestGroup()`

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

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

joinAdInterestGroup() için izin gerekiyor:

Ziyaret edilen site
İlgi alanı grubu sahibi

Diğer bir deyişle, dsp.example.com izin vermeden malicious.example adlı kullanıcının dsp.example.com sahibi olduğu bir ilgi alanı grubu için joinAdInterestGroup() yöntemini çağırması mümkün değildir.

Ziyaret edilen siteden izin

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

Örnek kullanım

Burada, bir ilgi alanı grubunu tanımlamaya ve tarayıcıdan gruba katılmasını istemeye ilişkin bir örnek 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 süresini belirtir (30 günle sınırlıdır). Arka arkaya yapılan aramalar, önceden depolanan değerlerin üzerine yazılır.

Önemli nokta: Protected Audience API yöntemlerinin parametresi olarak kullanılan tüm URL'ler güvenli kaynaklardan olmalıdır: Tüm kaynaklar HTTPS URL'leri üzerinden sunulmalıdır. Yerel geliştirme için HTTPS'nin nasıl kullanılacağı bölümünde, Protected Audience API'yi yerel olarak çalıştırırken bunun nasıl yapılacağı açıklanmıştır. Ayrıca biddingLogicUrl, decisionLogicUrl ve trustedBiddingSignals için X-Allow-FLEDGE: true HTTP yanıt başlığı gerekir.

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 alanı grubunun adı.

İsteğe bağlı özellikler

Geri kalan özellikler isteğe bağlıdır:

biddingLogicUrl^{1, 2}: Örnek: https://dsp.example/bid/custom-bikes/bid.js; Rol: JavaScript'in iş akışında çalışması için teklif verme URL'si.
biddingWasmHelperUrl^{1, 2}: Örnek: https://dsp.example/bid/custom-bikes/bid.wasm; Rol: biddingLogicUrl öğesinden alınan WebAssembly kodu URL'si.
updateUrl²: Ö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.)
trustedBiddingSignalsUrl²: Örnek: https://dsp.example/trusted/bidding-signals; Rol: Teklif verenin güvenilir Anahtar/Değer hizmetine yapılan anahtar/değer çifti istekleri için temel URL.
trustedBiddingSignalsKeys: Örnek: ['key1', 'key2' ...]; Rol: Anahtar/değer güvenilir Anahtar/Değer hizmetine yapılan isteklerin anahtarı.
userBiddingSignals: Örnek: {...}; Rol: Hesap sahibinin teklif verme sırasında kullanabileceği ek meta veriler.
ads¹: Ö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ın bileşenleri.

¹ biddingLogicUrl ve ads mülkleri isteğe bağlıdır ancak açık artırmaya katılmak için zorunludur. Bu özellikler olmadan ilgi alanı grubu oluşturmaya yönelik 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 ilgi alanı grubuna tarayıcı eklemek isteyebilir ya da reklam bütçesi geçici olarak tükenmiş olabilir.

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

Bir ilgi alanı grubu için reklam belirtme

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

Örneğin:

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

`leaveAdInterestGroup()`

İlgi alanı grubu sahibi, tarayıcının bir 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ının bir ilgi alanı grubu eklemesini isteyen siteye geri 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, 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 alanı grubuna ve 1.000 adete kadar ilgi alanı grubu sahibine izin verir. Bu sınırlar normal çalışma sırasında hedeflenmemek üzere koruma önlemleri için verilmiştir.

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

Genel açıklayıcıda belirtildiği gibi, tek bir ilgi alanı grubu gösterebileceği birden fazla olası reklam taşıyabildiğinden, grup, en çok tercih edilen seçimi eşiğin altında kaldığında diğer bir reklamın "yedek reklam" olarak işlev görmesi için başka bir reklam için yeniden teklif verme fırsatına sahip olacaktır. Bu, k-anonimlik eşiğinin altında olan küçük ve özel bir reklamın da açık artırmalara katılmayı tercih edebileceği ve daha özel reklam yeterince geniş bir kitleye sahip olana kadar bu reklama ait ilgi grubunun daha genel bir reklamı tercih edebileceği anlamına gelir.

Taktik açıdan şunları 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. Yapmanız gereken başka bir işlem yoktur.
Yeni reklamlar k-anon olmadığında kullanabileceğiniz bir yedek reklamınız olabilir. Yedek reklamınızın kendisinin k-anon olmaması gibi bir riski vardır, bu nedenle bazen ilk olarak yedek reklamla teklif vermeyi düşünebilirsiniz. Yedeğin eşiğin üzerinde kalmasını beklediğinizden emin olmak için bu seviyeyi tercih ediyorsanız bunu zamanın% 1'inde yapabilirsiniz.

Son zamanlarda, bu mekanizmanın işe yarayabileceği başka yöntemler de tartışıldı. Bu yüzden, bu mekanizmanın sorun çıkaracağı bir kullanım alanınız varsa, API'yı iyileştirebileceği yollar hakkında herkese açık konuşmaya dâhil olmaya devam edin.

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.