Web için Topics API

bookmark_border Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Topics API, üçüncü taraf çerezleri kullanmadan ilgi alanına dayalı reklamcılığı etkinleştirir.

Topics API'nin işleyiş şekli

Topics API, kullanıcının etkinliğine göre kullanıcının ilgisini çektiği anlaşılan konulara erişmek ve bu konular hakkında gözlem yapmak için kullanılabilir. Topics API, API çağıranlara (reklam teknolojisi platformları gibi) kullanıcının ilgi alanlarını gösterebilir ancak kullanıcının etkinliği hakkında ek bilgi vermez.

Temel kavramlar

• Konu, mevcut kullanıcının ilgisini çeken ve kullanıcı tarafından okunabilen bir konudur ve Topics sınıflandırmasının bir parçasıdır.
• Çağrıcı, bir kullanıcının ilgi alanlarını gözlemlemek veya bunlara erişmek için Topics API'ye istek gönderen bir uygulama, üçüncü taraf SDK'sı, web sitesi veya hizmet gibi bir öğedir.
• Son üç dönemde bir Topics API isteği gönderen bir kullanıcı, bu konuyla ilişkili bir web sayfasından veya uygulamadan Topics API isteği gönderirse konu, kullanıcı tarafından gözlemlenir.
• Dönem, varsayılan olarak bir hafta olan konu hesaplama dönemidir.
• Sınıflandırma, /Arts & Entertainment/Music & Audio/Soul & R&B ve /Business & Industrial/Business Services/Corporate Events gibi kategorileri içeren hiyerarşik bir kategori listesidir.
• Konuları, kullanıcı etkinliğini sıfır veya daha fazla konuyla eşleyen bir sınıflandırıcı modeli kullanılarak elde edilir.

Topics API akışı temel adımları

Topics API yaşam döngüsü üç ana adımdan oluşur:

• Kullanıcı etkinliğini (ör. https://cats.example/tabby/index.html web sayfasını ziyaret ettiğinde veya cats uygulamasını indirdiğinde) gözlemleyin.
• Kullanıcı etkinliğinden /Pets & Animals/Pets/Cats gibi konular elde edin.
• Örneğin, alakalı reklamcılık (kedi maması promosyonu gibi) seçmek için bir sinyal olarak kullanıcı için daha önce gözlemlenen erişim konuları.

Konuları gözlemleme

Arayanlar yalnızca ilgi duydukları ve gözlemledikleri konulara erişebilir. Bir konu, bu konuyla ilişkili bir bağlamda Topics API isteği gönderen bir araya çağıran tarafından gözlemlenir. Bu kavramı açıklamak için aşağıdaki basitleştirilmiş örneği inceleyin.

• A ve B adlı iki Topics API çağırıcı olduğunu varsayalım.
• İki bağlam vardır:
  • Home & Garden konusuyla ilişkili Greenhouse (ör. Greenhouse adlı bir uygulama veya greenhouse.example web sitesi).
  • Tenis egzersizleri (ör. Tenis Egzersizleri adlı bir uygulama veya Sports/Tennis konusuyla ilişkili tennis.example web sitesi).
• Hem arayan A hem de B, Greenhouse bağlamında yer alıyor.
• Tenis egzersizleri bağlamında yalnızca arayan B mevcuttur.
• Basitleştirmek amacıyla, 1. dönem öncesinde kullanıcı için hiçbir konunun gözlemlenmediğini varsayalım.
• Kullanıcı Greenhouse uygulamasını ziyaret eder ve A ile B çağrısı yapanlar, kullanıcının sayfaya veya uygulamaya yaptığı ziyareti kaydetmek için Topics API çağrısı yapar (Topics API'nin nasıl çağrılacağını öğrenmek için Sonraki adımlar bölümünde önerilen uygulama kılavuzuna bakın). Bu kayıt (ana makine adı veya uygulama verileri), daha sonra ilgi alanlarını belirlemek için kullanılır. Topics API daha sonra Home & Garden konusunu hem A hem de B tarafından gözlemlendiği şekilde işaretler.
• Kullanıcı, Tenis egzersizleri uygulamasını ziyaret eder. Yalnızca B adlı arayan, Topics API isteği gönderir. Topics API daha sonra Sports/Tennis konusunu, B tarafından gözlemlendiği şekilde işaretler.
• Dönem sonunda Topics API, kullanıcının en popüler konularını yeniler ve kullanıcı etkinliğine göre bu konuları gözlemleyen kullanıcıları belirler.
• Daha sonra, arayan B başka bir Topics API çağrısı yaptığında, yanıt dizisinde bu kullanıcı için Home & Garden veya Sports/Tennis konusunu (veya% 5 olasılıkla rastgele bir konuyu) alabilir.
• A arayanı, Sports/Tennis konusunu hiç gözlemlemediği için yalnızca Home & Garden konusuna erişebilir. Bu, üçüncü tarafların yalnızca kullanıcının ilgilendiği konu hakkında, ilgili konunun bulunduğu belirli bağlamda (uygulama veya web sitesi) bilgi edineceği anlamına gelir.

Konuları türetme

Topics, ilgi alanı konularını kullanıcı etkinliğinden türetmektedir. Konular, önceden tanımlanmış açık kaynak sınıflandırmadan seçilir. Topics, dönem başına bir kez kullanıcının en çok ilgi gösterdiği beş konuyu ve bu konuları dönem boyunca gözlemleyen arayanları yeniler. Topics sınıflandırıcı modeli, konuları kullanıcı etkinliğinden türetmektedir: web sayfası ziyareti için ana makine adı, Android'de uygulama bilgileri.

Arayan, kullanıcının ilgi alanı konularına erişir

API, yalnızca son üç dönemde arayan tarafından gözlemlenen konuları döndürür. Bir araya getirene en fazla üç konu döndürülebilir. Bu konular,son üç dönemin her biri için birer konudur (arayan bu dönemdeki konuları gözlemlediyse). Döndürülen konular, arayan tarafından bağlamsal bilgileri tamamlamak için kullanılabilir ve kullanıcı için daha alakalı bir reklam bulmaya yardımcı olmak amacıyla birleştirilebilir.

Dönemler

Topics API, sağladığı ilgi alanlarını güncel tutmalıdır. Kullanıcılar için konular, varsayılan olarak bir hafta olan ve dönem olarak bilinen bir zaman aralığındaki etkinliklerine göre belirlenir. Her kullanıcının kendi dönemleri vardır (dönemler "kullanıcı başına"dır) ve ilk başlangıç zamanı rastgele belirlenir.

Topics API, her dönem bir kez kullanıcının en çok ilgi gösterdiği beş konuyu hesaplar ve cihaz üzerindeki bilgileri kullanarak bu konuları hangi kullanıcıların gözlemlediğini belirler. Her bir dönem için kullanıcının söz konusu dönemde en çok ilgi gösterdiği beş konu arasından bir tanesi rastgele seçilir. Gizliliği daha da artırmak ve tüm konuların temsil edilebildiğinden emin olmak için, konunun ilgi alanı sınıflandırmasındaki tüm olası konular arasından rastgele seçilme olasılığı% 5'tir.

Web'deki konularla ilgili uygulama örnekleri

Web'de konular, kullanıcının ziyaret ettiği sayfaların ana makine adlarından çıkarılır. Örneğin, dogs.example web sitesi için tahmin edilen konu /Evcil ve Yabani Hayvanlar/Evcil Hayvanlar/Köpekler olabilir.

Aşağıdaki şemada, Topics API'nin bir reklam teknolojisi platformunun uygun bir reklam seçmesine nasıl yardımcı olabileceğini gösteren basitleştirilmiş bir örnek gösterilmektedir. Örnekte, kullanıcının tarayıcısında web sitesi ana makine adlarını konularla eşleyen bir modelin bulunduğu varsayılmıştır.

Tarayıcı, Topics API'yi çağıran kodun bağlamından arayan kişinin kaynağını belirler. Pratikte bu, Topics kullanıcılarının API'yi kaynaklarından bir iframe içinde çağırması veya konuları kaynaklarına bir get işlevinde dahil etmesi anlamına gelir.

Örneğin, bir arz tarafı platformu (SSP) birden fazla yayıncı sitesine yerleştirilebilir. Ardından STP, kaynağından bir iframe içinde Topics API'yi çağırabilir. Bu sayede, söz konusu yayıncının sitelerinde bir kullanıcıyla ilişkili konuları gözlemleyebilir. Bu konular daha sonra kullanıcı için alakalı bir reklam seçmesine yardımcı olmak amacıyla bir talep tarafı platformuyla (TTP) paylaşılabilir.

API, hangi arayanların hangi konuları göreceğine nasıl karar verir?

API çağırıcıları yalnızca yakın zamanda gözlemledikleri konuları alır ve bir kullanıcının konuları her dönemde bir kez yenilenir. Dönem, Chrome'un uygulamasında bir hafta olarak belirlenmiştir. Yani API, belirli bir arayanın gözlemlenen konuları alabileceği bir kaydırmalı pencere sağlar.

Aşağıdaki tabloda, tek bir dönem boyunca bir kullanıcının varsayımsal tarama geçmişi örneği (gerçeğe uygun olmayan küçüklükte olsa da) özetlenmiştir. Bu örnekte, ziyaret edilen sitelerle ilişkili konular ve her sitede bulunan API çağırıcıları (siteye dahil edilen JavaScript kodunda document.browsingTopics()'ü çağıran varlıklar) gösterilmektedir.

Topics API, dönemin sonunda (varsayılan olarak bir hafta) tarayıcının haftanın en popüler konularını oluşturur.

• adtech1.example, running.example ve dogs.example'da gözlemlediği için artık Running & Walking, Athletic Shoes ve Dogs konularını almaya uygundur.
• adtech1.example, kullanıcının yakın zamanda ziyaret ettiği ve bu konuyla ilişkili herhangi bir sitede bulunmadığı için bu kullanıcı için Hotels & Accommodations konusunu almaya uygun değildir.
• adtech2.example, Running & Walking, Athletic Shoes ve Hotels & Accommodations konularını görmüştür ancak Dogs konusunu görmemiştir.

Kullanıcı, Sunglasses konusuna sahip sunglasses.example sitesini ziyaret etti ancak bu sitede Topics API'ye çağrı gönderilmedi. Bu noktada, Sunglasses konusunun API tarafından herhangi bir arayan için döndürülmeyeceği anlamına gelir.

İkinci haftada kullanıcı başka bir siteyi ziyaret eder:

Ayrıca, adtech2.example adresindeki kod sunglasses.example adresine eklenir:

Bu, adtech2.example'in 1. haftadan itibaren Running & Walking, Athletic Shoes ve Hotels & Accommodations konularının yanı sıra Camera & Photo Equipment ve Sunglasses konularını da alabileceği anlamına gelir. Ancak bu, sonraki döneme (3. hafta) kadar geçerli değildir. Bu sayede üçüncü taraflar, kullanıcının geçmişi (bu durumda modaya olan ilgisi) hakkında çerezlerle elde edebileceklerinden daha fazla bilgi edinemez.

Kullanıcı, adtech2.example'dan kod içeren bu konulara sahip siteleri ziyaret etmezse Running & Walking, Athletic Shoes ve Hotels & Accommodations, iki hafta sonra adtech2.example'in uygun konular listesinden çıkarılabilir.

Sınıflandırıcı modeli

Topics, web sitesi ana makine adlarını sıfır veya daha fazla konuyla eşleyen bir sınıflandırıcı modeli kullanır (tam URL'ler veya sayfa içeriği gibi ek bilgilerin analiz edilmesi, daha alakalı reklamlar sunabilir ancak gizliliği de azaltabilir).

Sınıflandırma

Konular, bir sınıflandırmadan seçilir. Bu konular, sınıflandırmanın güvenilir ekosistem katkıda bulunanları tarafından yönetilen bir kaynak haline gelmesi amacıyla Chrome tarafından seçilmiştir. Sınıflandırma, birçok kullanıcının tarayıcısının her konuyla ilişkilendirileceği kadar küçük olmalıdır. Sınıflandırmanın, sektördeki geri bildirimleri ve fikirleri içeren harici bir kaynaktan alınması nihai hedeftir.

Hassas kategorilerden kaçınmak için konuların herkese açık, gerçek kişiler tarafından seçilmiş ve güncel olması gerekir. Chrome tarafından kullanılan sınıflandırma, etnik köken veya cinsel yönelim gibi genellikle hassas kabul edilen kategorileri hariç tutmak için gerçek kişiler tarafından düzenlenmiştir.

Konu sınıflandırması

Konular, en iyi 50.000 site için manuel olarak seçilir ve sınıflandırıcı modelini eğitmek için bu seçili ana makine adları ve konular için geçersiz kılma listesi kullanılır. En popüler sitelerde, sınıflandırıcı modeli kullanılmak yerine konular için geçersiz kılma listesinden erişilir. Üstlendirme listesini bilgisayarınızda yerel olarak görüntüleyebilirsiniz.

Chrome'un Topics API uygulaması, modeli temsil eden bir TensorFlow Lite dosyası indirerek kullanıcının cihazında yerel olarak kullanılmasını sağlar.

Kullanıcının en çok ilgi gösterdiği beş konu nasıl seçilir?

API, her dönem için en fazla üç tane olmak üzere bir konu döndürür. Üç konu döndürülürse bu, geçerli dönem ve önceki iki döneme ait konuları içerir.

1. Tarayıcı, her dönemin sonunda aşağıdaki ölçütleri karşılayan sayfaların bir listesini oluşturur:
   • Sayfa, kullanıcı tarafından dönem boyunca ziyaret edildi.
   • Sayfa, document.browsingTopics() işlevini çağıran kod içeriyor.
   • API etkinleştirilmiştir (örneğin, kullanıcı veya yanıt başlığı tarafından engellenmemiş olmalıdır).
2. Kullanıcının cihazındaki tarayıcı, her sayfanın barındırıcı adını bir konu listesiyle eşlemek için Topics API tarafından sağlanan sınıflandırıcı modelini kullanır.

3. Tarayıcı, en çok görüntülenen beş konunun listesini oluşturur.

   • Sınıflandırma'daki 22 kök konunun her biri, reklamcılık ekosisteminden gelen geri bildirime göre "yüksek faydalı" veya "standart faydalı" gruplara atanır. Tarayıcı, konuları önce grup atamasına göre sıralar. Tüm alt konular, üst kök konularının paket atamasını devralır. "Yüksek faydalı" konulara öncelik verilir.
   • Tarayıcı daha sonra konuları her bir gruptaki sıklığa göre sıralar.
   • Bu sıralanmış listedeki ilk beş konu, kullanıcının söz konusu dönemde en çok ilgi gösterdiği konular olarak seçilir.

Ardından document.browsingTopics() yöntemi, her dönem için ilk beşten rastgele bir konu döndürür. Bu konulardan herhangi birinin, konu sınıflandırmasının tamamından rastgele seçilme olasılığı% 5'tir. Chrome'da kullanıcılar, API tarafından döndürülen konu sayısını azaltmak için konuları tek tek kaldırabilir veya tarama geçmişlerini temizleyebilir. Kullanıcılar API'yi devre dışı bırakabilir.

Mevcut dönem boyunca gözlemlenen konularla ilgili bilgileri chrome://topics-internals sayfasından görüntüleyebilirsiniz.

Sonraki adımlar

Aşağıdaki kaynakları da incelemenizi öneririz:

Web'de Topics API'yi daha iyi anlamak için kaynaklarımıza göz atın.

• Topics demolarına, ortak çalışma ve adım adım açıklamalı kılavuz videolarına göz atın.
• Geliştiricilerin test için Topics API'yi özelleştirmesine olanak tanıyan Chrome işaretleri listesine bakın.
• Kullanıcıların ve geliştiricilerin API'yi nasıl kontrol edebileceğini öğrenin.
• Teknik açıklamalar ve destek için kaynaklara göz atın. Soru sorun, etkileşim kurun ve geri bildirim paylaşın.