Topics tabanlı bir çözümü test etme, dağıtma ve ölçeklendirme

Bu sayfada, Topics API'yi kullanarak üretim için bir uygulamayı nasıl oluşturacağınız, test edeceğiniz ve ölçeklendireceğiniz açıklanmaktadır.

Topics arka uç uygulaması

Arka uç uygulamanız, tarayıcıda hesaplanan konuları nasıl kullanmak istediğinize bağlıdır. Reklam teknolojisi çözümlerinin, Konular'ı ek bir IBA sinyali olarak kullanmasını öneririz.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Ek sinyal olarak Topics'i kullanma

Konular verileri, kitlenizle ilgili ek bir sinyal olarak URL'ler, anahtar kelimeler veya diğer meta veriler gibi diğer sinyallerle birlikte değerlendirilebilir.

Üçüncü taraf çerezlerinden sonra reklam alaka düzeyini artırma başlıklı makalede açıklandığı gibi, alakalı reklamlar yayınlamak için Topics'ten yararlanmanın birden fazla yolu vardır. Bunlardan bazıları kitle oluşturmak için Topics'i kullanmayı içerirken diğer yaklaşımlar, Topics'in kitlelerin ek ilgi alanlarını tahmin etmek veya teklif verme mantığını optimize etmek için kullanılacak makine öğrenimi modellerini eğitmek üzere diğer sinyallerden biri olarak kullanılmasını önerir.

Derleme ve dağıtma

  1. Üretimdeki kullanıcıları gözlemleyerek konuları toplama (tahmini uygulama süresi: yaklaşık bir hafta):
    • Seçeneklerinizi anlama: HTTP üstbilgileri veya iframe ve JavaScript ile Topics'i çağırma
    • Topics API'yi çağıracak iFrame'in alanını tanımlayın.
    • Kod referansı olarak header demo veya JavaScript demo'yu kullanarak çözümünüzü oluşturun.
    • Yayıncıların sitelerine yerleştirdiği koda (ör. reklam iframe'iniz) Topics'i entegre edin. Yerleştirme işleminden konuları çağırdığınızdan emin olun.
    • Kullanıcı konularını gözlemlemeye başlamak için komut dosyanızın en son sürümünü üretim web sitelerinize yerleştirin. Uygulamayı önce aylık ziyaretçi sayısı az olan kendi web sitelerinizde test etmenizi öneririz. Bu aşamada, yeni konuya dayalı çözümünüzü en az beş siteye yerleştirmenizi öneririz.
    • Bu noktada, API'nin sonuç olarak boş bir dizi döndürmesi beklenir. Bunun nedeni, kullanıcı için henüz herhangi bir konunun gözlemlenmemiş olmasıdır. Kullanıcı konularını almaya başlamak üç haftayı bulabilir.
    • İşlevsel test ve doğrulama gerçekleştirin. Çözümünüzü manuel veya otomatik olarak test edebilirsiniz. Örneğin:
      • Tarayıcınızı işaretlerle açın ve dönemi 15 saniye olarak ayarlayın. Böylece tarayıcı, Konular'ı daha erken yeniden hesaplar.
      • Komut dosyanızı yerleştiren siteleri ziyaret edin.
      • Konuların, komut dosyanız tarafından chrome://topics-internals/ üzerinde gözlemlenip gözlemlenmediğini kontrol edin.
      • Hangi sonuçları bekleyebileceğinizi görün.
  2. Topics verilerini diğer bağlamsal sinyallerle (ör. URL'ler, meta veriler vb.) birlikte kullanma (Tahmini süre: yaklaşık 3 gün)
    • Üretimde üç hafta geçtikten sonra komut dosyanız bazı kullanıcıların konularını gözlemlemiş olmalıdır. Bu noktada, Konular verilerini ek bir sinyal olarak kullanabilirsiniz.
    • Boş olmayan bir konu listesi almaya başladığınızda, bunu diğer bağlamsal sinyallerle birlikte arka uçunuza gönderebilirsiniz.

Hedef sitelere dağıtma

Topics çağrısını komut dosyanıza entegre ettikten sonra, ilk test için bazı üretim sitelerine yerleştirdiğinizden emin olun. Uygulamanızın beklendiği gibi çalıştığından emin olun:

  • Topics API çağrılır.
  • Bu kontrollü ortamda konular gözlemlenebilir.
  • Konulara erişilebilir (API, kullanıcı için gözlemlenen konuları döndürür).

Hedef siteleri seçin

Çözümünüzü yayıncıların sitelerine dağıtmadan önce, sahip olduğunuz web sitelerinde kontrollü bir ortamda test etmenizi öneririz. Hedef web sitelerini aşağıdaki gibi seçmenizi öneririz:

  • Siteye aylık olarak az sayıda ziyaretçi geliyor (ayda yaklaşık bir milyondan az ziyaret): API'yi önce küçük bir kitleye dağıtarak başlamalısınız.
  • Sitenin sahibi ve yöneticisi sizsiniz: Gerekirse uygulamayı karmaşık onaylar olmadan hızlıca devre dışı bırakabilirsiniz.
  • Site, işletme açısından kritik öneme sahip değil: Düşük riskli hedef sitelerle başlayın.
  • Toplamda en fazla beş site: Şimdilik bu kadar çok trafiğe veya görünürlüğe ihtiyacınız olmayacak.
  • Hedef siteler farklı temaları temsil ediyor: Farklı kategorileri temsil eden web siteleri seçin (örneğin, biri spor, biri haber, biri de yiyecek ve içecek hakkında olsun). Alanları ve Topics makine öğrenimi sınıflandırıcısı tarafından nasıl sınıflandırıldıklarını doğrulamak için Chrome'daki dahili konular aracını kullanabilirsiniz.

İşlevsel test ve doğrulama

Bu sınırlı ortamda Topics API'yi çağırırken aşağıdaki sonuçları bekleyebilirsiniz:

  • Son yedi gün içinde bu cihazdan, bu site ve arayan için yapılan ilk arama ise boş bir konu dizisi [].

  • Bu kullanıcının ilgi alanlarını temsil eden, sıfır ila üç konudan oluşan bir liste. Yedi günlük gözlem süresinin ardından şunları alırsınız:

    • Kullanıcı için en popüler beş konu arasından seçilen bir konu. Bu konu, arayan tarafından o hafta konuların gözlemlendiği sayfaların ana makine adlarından hesaplanır.

  • Önceki tüm Topics API çağrılarındakiyle aynı API yanıtı. Aynı arayan, kullanıcı ve üst düzey site için API, bir dönemin tamamında aynı konuları döndürür. Bu, kullanıcının ilgi alanlarının çok fazla gösterilmesini önlemeye yardımcı olur. GitHub'da daha fazla bilgi edinin.

  • Dört haftalık gözlemden sonra Topics'i çağırıyorsanız üç eski konudan birinin yerine yeni bir konu.

  • Kullanıcının son üç hafta veya daha uzun süredir takip ettiği konuları gözlemlemediyseniz Topics API yine boş bir dizi [] döndürür.

Kullanıcı deneyiminizi değerlendirmek için performans metrikleri toplayın:

  • Topics API'ye yapılan JavaScript çağrılarının, kaynaklar arası bir iFrame içindeki çalışma süresi, gelecekteki performans analizlerinde kullanılmak üzere ölçülmelidir.
  • Konular alındıktan sonra iframe ve postMessage() konularının oluşturulması için geçen süre.

Sorun giderme için destek bölümüne bakın.

Üretime ölçeklendirme

Bu noktada, Topics'i kontrollü bir ortamda (sahibi olduğunuz bazı sitelerde) test etmiş olmanız gerekir. Her şey beklendiği gibi çalışıyorsa bu uygulamayı ölçeklendirebilirsiniz. Aynı kodu daha fazla hedef web sitesine dağıtın. Bu sayede daha fazla kullanıcıyı gözlemleyebilir, daha fazla konu verisi toplayabilir ve kitleleriniz hakkında daha derin bir anlayış geliştirebilirsiniz.

Üretime geçişle ilgili adım adım özet aşağıda verilmiştir:

  1. Konulara dayalı çözümünüzü daha yüksek hacimli trafik üzerinde test edin.
    • iframe'inizi, daha fazla ziyaretçi alan ve size ait olan diğer sitelere ekleyin ve yük testi gerçekleştirmek için aşağıdaki talimatları uygulayın.
  2. Çözümünüzü yayıncıların sitelerine dağıtın.
    • Çözümünüz kendi test ortamınızda doğru şekilde çalıştıktan sonra, iframe'inizi web sitelerine entegre etmek için yayıncılarla birlikte çalışın. Örneğin, iFrame'inizi içeren kitaplığı güncellemeleri gerekebilir.
  3. Konu verilerini işleme ve kullanma (tahmini süre: yaklaşık dört hafta).
    • Topics verilerini diğer verilerle birlikte ek bir sinyal olarak dahil edin.
    • Gerçek zamanlı teklif verme test iş ortaklarını bulun.
    • Diğer verilerinize ek bir sinyal olarak konularla birlikte yardımcı program testi yapın.

Yük testi

Sisteminizin trafiği işleyebildiğinden emin olmak için, konuya dayalı çözümünüzü yayıncıların sitelerine dağıtmadan önce yük testi yapmanızı öneririz.

  1. Sahibi olduğunuz daha fazla hedef siteye, özellikle de daha fazla trafik alan sitelere kademeli olarak dağıtın.
  2. Beklenen trafiğinize göre konular verileriniz için yük testi gerçekleştirin.
    • Iframe'den konu bilgilerini arka uçunuza göndermeniz gerekir. Bu sayede, Topics API sonuçlarını daha fazla işleyebilir ve kullanıcıyla daha alakalı reklamlar seçmeye yardımcı olacak ek bir sinyal olarak kullanabilirsiniz. Yerleştirme işleminiz daha fazla siteye dahil edildikçe arka uçunuza yapılan çağrı sayısı önemli ölçüde artar. Arka uçunuzun iFrame'den gelen çok sayıda çağrıyı işleyebildiğini doğrulayın.
    • Analiz için metrik toplama ve günlükleri ayarlayın.
  3. Topics API'yi dağıttıktan hemen sonra, son kullanıcılarla ilgili ciddi sorunları tespit etmek için metriklerinizi kontrol edin. Metriklerinizi düzenli olarak kontrol etmeye devam edin.
  4. Kesinti veya beklenmedik davranış durumunda dağıtımı geri alın ve sorunu anlayıp düzeltmek için günlüklerinizi analiz edin.

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

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