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 doküman 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 fazla yer verilmemektedir.

• Reklamcılık veya reklam teknolojisi alanında çalışıyorsanız Protected Audience'ın işleyiş şekline genel bir bakış elde edersiniz.
• Geliştirici veya yazılım mühendisiyseniz Protected Audience API Geliştirici Kılavuzu, API hakkında daha ayrıntılı teknik bilgiler sağlar. Beklemede olan Protected Audience özelliklerinin son durumunu okuyun.

Protected Audience belgelerinde kullanılan terimler için terimler sözlüğüne bakın. Bu dokümanın sonunda, kullanıcılarla nasıl etkileşime geçeceğinizi ve geri bildirim paylaşacağınızı öğrenebilirsiniz.

Protected Audience API nedir?

Protected Audience API, yeniden pazarlama ve özel kitle kullanım alanlarını sunmak için kullanılan, üçüncü tarafların siteler arasında kullanıcı tarama davranışını izleyememesi için tasarlanmış bir Privacy Sandbox 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ırmalar yapılmasını sağlar.

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

Protected Audience API'yi bir dakikada öğrenme

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

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

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

• İlgi grubunun adı: Örneğin, "özel-bisikletler".
• İ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 koduna, reklam koduna ve gerçek zamanlı 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ş olan ilgi alanı grupları tarafından sağlanabilir.

Teklif verme kodu, ilgi alanı grubunun yapılandırmasında sağlanan bir URL'den alınır. Bu kod, sayfa ve tarayıcı ile ilgili bağlamsal verilerin yanı sıra ilgi grubu ve satıcıyla ilgili 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 Key/Value hizmeti tarafından sağlanan gerçek zamanlı verilerin yardımıyla bir teklif oluşturur. Ardından satıcı, bu tekliflerin yanı sıra satıcıya ait gerçek zamanlı verileri alır ve her teklifi puanlar. Açık artırmayı en yüksek puana sahip teklif kazanır.

Kazanan reklam, çitli bir çerçevede 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()) ve alıcılar kazançlarını (reportWin()) bildirebilir.

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

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

Kullanıcı ilgi alanlarını anlamak, reklamları yalnızca site içeriğine göre seçmekten (bağlamsal hedefleme) veya kullanıcının reklamın gösterildiği siteye sağladığı bilgileri kullanmaktan (birinci taraf veri hedefleme) daha alakalı reklamlar yayınlamanıza olanak tanır.

Reklam platformları, geleneksel olarak kullanıcıların sitelerdeki davranışlarını izleyerek kullanıcı ilgi alanları hakkında bilgi ediniyordu. 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 kullanıcının ilgi alanlarıyla ilgili bilgileri reklamverenin veya reklam teknolojisi platformlarının değil, kullanıcının cihazındaki tarayıcının tuttuğu bir duruma taşımayı 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ğı gösterilmektedir.

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

Kullanıcılar, chrome://settings/adPrivacy'teki üst düzey ayarı etkinleştirerek veya devre dışı bırakarak Chrome'daki Özel Korumalı Alan denemelerine katılımlarını ayarlayabilir. İ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ı kullanıcılardan, düzenleyicilerden ve diğerlerinden gelen geri bildirimlerle gelişebilir.

Protected Audience API'nin gelişimine bağlı olarak 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.

API çağırıcıları, kullanıcılar gizli modda gezinirken 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 terimleri sözlüğüne göz atın.

İlgi alanı grubu nedir?

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

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

Sahip, navigator.joinAdInterestGroup() JavaScript işlevini çağırarak, ilgi grubuyla alakalı reklamlar gibi bilgiler ve teklif vermede kullanılan JavaScript için bir URL sağlayarak kullanıcının tarayıcısından ilgi grubuna üyelik eklemesini ister. İlgi grubu verileri (reklamlar gibi) güncellenebilir ve bir ilgi grubu 30 güne kadar etkinleştirilebilir.

İlgi alanı grubu türleri

Aşağıdaki tabloda, farklı türde Protected Audience API ilgi alanı grupları ve sahiplerinin örnekleri verilmiştir.

Chrome, sahip başına en fazla 1.000 ilgi alanı ve en fazla 1.000 ilgi alanı sahibine izin verir. Bu sınırlar, normal çalışma sırasında aşılmaması gereken koruma bariyeri olarak tasarlanmıştır.

Alıcı nedir?

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

Örneğin:

• Reklamveren: Kendisi için hareket eder.
• 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:

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

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

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

• Satıcı bir reklam açık artırması yayınladığında kullanılacak teklif kodu URL'si.
• İlgi alanı grubuna ait reklam öğelerinin URL'leri olabilir. (Reklam URL'leri daha sonra bir güncellemeyle eklenebilir.)
• Açık artırma sırasında teklif kodunun gerçek zamanlı veri almasını sağlamak için sorgulanacak veri anahtarlarının listesi ve alıcının Anahtar/Değer hizmetinin URL'si.

Alıcının kodu, açık artırma sonucunu bildirmek için bir reportWin() işlevi 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 eden.
• Arz tarafı platformu (STP): Yayıncıyla birlikte çalışır ve diğer hizmetleri sağlar.
• Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılımı sağlamak için 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ı uygulama: 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 arzu edilirlik puanı hesaplamak üzere worklet'lerde çalıştırılan JavaScript.
• Açık artırma sonucunu bildirin.

Bu işler, navigator.runAdAuction() JavaScript işlevini çağırarak reklam açık artırması başlatan satıcı tarafından 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ı özetlenmiştir:

Protected Audience API'de reklam açık artırması, tarayıcının kullanıcının cihazında reklam seçmek için ç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ırma kodu, dış dünyayla iletişim kuramayan izole JavaScript worklet'lerinde çalıştırılır.

Satıcı (yayıncı veya arz tarafı platform), reklam alanı satan bir sitede (haber sitesi gibi) Protected Audience reklam açık artırması başlatır. Satıcı, açık artırmaya katılacak alıcıları seçer, hangi alanın satışta olduğunu belirtir ve reklam için ek ölçütler sağlar. Her alıcı bir ilgi alanı 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ıların teklif verme kodu ve satıcının teklif puanlama kodu, anahtar/değer hizmetlerinden veri alabilir. Bir reklam seçilip gösterildikten (gizliliği korumak için çitli bir çerçevede) sonra 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ışta olduğunu, kimlerin teklif verebileceğini ve bu teklifleri puanlama yöntemini belirtir.
3. Davet edilen alıcının kodu, teklif, alakalı bir reklam öğesi için URL ve diğer verileri 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 gönderebilir.
4. Satıcının kodu her teklifi puanlar ve bir kazanan seçer. Bu mantık, bir teklifin arzu edilirliğ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çeriğe dayalı reklamı bulur.
5. Açık artırma yapılandırmasında resolveToConfig işareti ayarlandığında kazanan reklam, çitle çevrili çerçeve yapılandırması nesnesi olarak döndürülür. Yapılandırma, çitli çerçeveden reklam öğesine gitmek için kullanılır ve reklam öğesinin URL'si hem satıcıya hem de yayıncıya gizlidir. resolveToConfig işareti false olarak ayarlanırsa veya iletilmezse kazanan reklam, reklamı bir iframe'de oluşturmak için kullanılabilecek opak bir URN olarak döndürülür. Çitli ç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ı kaybeden satıcılar için bir raporlama mekanizması değerlendirilmektedir.

Protected Audience API anahtar/değer hizmeti nedir?

Protected Audience API Anahtar/Değer hizmeti, reklam teknolojilerinin alıcı tarafından teklif verildiğinde gerçek zamanlı veri sorgulamasına ve satıcıların gizliliği korurken reklamları puanlamasına olanak tanır. Protected Audience API Anahtar/Değer hizmeti ve diğer hizmetler hakkında bilgi edinmek için Protected Audience API hizmetleri başlıklı makaleyi inceleyebilirsiniz.

Anahtar/Değer hizmeti, reklam teknolojisinin kendi bulut altyapısına dağıtılır ve hizmet güvenilir bir yürütme ortamında çalışır. Anahtar/Değer hizmetine yapılan bir istek, etkinlik düzeyinde günlük kaydıyla sonuçlanamaz veya başka yan etkilere neden 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 destekler.

Bir alıcı veya satıcı, Protected Audience API Anahtar/Değer hizmetinden ihtiyaç duyduğu 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 hizmet kodu artık Özel Korumalı Alan GitHub deposunda mevcuttur. Bu hizmet, Chrome ve Android geliştiricileri tarafından kullanılabilir.

Protected Audience API Anahtar/Değer hizmeti hakkında daha fazla bilgi edinmek için API açıklamalı ve güven modeli açıklamalı makaleleri inceleyin.

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ı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 gerçek zamanlı veriler Anahtar/Değer hizmeti tarafından sağlanır. Her alıcı navigator.joinAdInterestGroup() işlevini çağrdığında bir Anahtar/Değer hizmet URL'si ve açık artırma sırasında hizmetten sorgulanacak anahtarları belirtir. Benzer şekilde, satıcı navigator.runAdAuction()'ü çağırarak bir reklam açık artırması yaptığında 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 Sunucunuzu Getirin" modeli kullanılır. Uzun vadede reklam teknolojilerinin, gerçek zamanlı verileri almak için güvenilir yürütme ortamlarında çalışan açık kaynak 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ğinin sonlandırılmasından bir süre sonraya kadar açık kaynak anahtar/değer hizmetlerinin veya güvenilir yürütme ortamlarının kullanılması gerekmeyecektir. Bu geçiş gerçekleşmeden önce geliştiricilerin test etmeye ve kullanmaya başlaması için önemli bir bildirimde bulunacağız.

Birinci taraf verileri, Protected Audience açık artırmasında 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 favori rengini belirttiyse bu renk birinci taraf veri 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 userBiddingSignals olarak ilgi alanı grubuna aktarabilir. Reklamverenin birinci taraf verileri, teklif oluşturma adımında yalnızca alıcılar tarafından kullanılabilir ve satıcılar tarafından kullanılamaz.

Örneğin, reklamveren kullanıcının favori rengini biliyorsa kullanıcı bir ilgi alanına eklendiğinde değer, ilgi alanı 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 açık artırma yapılandırmasında sinyalleri ayarlayarak birinci taraf verilerini de aktarabilir ve birinci taraf verilerini kimin aldığını kontrol edebilir. Bir yayıncı birinci taraf verilerini auctionSignals olarak iletirse bu veriler hem alıcılar hem de satıcılar tarafından kullanılabilir. 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ı, bileşen açık artırmalarına birinci taraf verileri de iletebilir. 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 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 okuyun.

Geliştiriciler

Protected Audience API ile çalışmaya başlamaya hazırsanız deneme yapma ve katılım bölümünü okuyun.

Temel bir Protected Audience API dağıtımını adım adım anlatan bir API geliştirici kılavuzu yazdık ve bir Protected Audience API demosu oluşturduk. Protected Audience API demo videosu, demo kodunun nasıl çalıştığı açıklanmakta ve Protected Audience API hata ayıklama için Chrome DevTools'un nasıl kullanılacağı gösterilmektedir.

Etkileşim kurma ve geri bildirim paylaşma

• GitHub: Açıklamayı okuyun, soru sorun ve tartışmayı takip edin.
• Duyuru: Protected Audience API posta listesine katılın veya geçmiş duyuruları görüntüleyin.
• W3C: Web Reklamcılığını Geliştirme İş Grubu'nda sektördeki kullanım alanlarını tartışın.
• Geliştirici desteği: Uygulama ve en iyi uygulamalar hakkında soru sorabilir veya Privacy Sandbox Geliştirici Desteği deposundaki tartışmalara katılabilirsiniz.
• Mevcut uygulama: Chrome'un Protected Audience'i uygulamasıyla ilgili sorularınız için: Chromium hatası gönderin.