Protected Audience API'ye genel bakış

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

Bu makale kimler için hazırlandı?

Bu makalede, Protected Audience API ile ilgili temel bilgiler ve bununla ilgili bazı temel bilgiler ama fazla teknik ayrıntıya girilmiyor.

Protected Audience belgeleri. Bu makalenin sonunda, şunları nasıl yapacağınızı öğrenebilirsiniz: Etkileşim kurma ve geri bildirim paylaşma.

Protected Audience API nedir?

Protected Audience API, bir Özel Korumalı Alandır yeniden pazarlama ve özel kitlelere yönelik kullanım alanları sunmak üzere tasarlanmış üçüncü taraflar, kullanıcıların sitelerdeki göz atma davranışını izleyemez.

Protected Audience API, tarayıcının cihaz üzerinde açık artırmaları yaparak alakalı reklamları seçmesini sağlar. daha önce ziyaret ettiği web siteleri.

Protected Audience API, TURTLEDOVE teklif ailesi. İlgili içeriği oluşturmak için kullanılan Protected Audience ile TURTLEDOVE arasındaki fark, temel olarak reklam alıcısının ve satıcısının cihaz üzerindeki rolü. Aşağıdaki bölümlerde, sitenizin nasıl ve ne zaman nasıl çalıştığını gösterir.

Bir dakikada Protected Audience API

Protected Audience API hakkında daha ayrıntılı bir genel bakış için şu makaleyi okuyun: Protected Audience API geliştirici kılavuzu.

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 aşağıdakileri yapmasına olanak tanımak için ilgi alanı gruplarını kullanır: kullanıcılarıyla alakalı reklamlar gösterebilir.

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

  • İlgi grubunun adı: örneğin, "özel-bisikletler".
  • İlgi alanı grubunun sahibi: Örneğin, "https://dsp.example".
  • Tarayıcının erişmesine izin vermek için ilgi alanı grubu yapılandırma bilgileri teklif kodunu, reklam kodunu ve gerçek zamanlı verileri (grupların sahibi Bir reklam açık artırmasında
ziyaret edin.

Daha sonra kullanıcı kullanılabilir reklam alanı bulunan bir siteyi ziyaret ettiğinde reklam alanı satıcısı (satış tarafı sağlayıcı (STP) veya kendisi) en uygun reklamları seçmek amacıyla reklam açık artırması yürütmek için Protected Audience'ı kullanabilir kullanıcıya gösterilecek şekilde ayarlayabilirsiniz. Satıcı navigator.runAdAuction() adını çağırır işlevini kullanın.

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

Teklif kodu, ilgi alanı grubunun yapılandırma. Bu kod, söz konusu ilgi grubu ve kitle hakkında satıcıyla ilgili bağlamsal verilerle birlikte göz atabilirsiniz.

Teklif sağlayan her ilgi alanı grubu alıcı olarak bilinir.

Tarayıcı, reklam açık artırmasını yürütmek için işlevi çağırdığında, her bir alıcının kodu reklamverenin sağladığı gerçek zamanlı verilerin yardımıyla bir teklif oluşturur Korunan Kitle Anahtar/Değer Hizmeti Satıcı, Bu tekliflerin yanı sıra satıcıya ait gerçek zamanlı verileri ve puanları teklif verirsiniz. Açık artırmayı en yüksek puana sahip teklif kazanır.

Kazanan reklam çizili çerçeve'yi seçin. Reklam öğesinin URL'si teklifte belirtilir ve kaynak, ilgi grubu yapılandırması tarafından sağlanan liste.

Satıcı açık artırma sonucunu bildirebilir (reportResult()). Alıcılar ise şunları yapabilir: ve kazandığını bildiriyor (reportWin()).

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, kullanıcıları web sitenizi ziyaret etmek için site içeriğine göre (içeriğe dayalı hedefleme) veya bilgileri kullanarak Kullanıcı tarafından reklamın göründüğü siteye sağlanır (birinci taraf veri hedefleme).

Geleneksel olarak, reklam platformları kullanıcıların belirli bir zamanda tespit edebilirsiniz. Tarayıcıların, reklam platformlarının seçebileceği bir yönteme ihtiyacı vardır alakalı reklamlar sunarak, içerik yayıncılarının siteler arası olmadan reklam geliri elde etmesini sağlar izleyebilirsiniz.

Protected Audience API, web platformunu kullanıcının cihazındaki tarayıcısı (reklamveren veya reklam teknolojisi platformları değil) muhafaza edilir ilgi alanları hakkında bilgi toplar.

Protected Audience API'yi nasıl deneyebilirim?

  • Protected Audience API geliştirici kılavuzunda aşağıdaki bilgiler açıklanmaktadır: API'yi nasıl kullanacağınızı ve yerel olarak test etmeyi öğreneceksiniz.

  • protected-audience-demo.web.app, kullanıcılara Reklamveren ve yayıncı genelinde temel Protected Audience dağıtımının adım adım açıklamalı kılavuzu siteler. Protected Audience demo videosunda bu kodun işleyiş şekli ve önizlemeler açıklanır hata ayıklama için Chrome Geliştirici Araçları'nı kullanma.

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

Kullanıcılar, Chrome'da Özel Korumalı Alan denemelerine katılımlarını şu şekilde ayarlayabilir: üst düzey ayarı etkinleştirmek veya devre dışı bırakmak chrome://settings/adPrivacy İlk test sırasında kullanıcılar şunu kullanarak Protected Audience API'nin kapsamı dışında kalmayı seçebilir: Özel Korumalı Alan ayarları.

Chrome, kullanıcıların ilgi alanı gruplarının listesini görmesine ve yönetmesine izin vermeyi planlıyor URL'leri, ziyaret ettikleri sitelerde eklenmiş olmalıdır. Gizlilik ayarında olduğu gibi Korumalı alan teknolojileri, kullanıcı ayarları, kullanıcılardan gelen geri bildirimlere göre değişebilir. vb.

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

API arayanları, 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'nin kapsamı dışında kalmayı seçebilir miyim?

Protected Audience API'ye erişimi nasıl engelleyeceğinizi öğrenin. bunu site sahibi veya bireysel kullanıcı olarak değiştirebilirsiniz.

Temel kavramlar

Protected Audience terminolojisi hakkında daha fazla bilgi mi arıyorsunuz? Daha fazla bilgi için Özel Korumalı Alan sözlüğü.

İlgi alanı grubu nedir?

Protected Audience API ilgi alanı grubu, ortak bir ilgi alanına sahip kullanıcı grubunu temsil eder. bir yeniden pazarlama listesine karşılık gelen URL'ler kullanılabilir.

Her Protected Audience API ilgi alanı grubunun bir sahibi vardır. Farklı türde sahipler, farklı ilgi alanı grupları oluşturabilirsiniz.

Dosyanın sahibi, kullanıcının tarayıcısından şu tarihe kadar ilgi alanı grubunun üyeliğini eklemesini ister: navigator.joinAdInterestGroup() JavaScript işlevini çağırarak ilgi alanı grubuyla alakalı reklamlar hakkındaki veriler ve URL gibi bilgiler için en iyi konumdur. İlgi alanı grubu verileri (reklamlar gibi) güncellenir 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 sahibi türleriyle ilgili örnekler verilmiştir.

Sahip Örnek İlgi Örnek Kullanım alanları
Reklamveren Bisiklet üreticisi Ürünler Belirli bir bisiklet kategorisindeki ürün sayfalarını görüntüleyen kullanıcılar. Kullanıcılara yeniden pazarlama yeni müşteriler bulabilirsiniz.
Yayıncı Haber web sitesi İçerik Bisiklet hakkında okuyan kullanıcılar. Yayıncılar, birinci taraf verilerini kullanarak reklamverenlerin sitenizde okuyucularla alakalı reklamlar satın almak için. CEVAP yayıncıya ait ilgi alanı grubu, yayıncıların aynı şeyi yapmasına kullanıcılar diğer sitelere göz atarken kullanabilir. Yayıncılar şunları yapabilir: reklamlarının belirli segmentlerine reklam gösterebilmesi için kitle.
Reklam teknolojisi DSP Ürün kategorisi Bisiklet ekipmanlarına ilgi gösteren kullanıcılar. Bir reklam teknolojisi şirketi, bir ilgi alanı grubu oluşturup yönetebilir belirli bir ürün kategorisi için pazarda olduğunu düşündükleri kişilerin oranı Bu ilgi alanı grubu söz konusu kategoride ürün satan sitelerde ürünlerin reklamını yapmak için kullanılabilir (ve reklam teknolojisi şirketiyle çalışan kişiler).

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

Alıcı nedir?

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

Örneğin:

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

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

  • 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 bildirin.

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

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

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 yürütebilecek 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 etme.
  • Arz tarafı platformu (SSP): Yayıncıyla çalışma ve başka hizmetler sağlama.
  • Üçüncü taraf komut dosyası: Reklam açık artırmalarına katılımı sağlamak için yayıncı adına hareket etme.

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

  • Hangi alıcıların ve tekliflerin uygun olduğunu belirten yayıncı kurallarını zorunlu kılın.
  • Açık artırma mantığını çalıştır: JavaScript'in çalışması iş akışını istenen puandır.
  • Açık artırma sonucunu bildirin.

Bu işler, reklam başlattığında satıcı tarafından sağlanan kodla programatik olarak yapılır navigator.runAdAuction() JavaScript işlevini çağırarak açık artırmanın bir sonraki adımıdır.

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 aşaması özetlenmektedir:

Protected Audience API reklam açık artırmasında 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 kullanıcının tarayıcısında çalıştırdığı küçük JavaScript programlarından kullanarak reklam seçin. Gizliliği korumak için, satıcı ve alıcılardan gelen tüm reklam açık artırma kodları çalıştırılır dış dünyayla iletişim kuramayan yalıtılmış JavaScript iş akışlarında bulunmalıdır.

Satıcı (yayıncı veya destek tarafı platformu) Reklam alanı satan bir sitede (ör. haber gibi) Protected Audience reklam açık artırması başlatırsa sitesinde yer alır). Satıcı, açık artırmaya katılacak alıcıları seçer. satılık alanı belirtir ve reklam için ek ölçütler sağlar. Her alıcı bir ilgi alanı grubunun sahibi olabilir.

Satıcı, teklifleri puanlaması için tarayıcıya her teklifin değerini, reklam öğesi URL'si ve her bir alıcıdan döndürülen diğer veriler. Açık artırma sırasında teklifli sistem, alıcının kodu ve satıcının teklif puanı kodu, kendisinden gelen verileri Anahtar/Değer hizmetleri. Bir reklam seçildikten sonra korumak için (çizili çerçevede) satıcı ve kazanan alıcı, açık artırma sonucunu bildirebilir.

  1. Kullanıcı reklamların görüntülendiği bir siteyi ziyaret eder.
  2. Satıcının kodu bir açık artırma başlatır. Satıcı, ve kimlerin teklif verebileceği ve bu teklifleri puanlama yöntemi.
  3. Davet edilen alıcının kodu, teklif (alakalı bir reklamın URL'si) oluşturmak için yürütülür ve diğer verileri içerir. Teklif komut dosyası gerçek zamanlı verileri sorgulayabilir, geri kalan reklam kampanyası bütçesi gibi, alıcının Anahtar/Değer hizmet.
  4. Satıcının kodu her teklifi puanlar ve kazananı seçer. Bu mantık Teklifin istenen değerini döndürmek ve içeriksel reklamın kazananı geçemez. Satıcı kendi Gerçek zamanlı veriler için Anahtar/Değer hizmeti. Şu tarihten önce: açık artırma başladığında satıcı, mevcut ve alakalı en uygun bağlamsal reklamı reklam alanı
  5. Açık artırma yapılandırmasında resolveToConfig işareti ayarlandığında kazanan reklam, çitli ç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 değerine ayarlanırsa veya iletilmezse kazanan reklam, reklamı iFrame içinde oluşturmak için kullanılabilecek opak bir URN olarak döndürülür. Sınırlandırılmış ç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.

Kaybeden alıcılarla ilgili bir bildirme mekanizması görüşmektedir.

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 koruyarak reklamları puanlandırmasına olanak tanır. Protected Audience API hizmetleri bölümünde Protected Audience API Anahtar/Değer Hizmeti ve diğerleri hakkında bilgi edinebilirsiniz.

Anahtar/Değer Hizmeti, reklam teknolojisinin kendi bulut altyapısına dağıtılır ve hizmet, güvenilir yürütme ortamında çalışır. Anahtar/Değer hizmetine yapılan istek, etkinlik düzeyinde günlük kaydıyla sonuçlanamaz veya başka yan etkiler söz konusu olamaz. Anahtar/Değer Hizmeti, reklam teknisyenlerinin Anahtar/Değer Çifti hizmeti içinde kendi özel mantıklarını yürütmesine olanak tanıyan kullanıcı tanımlı işlevleri (UDF'ler) de destekleyecek.

Bir alıcı veya satıcı "anahtarların" listesini sağlar Protected Audience API Anahtar/Değer Hizmeti'nden ihtiyaç duydukları verileri belirtmeleri gerekir. Anahtar/Değer Çifti 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 bulunabilir. Bu hizmet, Chrome ve Android geliştiricileri tarafından kullanılabilir.

Protected Audience API Anahtar/Değer hizmeti hakkında daha fazla bilgiyi şuradan edinebilirsiniz: API açıklayıcı ve güven modeli açıklayıcısı bölümlerini inceleyin.

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

Reklam açık artırmasındaki alıcılar veya satıcının gerçek zamanlı verilere erişmesi gerekebilir. dışı verilerdir. Örneğin, alıcılar bir reklam kampanyasında kalan bütçeyi hesaplamak 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 bir 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() yöntemini çağırdığında alıcı bir Anahtar/Değer Hizmet URL'si belirtir ve açık artırma sırasında hizmete sorgulanacak anahtarları belirtir. Benzer şekilde, satıcı navigator.runAdAuction() yöntemini çağırarak bir reklam açık artırması gerçekleştirdiğinde, 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 "Kendi Sunucunuzu Getirin" modeli kullanılır. Uzun vadede, reklam teknolojilerinin gerçek zamanlı veriler almak için güvenilir yürütme ortamlarında çalışan açık kaynaklı Protected Audience API Anahtar/Değer Hizmetleri hizmetlerini kullanması gerekecektir.

Ekosistemin test için yeterli zamana sahip olduğundan emin olmak amacıyla, üçüncü taraf çerezleri için desteğin sonlandırılmasının sonrasına kadar açık kaynaklı Anahtar/Değer Hizmeti hizmetlerinin veya güvenilir yürütme ortamlarının kullanılmasını zorunlu tutmayız. Geliştiricilerin, bu geçiş gerçekleşmeden önce test etmeye ve benimsemeye başlamaları 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 en sevdiği rengi belirtmişse bu renk birinci taraf verileri olarak kabul edilir.

Protected Audience açık artırmasında reklamveren, reklam ilgi alanı grubu üyeliğini belirlemek için birinci taraf verilerini kullanabilir. Ayrıca, verileri ilgi alanı grubuna userBiddingSignals olarak iletebilir. Reklamverenin birinci taraf verileri, teklif oluşturma adımı sırası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 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ı, açık artırmayı başlatırken açık artırma yapılandırmasındaki sinyalleri ayarlayarak birinci taraf verilerini de aktarabilir ve birinci taraf verilerini kimin alacağını kontrol edebilir. Bir yayıncı, birinci taraf verilerini auctionSignals olarak ilettiğinde hem alıcılar hem de satıcılar tarafından kullanılabilir. Veriler sellerSignals olarak iletildiğinde yalnızca satıcının kullanımına açık olur. perBuyerSignals olarak aktarıldığında ise yalnızca belirtilen alıcıların kullanımına sunulur. Yayıncı, birinci taraf verilerini bileşen açık artırmalarına da 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 hakkında daha ayrıntılı bir genel bakış için şu makaleyi okuyun: Protected Audience API geliştirici kılavuzu.

Geliştiriciler

Protected Audience API ile çalışmaya hazırsanız şunu okuyun: deneme ve katılma.

Bir API geliştirici kılavuzu yazdık ve temel Protected Audience API dağıtımının adım adım açıklamalı kılavuzunu içeren bir Protected Audience API demosu oluşturduk. Protected Audience API tanıtım 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ğı gösterilmektedir.

Etkileşimde bulunun ve geri bildirim paylaşın