Protected Audience API'ye genel bakış

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

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

Bu makalede Protected Audience API ile ilgili temel bilgiler ve bazı temel kavramlar açıklansa da teknik ayrıntılara fazla yer verilmemiştir.

Protected Audience belgelerinde kullanılan terimleri görmek için sözlüğe bakın. Bu makalenin sonunda, nasıl etkileşim kuracağınızı ve geri bildirim paylaşacağınızı öğrenebilirsiniz.

Protected Audience API nedir?

Protected Audience API, üçüncü tarafların sitelerde kullanıcı tarama davranışını izleyememesi için yeniden pazarlama ve özel kitle kullanım alanları sunan bir Özel Korumalı Alan teknolojisidir.

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ırmalara olanak tanır.

Protected Audience API, TURTLEDOVE teklif ailesi içinde Chromium'da uygulanacak ilk denemedir. Protected Audience ile TURTLEDOVE arasındaki fark, temel olarak reklam alıcısı ile satıcının cihaz üzerindeki rolünün ayrılmasıyla ilgilidir. Aşağıdaki bölümlerde Protected Audience API'nin işleyiş şekli açıklanmaktadır.

Bir dakika içinde Protected Audience API

Protected Audience API ile ilgili 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 bir ilgi alanı grubunun sahibi (ör. talep tarafı platformu) kullanıcının tarayıcısından ilgili ilgi alanı grubu için üyelik eklemesini isteyebilir. İstek başarılı olursa tarayıcı şunları kaydeder:

  • İlgi alanı grubunun adı: Örneğin, "özel-bisikletler".
  • İlgi alanı grubunun sahibi: Örneğin, "https://dsp.example".
  • Grup sahibi bir reklam açık artırmasında teklif vermek üzere davet edilirse tarayıcının teklif koduna, reklam koduna ve gerçek zamanlı verilere erişmesine olanak tanımak için ilgi alanı grubu yapılandırma bilgileri.

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

Teklifler yalnızca tarayıcının üye olduğu ve sahipleri teklif vermeye davet edilen ilgi alanı grupları tarafından sağlanabilir.

Teklif kodu, ilgi alanı grubunun yapılandırmasında sağlanan bir URL'den alınır. Bu kod, ilgi alanı grubu hakkında veriler ve satıcıdan gelen bilgilerin yanı sıra sayfa ve tarayıcıyla ilgili bağlamsal veriler sağlar.

Teklif veren her bir 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 Korunan Kitle Anahtar/Değer hizmeti tarafından sağlanan gerçek zamanlı verilerin yardımıyla bir teklif oluşturur. Daha sonra, satıcı bu tekliflerin yanı sıra satıcıya ait gerçek zamanlı verileri alır ve her bir teklifi puanlandırır. En yüksek puana sahip teklif açık artırmayı kazanır.

Kazanan reklam çitle çevrili bir çerçeve içinde görüntülenir. Reklam öğesinin URL'si teklifte belirtilir ve kaynak, ilgi alanı grubunun yapılandırmasında sağlanan listedeki bir kaynakla eşleşmelidir.

Satıcı açık artırma sonucunu (reportResult()) ve alıcılar kazançlarını bildirebilir (reportWin()).

Korunan Kitle açık artırma raporları hakkında bilgi edinin.

Protected Audience API neden gereklidir?

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

Geleneksel olarak, reklam platformları kullanıcıların sitelerdeki davranışlarını izleyerek ilgi alanları hakkında bilgi edinmiştir. Tarayıcıların, reklam platformlarının alakalı reklamları seçmesini sağlayacak bir yönteme ihtiyacı vardır. Böylece içerik yayıncıları siteler arası izleme olmadan reklam geliri elde edebilir.

Protected Audience API, web platformunu reklamverenin veya reklam teknolojisi platformlarının değil, kullanıcının cihazındaki tarayıcısının kullanıcının ilgilendiği şeylerle ilgili bilgi barındırdığı 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 yapılacağı açıklanmaktadır.

  • Protected-audience-demo.web.app, reklamveren ve yayıncı siteleri genelinde temel bir Protected Audience dağıtımı için adım adım açıklamalı bir kılavuz sunar. Protected Audience demo videosunda bu kodun işleyiş şekli açıklanmakta ve hata ayıklama için Chrome Geliştirici Araçları'nın nasıl kullanılacağı önizlemektedir.

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

Kullanıcılar, chrome://settings/adPrivacy ürününde üst düzey ayarı etkinleştirerek veya devre dışı bırakarak Özel Korumalı Alan denemelerine katılımlarını ayarlayabilirler. İlk test sırasında kullanıcılar, Özel Korumalı Alan ayarlarını kullanarak Protected Audience API'yi devre dışı bırakabilir.

Chrome, kullanıcıların ziyaret ettikleri sitelerde eklendikleri ilgi alanı gruplarının listesini görmelerine ve yönetmelerine olanak tanımayı planlamaktadır. Özel Korumalı Alan teknolojilerinde olduğu gibi, kullanıcı ayarları da kullanıcılardan, düzenleyicilerden ve diğer kişilerden gelen geri bildirimlerle değişebilir.

Protected Audience API ilerledikçe Chrome'daki kullanılabilir 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 arayanları grup üyeliğine erişemez ve kullanıcılar site verilerini temizlediğinde üyelik kaldırılır.

Protected Audience API'yi devre dışı bırakabilir 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, 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. Farklı sahip türleri, farklı kullanım alanlarına sahip farklı türlerde ilgi alanı grupları oluşturur.

Konum sahibi, kullanıcının tarayıcısından navigator.joinAdInterestGroup() JavaScript işlevini çağırarak, ilgi alanı grubuyla alakalı reklamlar hakkında veriler ve teklif vermede kullanılan JavaScript için bir URL gibi bilgiler sağlayarak kendi ilgi alanı grubu üyeliğini eklemesini ister. İlgi alanı grubu verileri (ör. reklamlar) güncellenebilir ve bir ilgi alanı grubu 30 güne kadar etkinleştirilebilir.

İlgi grubu türleri

Aşağıdaki tabloda, farklı Protected Audience API ilgi alanı grubu ve sahipleri için ö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. Daha önce markayla etkileşime geçmiş kullanıcılara yeniden pazarlama.
Yayıncı Haber web sitesi İçerik Bisiklet sürmeyle ilgili bilgi okuyan kullanıcılar. Yayıncılar birinci taraf verileri kullanarak reklamverenlerin sitelerindeki okuyucular için alakalı reklamlar satın almasını sağlayabilir. Yayıncının sahip olduğu bir ilgi alanı grubu, yayıncılar başka sitelere göz atarken bile aynı şeyi yapmalarına olanak tanıyabilir. Yayıncılar, kitlelerinin belirli segmentlerine reklam gösterebilme özelliği için ücret alabilirler.
Reklam teknolojisi DSP Ürün kategorisi Bisiklet malzemelerine ilgi gösteren kullanıcılar. Bir reklam teknolojisi şirketi, belirli bir ürün kategorisi için pazarda olduğunu düşündüğü bir ilgi alanı grubu oluşturup yönetebilir. Bu ilgi alanı grubu daha sonra, söz konusu kategoride ürün satan (ve reklam teknolojisi şirketiyle çalışan) sitelerde ürünlerin reklamını yapmak için kullanılabilir.

Chrome, sahip başına 1.000'e kadar ilgi alanı grubuna ve 1.000'e 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.

Alıcı nedir?

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

Örneğin:

  • Reklamveren: Kendisi adına hareket etme.
  • Talep tarafı platformu (TTP): Reklamverenler için işlem yapma.
  • İlgi alanı grubu sahibi: Birden çok reklamverenle çalışıyor.

Alıcıların üç işi vardır:

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

Bu işler, programlı bir şekilde, alıcı tarafından sağlanan ve Protected Audience API reklam açık artırması sırasında çalıştırılan kodla gerçekleştirilir.

Alıcı, bir 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 şu bilgileri sağlar:

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

Reklam açık artırmasını kim gerçekleştirir?

Reklam alanı satmak için açık artırma gerçekleştirebilecek birden fazla taraf vardır.

Örneğin:

  • İçerik yayıncısı: Web sitesinde reklam içeriği barındırmak için kendisi adına hareket eder.
  • Arz tarafı platformu (STP): Yayıncıyla çalışma ve diğer hizmetleri sağlama.
  • Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılım sağlamak amacıyla yayıncı adına hareket etme.

Protected Audience API ile bir reklam alanı satıcısının üç işi vardır:

  • Yayıncı kurallarını uygulama: Hangi alıcıların ve hangi tekliflerin uygun olduğunu belirtme.
  • Açık artırma mantığını çalıştırın: JavaScript, her teklif için bir istenenlik puanını hesaplamak üzere iş akışlarında çalışır.
  • Açık artırma sonucunu bildirir.

Bu işler, navigator.runAdAuction() JavaScript işlevini çağırarak reklam açık artırması başlattığında satıcı tarafından sağlanan kodla programlı bir şekilde gerçekleştirilir.

Protected Audience API reklam açık artırmasının işleyiş şekli

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

Protected Audience API reklam açık artırmasında altı aşama
Korunan Kitle reklam açık artırması aşamaları.

Protected Audience API'de reklam açık artırması, tarayıcının bir 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ılara ait tüm reklam açık artırması kodları, dış dünyayla iletişim kuramayan izole JavaScript işçilerinde çalıştırılır.

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

Satıcı, teklifleri puanlamak için tarayıcıya her teklifin değerini, reklam öğesi URL'sini ve her alıcıdan döndürülen diğer verileri içeren bir kod sağlar. Açık artırma sırasında, alıcılardan gelen teklif kodu ve satıcının teklif puanlama kodu Anahtar/Değer hizmetlerinden veri alabilir. Bir reklam seçilip görüntülendiğinde (gizliliği korumak için çitle çevrili bir ç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ğinin yanı sıra bu teklifleri puanlayacak bir yöntemi belirtir.
  3. Davet edilen alıcının kodu; teklif, alakalı bir reklam öğesinin URL'si ve diğer verileri oluşturmak için yürütülür. Teklif komut dosyası, alıcının Anahtar/Değer hizmetinden kalan reklam kampanyası bütçesi gibi gerçek zamanlı verileri sorgulayabilir.
  4. Satıcının kodu her bir teklifi puanlar ve bir kazanan seçer. Bu mantık, bir teklifin istenenliğini döndürmek ve içeriğe dayalı reklamın 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 içeriğe dayalı en iyi reklamı bulur.
  5. Açık artırma yapılandırmasında resolveToConfig işareti ayarlandığında, kazanan reklam sınırlanmış bir çerçeve yapılandırma nesnesi olarak döndürülür. Yapılandırma, sınırlanmış çerçeveden 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 giriş yapılmazsa kazanan reklam, reklamı iframe içinde oluşturmak için kullanılabilecek opak bir URN olarak döndürülür. Sınırlanmış çerçeve yapılandırma nesnesi M114'ten itibaren kullanılabilir.
  6. Açık artırma, satıcıya ve kazanan alıcılara bildirilir.

Alıcıları kaybedenlerle ilgili bir bildirim mekanizması hakkında görüşmeler devam etmektedir.

Protected Audience API Anahtar/Değer hizmeti nedir?

Protected Audience API Anahtar/Değer hizmeti, reklam teknisyenlerinin alıcı tarafından teklif verildiğinde gerçek zamanlı verileri sorgulamasına ve satıcıların gizliliği korurken reklamları puanlandırmasına olanak tanır. Protected Audience API hizmetlerinden Protected Audience API anahtar/değer çifti hizmeti ve diğer hizmetler hakkında bilgi edinebilirsiniz.

Anahtar/Değer hizmeti, reklam teknolojisinin kendi bulut altyapısına dağıtılır ve güvenilir yürütme ortamında çalışır. Bir Anahtar/Değer hizmetine yapılan istekler etkinlik düzeyinde günlüğe kaydedilemez veya başka yan etkiler doğuramaz. Anahtar/Değer hizmeti, reklam teknisyenlerinin Anahtar/Değer hizmeti içinde kendi özel mantığını yürütmesine olanak tanıyan kullanıcı tanımlı işlevleri (UDF) de destekleyecektir.

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

Protected Audience API anahtar/değer çifti hizmet kodu artık bir Özel Korumalı Alan GitHub deposunda kullanılabilir. Bu hizmet Chrome ve Android geliştiricileri tarafından kullanılabilir.

Protected Audience API Anahtar/Değer hizmeti hakkında daha fazla bilgiyi API açıklayıcıdan ve güven modeli açıklayıcıdan edinebilirsiniz.

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

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

Protected Audience API'nin gizlilik şartlarını karşılamak için reklam açık artırması sırasında gereken gerçek zamanlı veriler Anahtar/Değer hizmeti tarafından sağlanır. Her alıcı navigator.joinAdInterestGroup() için arama yaptığında, alıcı bir Anahtar/Değer hizmeti URL'si ve açık artırma sırasında hizmette sorgulanacak anahtarları belirtir. Benzer şekilde, satıcı navigator.runAdAuction() çağrısı yaparak bir reklam açık artırması gerçekleştirdiğinde, satıcı Anahtar/Değer hizmeti için bir URL sağlar. Satıcının Anahtar/Değer hizmeti, reklam öğesinin oluşturma URL'si ile sorgulanır.

İlk test için "Bring Your Own Server" (Kendi Sunucunuzu Getirme) modeli kullanılır. Uzun vadede reklam teknisyenlerinin 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ı gerekir.

Ekosistemin test için yeterli zamana sahip olduğundan emin olmak amacıyla, üçüncü taraf çerezleri için desteğin sonlandırılmasından sonraki bir süre içinde açık kaynaklı Anahtar/Değer hizmetlerinin veya güvenilir yürütme ortamlarının kullanılmasını zorunlu tutmayız. Bu geçiş gerçekleşmeden önce testlere ve benimsemeye başlamaları için geliştiricilere önemli bir bildirim göndereceğiz.

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

Birinci taraf verileri, site kullanıcılarının sahip olduğu 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.

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

Örneğin, reklamveren kullanıcının en sevdiği rengi biliyorsa kullanıcı bir ilgi alanı grubuna eklendiğinde bu değer, ilgi alanı 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ı ayrıca, açık artırmayı başlatırken açık artırma yapılandırmasında sinyalleri ayarlayarak birinci taraf verilerini aktarabilir ve birinci taraf verilerini kimin alacağını kontrol edebilir. Bir yayıncı birinci taraf verilerini auctionSignals olarak ilettiğinde bu veriler hem alıcılar hem de satıcılar tarafından kullanılabilir. Veriler sellerSignals olarak aktarıldığında 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ı, bileşen açık artırmalara birinci taraf verilerini de aktarabilir. Yayıncı ve açık artırma katılımcıları, hangi birinci taraf verilerinin paylaşılması 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 aktarılabileceğ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 ile ilgili 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 hazırsanız deneme ve katılma başlıklı makaleyi okuyun.

Bir API geliştirici kılavuzu hazırladık ve temel bir Protected Audience API dağıtımıyla ilgili adım adım açıklamalı bir Protected Audience API demosu hazırladık. Protected Audience API demo videosunda demo kodunun işleyiş şekli ve Protected Audience API hata ayıklaması için Chrome Geliştirici Araçları'nın nasıl kullanılacağı açıklanmaktadır.

Etkileşimde bulunun ve geri bildirim paylaşın