Protected Audience API'ye genel bakış

Siteler arası üçüncü taraf izleme olmadan yeniden pazarlama ve özel kitlelere reklam yayınlamak için cihaz üzerinde reklam açık artırmaları.

Bu belge kimler için hazırlanmıştır?

Bu belgede Protected Audience API'nin temel özellikleri ele alınmakta ve bazı temel kavramlar açıklanmaktadır ancak teknik ayrıntılara çok fazla girilmemektedir.

Protected Audience belgelerinde kullanılan terimler için sözlüğe bakın. Bu belgenin sonunda, etkileşim kurma ve geri bildirim paylaşma hakkında bilgi edinebilirsiniz.

Protected Audience API nedir?

Protected Audience API, yeniden pazarlama ve özel kitle kullanım alanlarına hizmet etmek için kullanılan bir Privacy Sandbox teknolojisidir. Üçüncü tarafların kullanıcıların sitelerdeki tarama davranışlarını izleyememesi için tasarlanmıştır.

Protected Audience API, kullanıcının daha önce ziyaret ettiği web sitelerinden alakalı reklamları seçmek için tarayıcı tarafından cihaz üzerinde açık artırmalar düzenlenmesini sağlar.

Protected Audience API, TURTLEDOVE teklif ailesinde Chromium'da uygulanan ilk denemedir. Protected Audience ile TURTLEDOVE arasındaki fark, öncelikle reklam alıcısının ve satıcısının cihaz üzerindeki rolünün ayrılmasıyla ilgilidir. Aşağıdaki bölümlerde Protected Audience API'nin nasıl çalıştığı açıklanmaktadır.

Bir dakikada Protected Audience API

Protected Audience API'ye daha ayrıntılı bir genel bakış için Protected Audience API geliştirici kılavuzunu inceleyin.

Protected Audience API yaşam döngüsünün her aşamasına genel bakış
Protected Audience API yaşam döngüsü.

Protected Audience API, sitelerin kullanıcılarıyla alakalı reklamlar göstermesini sağlamak için ilgi alanı gruplarını kullanır.

Örneğin, bir kullanıcı ürünlerinin reklamını yapmak isteyen bir siteyi ziyaret ettiğinde ilgi alanı grubu sahibi (ör. talep tarafı platformu (TTP)), kullanıcının tarayıcısından ilgi alanı grubuna üyelik eklemesini isteyebilir. İstek başarılı olursa tarayıcı şunları kaydeder:

  • İlgi alanları grubunun adı: Örneğin, "custom-bikes".
  • İlgi grubunun sahibi: Örneğin, "https://dsp.example".
  • Grup sahibi bir reklam açık artırmasında teklif vermeye davet edilirse tarayıcının teklif kodu, reklam kodu ve anlık verilere erişmesine izin vermek için ilgi alanı grubu yapılandırma bilgileri.

Daha sonra kullanıcı, reklam alanı bulunan bir siteyi ziyaret ettiğinde reklam alanı satıcı (satış tarafı sağlayıcı (STP) veya sitenin kendisi), kullanıcıya gösterilecek en uygun reklamları seçmek için Protected Audience'ı kullanarak reklam açık artırması yapabilir. Satıcı, teklif vermeye davet edilen ilgi alanı grubu sahiplerinin listesini sağlayan navigator.runAdAuction() işlevini çağırır.

Teklifler yalnızca tarayıcının üyesi olduğu ve sahipleri teklif vermeye davet edilmiş ilgi alanına dayalı gruplar tarafından sağlanabilir.

Teklif kodu, ilgi alanları grubunun yapılandırmasında sağlanan bir URL'den alınır. Bu kod, ilgi grubu ve satıcıdan alınan bilgilerle birlikte sayfa ve tarayıcıyla ilgili bağlamsal veriler sağlar.

Teklif veren her ilgi alanı grubu alıcı olarak bilinir.

Tarayıcı, reklam açık artırmasını çalıştırmak için işlevi çağırdığında her alıcının kodu, Protected Audience Anahtar/Değer hizmeti tarafından sağlanan gerçek zamanlı veriler yardımıyla bir teklif oluşturur. Ardından satıcı, bu tekliflerin yanı sıra satıcıya ait anlık verileri de alır ve her teklifi puanlar. En yüksek puana sahip teklif açık artırmayı kazanır.

Kazanan reklam, sınırlı çerçeve içinde gösterilir. Reklam öğesinin URL'si teklifte belirtilir ve kaynak, ilgi alanı grubunun yapılandırması tarafından sağlanan listedeki bir kaynakla eşleşmelidir.

Satıcı, açık artırma sonucunu (reportResult()) bildirebilir ve alıcılar kazandıkları açık artırmaları (reportWin()) bildirebilir.

Protected Audience açık artırma raporları hakkında bilgi edinin.

Protected Audience API'ye neden ihtiyacımız var?

Kullanıcıların ilgi alanlarını anlamak, yalnızca site içeriğine (içeriğe dayalı hedefleme) göre reklam seçmek veya bir kullanıcı tarafından reklamın göründüğü siteye sağlanan bilgileri (birinci taraf verileri hedefleme) kullanmaktan daha alakalı reklamlar yayınlamanızı sağlayabilir.

Geleneksel olarak reklam platformları, kullanıcıların sitelerdeki davranışlarını izleyerek ilgi alanları hakkında bilgi edinir. Tarayıcıların, reklam platformlarının alakalı reklamlar seçmesine olanak tanıması gerekir. Böylece içerik yayıncıları, siteler arası izleme olmadan reklam geliri elde edebilir.

Protected Audience API, web platformunu kullanıcının cihazındaki tarayıcının (reklamveren veya reklam teknolojisi platformları değil) kullanıcının ilgi alanları hakkında bilgi sahibi olduğu bir duruma yaklaştırmayı amaçlar.

Protected Audience API'yi nasıl deneyebilirim?

  • Protected Audience API geliştirici kılavuzunda, API'nin nasıl kullanılacağı ve yerel olarak nasıl test edileceği açıklanmaktadır.

  • protected-audience-demo.web.app, reklamveren ve yayıncı sitelerinde temel bir Protected Audience dağıtımının adım adım açıklamasını sağlar. Protected Audience demo videosunda bu kodun nasıl çalıştığı açıklanmakta ve hata ayıklama için Chrome Geliştirici Araçları'nın nasıl kullanılacağı önizlenmektedir.

Hangi tarayıcı yapılandırması kullanılabilir?

Kullanıcılar, Chrome'daki Özel Korumalı Alan denemelerine katılımlarını chrome://settings/adPrivacy üst düzey ayarını etkinleştirerek veya devre dışı bırakarak ayarlayabilir. İlk test aşamasında kullanıcılar, Özel Korumalı Alan ayarlarını kullanarak Protected Audience API'nin kapsamı dışında kalabilir.

Chrome, kullanıcıların ziyaret ettikleri sitelerde eklendikleri ilgi alanı gruplarının listesini görmesine ve yönetmesine izin vermeyi planlıyor. Özel Korumalı Alan teknolojilerinde olduğu gibi, kullanıcı ayarları da kullanıcılardan, düzenleyici kurumlardan ve diğer taraflardan gelen geri bildirimlere göre değişebilir.

Protected Audience API'de ilerleme kaydedildikçe Chrome'daki mevcut ayarları testlere ve geri bildirimlere göre güncelleyeceğiz. Gelecekte Protected Audience ve ilişkili verileri yönetmek için daha ayrıntılı ayarlar sunacağız.

Kullanıcılar Gizli modda gezinirken API çağıranlar grup üyeliğine erişemez ve kullanıcılar site verilerini temizlediğinde üyelik kaldırılır.

Protected Audience API'nin kapsamı dışında kalabilir miyim?

Site sahibi veya bireysel kullanıcı olarak Protected Audience API'ye erişimi nasıl engelleyeceğinizi öğrenin.

Temel kavramlar

Protected Audience terminolojisi hakkında daha fazla bilgi mi arıyorsunuz? Özel Korumalı Alan sözlüğüne bakın.

İlgi alanı grubu nedir?

Protected Audience API ilgi alanı grubu, ortak bir ilgi alanına sahip kişilerden oluşan bir grubu temsil eder ve yeniden pazarlama listesine karşılık gelir.

Her Protected Audience API ilgi alanı grubunun bir sahibi vardır. Farklı türdeki sahipler, farklı kullanım alanlarına sahip farklı türde ilgi alanları grupları oluşturur.

Sahip, JavaScript işlevi navigator.joinAdInterestGroup()'yı çağırarak, ilgi grubuyla alakalı reklamlar hakkındaki veriler ve teklif vermede kullanılan JavaScript'in URL'si gibi bilgileri sağlayarak kullanıcının tarayıcısından ilgi grubuna üyelik eklemesini ister. İlgi grubu verileri (ör. reklamlar) güncellenebilir ve bir ilgi grubu en fazla 30 gün boyunca etkinleştirilebilir.

İlgi alanı grubu türleri

Aşağıdaki tabloda, farklı Protected Audience API ilgi alanı grubu türleri ve sahipleriyle ilgili örnekler verilmiştir.

Sahip Örnek İlgi Örnek Kullanım alanları
Reklamveren Bisiklet üreticisi Ürünler Belirli bir bisiklet kategorisine ait ürün sayfalarını görüntüleyen kullanıcılar. Markayla daha önce etkileşimde bulunmuş kullanıcılara yeniden pazarlama
Yayıncı Haber web sitesi İçerik Bisiklet hakkında okuma yapan kullanıcılar Yayıncılar, reklamverenlerin sitelerindeki okuyucularla alakalı reklamlar satın almasını sağlamak için birinci taraf verilerini kullanabilir. Yayıncıya ait bir ilgi grubu, bu kullanıcılar diğer sitelerde gezinirken bile yayıncıların aynı işlemi yapmasına olanak tanıyabilir. Yayıncılar, kitlelerinin belirli segmentlerine reklam gösterme özelliği için ücret talep edebilir.
Reklam teknolojileri DSP Ürün kategorisi Bisiklet ekipmanlarıyla ilgilenen kullanıcılar Bir reklam teknolojisi şirketi, belirli bir ürün kategorisiyle ilgilendiğini düşündüğü kullanıcılardan oluşan bir ilgi alanı grubu oluşturup yönetebilir. Bu ilgi alanı grubu, söz konusu kategorideki ürünleri satan sitelerde (ve reklam teknolojisi şirketiyle çalışan) ürünlerin reklamını yapmak için kullanılabilir.

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.

Alıcı nedir?

Protected Audience API'de alıcı, ilgi alanı grubunun sahibi olan ve reklam açık artırmasında teklif veren taraftır.

Örneğin:

  • Reklamveren: Kendisi adına hareket eden.
  • Talep tarafı platformu (TTP): Reklamverenler adına hareket eder.
  • İlgi alanı grubu sahibi: Birden fazla reklamveren için çalışır.

Alıcıların üç görevi vardır:

  • Bir açık artırmaya katılıp katılmayacağınızı seçin.
  • Reklamları seçin ve teklif hesaplayın.
  • Açık artırma sonucunu bildirin.

Bu işlemler, Protected Audience API reklam açık artırması sırasında çalıştırılan, alıcı tarafından sağlanan kodda programatik olarak yapılır.

Bir alıcı, kullanıcının tarayıcısından üyesi olduğu gruplara bir ilgi alanı grubu eklemesini istediğinde (navigator.joinAdInterestGroup() JavaScript işlevini çağırarak) tarayıcıya şunları sağlar:

Alıcının kodu, açık artırma sonucunu bildirmek için reportWin() işlevini de içerebilir.

Reklam açık artırmasını kim düzenler?

Reklam alanı satmak için açık artırma düzenleyebilecek birden fazla taraf vardır.

Örneğin:

  • İçerik yayıncısı: Web sitesinde reklam içeriği barındırmak için kendi adına hareket eder.
  • Arz tarafı platformu (STP): Yayıncıyla çalışır ve başka hizmetler sunar.
  • Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılımı sağlamak için bir yayıncı adına hareket eder.

Protected Audience API ile bir reklam alanı satıcısının üç görevi vardır:

  • Yayıncı kurallarını zorunlu kılma: Hangi alıcıların ve hangi tekliflerin uygun olduğunu belirtir.
  • Açık artırma mantığını çalıştırma: Her teklif için bir uygunluk puanı hesaplamak üzere işletim birimlerinde çalıştırılan JavaScript.
  • Açık artırma sonucunu bildirin.

Bu işler, satıcı navigator.runAdAuction() JavaScript işlevini çağırarak bir reklam açık artırması başlattığında sağlanan kodda programatik olarak yapılır.

Protected Audience API reklam açık artırması nasıl çalışır?

Aşağıdaki şemada, Protected Audience API reklam açık artırmasının her aşaması özetlenmektedir:

Protected Audience API reklam açık artırmasındaki altı aşama
Protected Audience reklam açık artırması aşamaları.

Protected Audience API'de reklam açık artırması, tarayıcının reklam seçmek için kullanıcının cihazında çalıştırdığı küçük JavaScript programlarından oluşan bir koleksiyondur. Gizliliği korumak için satıcı ve alıcılardan gelen tüm reklam açık artırması kodu, dış dünyayla iletişim kuramayan izole JavaScript işletim birimlerinde çalıştırılır.

Bir satıcı (yayıncı veya arz tarafı platformu), reklam alanı satan bir sitede (ör. haber sitesi) Protected Audience reklam açık artırması başlatır. Satıcı, açık artırmaya katılacak alıcıları seçer, satışa sunulan alanı belirtir ve reklam için ek ölçütler sağlar. Her alıcı bir ilgi alanları grubunun sahibidir.

Satıcı, teklifleri puanlamak için tarayıcıya kod sağlar. Bu kod, her teklifin değerini, reklam öğesi URL'sini ve her alıcıdan döndürülen diğer verileri içerir. Açık artırma sırasında, alıcılardan gelen teklif kodu ve satıcıdan gelen teklif puanı kodu, anahtar/değer hizmetlerinden veri alabilir. Bir reklam seçilip gösterildikten sonra (gizliliği korumak için sınırlı çerçevede) satıcı ve kazanan alıcı, açık artırma sonucunu bildirebilir.

  1. Bir kullanıcı, reklam gösteren bir siteyi ziyaret eder.
  2. Satıcının kodu bir açık artırma başlatır. Satıcı, hangi reklam alanının satılık olduğunu ve kimlerin teklif verebileceğini, ayrıca bu teklifleri puanlandırma yöntemini belirtir.
  3. Davet edilen alıcının kodu, teklif oluşturmak, alakalı bir reklam öğesi için URL ve diğer veriler oluşturmak üzere yürütülür. Teklif verme komut dosyası, alıcının anahtar/değer hizmetinden kalan reklam kampanyası bütçesi gibi gerçek zamanlı veriler için sorgu oluşturabilir.
  4. Satıcının kodu her teklife puan verir ve kazananı seçer. Bu mantık, teklifin istenebilirliğini döndürmek ve içerik reklamı kazananını geçemeyen bir reklamı reddetmek için teklif değerini ve diğer verileri kullanır. Satıcı, gerçek zamanlı veriler için kendi anahtar/değer hizmetini kullanabilir. Açık artırma başlamadan önce satıcı, mevcut reklam alanı için en iyi içerik bağlamına uygun reklamı bulur.
  5. Kazanan reklam, açık artırma yapılandırmasında resolveToConfig işareti ayarlandığında sınırlı çerçeve yapılandırma nesnesi olarak döndürülür. Yapılandırma, sınırlı çerçevede reklam öğesine gitmek için kullanılır ve reklam öğesinin URL'si hem satıcıdan hem de yayıncıdan gizlenir. resolveToConfig işareti false olarak ayarlanırsa veya iletilmezse kazanan reklam, bir iFrame'de reklamı oluşturmak için kullanılabilecek opak bir URN olarak döndürülür. Fenced frame yapılandırma nesnesi, M114 sürümünden itibaren kullanılabilir.
  6. Açık artırma, satıcıya ve kazanan alıcılara bildirilir.

Alıcı kaybetme ile ilgili bir raporlama mekanizması üzerinde çalışılmaktadır.

Protected Audience API anahtar/değer hizmeti nedir?

Protected Audience API Anahtar/Değer hizmeti, alıcı tarafından teklif verildiğinde reklam teknolojisi sağlayıcıların gerçek zamanlı verileri sorgulamasına ve satıcıların gizliliği koruyarak reklamları puanlamasına olanak tanır. Protected Audience API Anahtar/Değer hizmeti ve diğer hizmetler hakkında bilgileri Protected Audience API hizmetleri başlıklı makalede bulabilirsiniz.

Anahtar/Değer hizmeti, reklam teknolojisi şirketinin kendi bulut altyapısına dağıtılır ve hizmet, güvenilir yürütme ortamında çalışır. Bir Anahtar/Değer hizmetine yapılan istek, etkinlik düzeyinde günlük kaydına yol açamaz veya başka yan etkileri olamaz. Anahtar/değer hizmeti, reklam teknolojilerinin Anahtar/değer hizmetinde kendi özel mantıklarını yürütmelerine olanak tanıyan kullanıcı tanımlı işlevleri (UDF'ler) de destekleyecektir.

Bir alıcı veya satıcı, Protected Audience API anahtar/değer hizmetinden istediği verileri belirtmek için bir "anahtar" listesi sağlar. Anahtar/değer hizmeti, her anahtar için bir değerle yanıt verir.

Protected Audience API Anahtar/Değer hizmeti kodu artık Özel Korumalı Alan GitHub deposunda kullanılabilir. Bu hizmet, Chrome ve Android geliştiricileri tarafından kullanılabilir.

Protected Audience API Key/Value hizmeti hakkında daha fazla bilgiyi API açıklayıcı ve güven modeli açıklayıcı belgelerinden edinebilirsiniz.

Gerçek zamanlı veriler açık artırmalara nasıl dahil edilir?

Bir reklam açık artırmasındaki alıcılar veya satıcı, gerçek zamanlı verilere erişmesi gerekebilir. Örneğin, alıcılar bir reklam kampanyasındaki kalan bütçeyi hesaplamak isteyebilir veya satıcının reklam öğelerini yayıncı politikalarına göre kontrol etmesi gerekebilir.

Protected Audience API'nin gizlilik şartlarını karşılamak için reklam açık artırması sırasında gereken anlık veriler anahtar/değer hizmeti tarafından sağlanır. Her alıcı navigator.joinAdInterestGroup() işlevini çağırdığında bir anahtar/değer hizmeti URL'si belirtir ve bir açık artırma sırasında hizmete sorgulanacak anahtarları belirtir. Benzer şekilde, satıcı navigator.runAdAuction() çağrısı yaparak bir reklam açık artırması yürüttüğünde anahtar/değer hizmeti için bir URL sağlar. Satıcının anahtar/değer hizmeti, reklam öğesinin oluşturma URL'siyle sorgulanır.

İlk test için "Kendi Sunucunu Getir" modeli kullanılır. Uzun vadede, reklam teknolojisi sağlayıcıların gerçek zamanlı verileri almak için güvenilir yürütme ortamlarında çalışan açık kaynaklı Protected Audience API anahtar/değer hizmetlerini kullanması gerekecek.

Ekosistemin test için yeterli zamana sahip olmasını sağlamak amacıyla, üçüncü taraf çerezlerinin desteği sonlandırıldıktan bir süre sonrasına kadar açık kaynaklı anahtar/değer hizmetlerinin veya güvenilir yürütme ortamlarının kullanılmasını zorunlu kılmayı planlamıyoruz. Bu geçiş gerçekleşmeden önce geliştiricilerin test etmeye ve kullanmaya başlaması için önemli bir bildirimde bulunacağız.

Protected Audience açık artırmasında birinci taraf verileri nasıl kullanılır?

Birinci taraf verileri, sitenin kullanıcılarına ait verilerdir. Örneğin, bir kullanıcı reklamverenin veya yayıncının sitesinde en sevdiği rengi belirtmişse bu renk birinci taraf verisi olarak kabul edilir.

Protected Audience açık artırmasında reklamveren, reklam ilgi alanı grubu üyeliğini belirlemek için birinci taraf verilerini kullanabilir ve verileri ilgi alanı grubuna userBiddingSignals olarak da iletebilir. Reklamverenin birinci taraf verileri yalnızca teklif oluşturma adımında alıcılar tarafından kullanılabilir ve satıcılar tarafından kullanılamaz.

Örneğin, reklamveren kullanıcının en sevdiği rengi biliyorsa kullanıcı bir ilgi grubuna eklendiğinde değer, ilgi grubu yapılandırmasında userBiddingSignals olarak ayarlanabilir:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Yayıncı, açık artırmayı başlatırken auction config içinde sinyalleri ayarlayarak birinci taraf verilerini de iletebilir ve birinci taraf verilerini kimin alacağını kontrol edebilir. Yayıncı, birinci taraf verilerini auctionSignals olarak ilettiğinde hem alıcılar hem de satıcılar bu verilere erişebilir. Veriler sellerSignals olarak iletildiğinde yalnızca satıcı tarafından kullanılabilir. perBuyerSignals olarak iletildiğinde ise yalnızca belirtilen alıcılar tarafından kullanılabilir. Yayıncı, birinci taraf verilerini bileşen açık artırmalarına da iletebilir. Yayıncı ve açık artırma katılımcıları, hangi birinci taraf verilerinin paylaşılması gerektiği ve verilerin nasıl biçimlendirilmesi gerektiği konusunda önceden anlaşmalıdır.

Aşağıdaki örnekte, birinci taraf verilerinin yayıncı tarafından çeşitli açık artırma katılımcılarına nasıl iletilebileceği açıklanmaktadır:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Daha fazla bilgi

Protected Audience API'ye daha ayrıntılı bir genel bakış için Protected Audience API geliştirici kılavuzunu inceleyin.

Geliştiriciler

Protected Audience API ile çalışmaya başlamaya hazırsanız deneme yapma ve katılma başlıklı makaleyi okuyun.

API geliştirici kılavuzu yazdık ve temel bir Protected Audience API dağıtımının adım adım açıklamasını sunan bir Protected Audience API demosu oluşturduk. Protected Audience API demo videosunda, demo kodunun nasıl çalıştığı açıklanmakta ve Protected Audience API hata ayıklaması için Chrome Geliştirici Araçları'nın nasıl kullanılacağı gösterilmektedir.

Etkileşim kurma ve geri bildirim paylaşma