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

Bu sayfada, Topics API'yi kullanarak üretim için bir uygulamanın nasıl oluşturulacağı, test edileceği ve ölçeklendirileceği 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, ek bir IBA sinyali olarak Topics'i 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 konular

Konu verileri, kitlenizle ilgili ek bir sinyal olarak URL'ler, anahtar kelimeler veya diğer meta veriler gibi diğer sinyallerin yanında değerlendirilebilir.

Üçüncü taraf çerezlerinden sonra reklam alaka düzeyini en üst düzeye çıkarma bölümünde açıklandığı gibi, alakalı reklamlar yayınlamak için Topics'ten yararlanma konusunda çeşitli yaklaşımlar vardır. Bu yaklaşımlardan bazıları kitle oluşturmak için Topics'in kullanılmasıdır. Bazı yaklaşımlarda ise makine öğrenimi modellerini eğitmek için Topics'in diğer sinyallerden biri olarak kullanılması önerilir. Bu modelleri eğitmek, kitlenin ek ilgi alanlarını tahmin etmek ve hatta teklif verme mantığını optimize etmek için bile kullanılabilir.

Derleme ve dağıtma

  1. Üretimde kullanıcıları gözlemleyerek konuları toplayın (tahmini uygulama süresi: yaklaşık bir hafta):
    • Seçeneklerinizi anlayın: Topics'i HTTP üst bilgileri veya iframe ve JavaScript ile nasıl çağıracağınız.
    • Topics API'yi çağıracak iFrame'in alanını tanımlayın.
    • Kod referansı olarak başlık demosunu veya JavaScript demosunu kullanarak çözümünüzü oluşturun.
    • Topics'i, yayıncıların sitelerine yerleştirdikleri kodunuza (örneğin, reklam iframe'iniz) entegre edin. Yerleştirilmiş öğeden 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 sayısı az olan kendi web sitelerinizde test etmenizi öneririz. Bu aşamada, yeni konu tabanlı çö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 hiçbir konunun gözlemlenmemiş olmasıdır. Kullanıcı konularını almaya başlamak üç haftayı bulabilir.
    • İşlevsel test ve doğrulama yapın. Çözümünüzü manuel veya otomatik olarak test edebilirsiniz. Örnek:
      • Tarayıcının Topics'i daha erken yeniden hesaplaması için tarayıcınızı işaretlerle açın ve dönemi 15 saniyeye ayarlayın.
      • Komut dosyanızın yerleştirildiği siteleri ziyaret edin.
      • chrome://topics-internals/'te komut dosyanız tarafından konuların gözlemlenip gözlemlenmediğini kontrol edin.
      • Hangi sonuçları alabileceğinizi öğrenin.
  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 sonundan sonra, komut dosyanız bazı kullanıcıların konu. Bu noktada, Topics verilerini ek bir sinyal olarak kullanabilirsiniz.
    • Boş olmayan bir konu listesi almaya başladığınızda, bu listeyi diğer içerik sinyalleriyle birlikte arka ucunuza gönderebilirsiniz.

Hedef sitelere dağıtma

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

  • Topics API çağrılır.
  • Konular bu kontrollü ortamda 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ılara dağıtmadan önce kontrollü bir ortamda, sahibi olduğunuz web sitelerinde test etmenizi öneririz. Hedef web sitelerini aşağıdaki şekilde seçmenizi öneririz:

  • Site az sayıda aylık ziyaret alıyor (ayda yaklaşık bir milyondan az ziyaret): API'yi önce küçük bir kitleye dağıtarak başlamanız gerekir.
  • Sitenin sahibi ve kontrolü sizdedir: Gerekirse karmaşık onaylar olmadan uygulamayı hızlı bir şekilde devre dışı bırakabilirsiniz.
  • Site, iş açısından önemli değil: Düşük riskli hedef sitelerle başlayın.
  • Toplam en fazla beş site: Şu anda bu kadar trafiğe veya gösterime ihtiyacınız yoktur.
  • Hedef siteler farklı temaları temsil ediyor: Farklı kategorileri temsil eden web siteleri seçin (örneğin, biri spor, diğeri haber, bir diğeri de yiyecek ve içecekle ilgili). 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 site ve arayan için bu cihazın ilk aramasıysa boş bir konu dizisi [].

  • Bu kullanıcının ilgi alanlarını temsil eden sıfır ila üç konu listesi. Yedi günlük gözlemden sonra şunları alırsınız:

    • Kullanıcı için en iyi beş konu arasından seçilen bir konu. İlgili hafta boyunca arayan kullanıcı tarafından konuların gözlemlendiği sayfaların ana makine adlarından hesaplanır.

  • Önceki tüm Topics API çağrılarında olduğu gibi tam olarak aynı API yanıtı. API; aynı arayan, kullanıcı ve üst düzey site için bir dönemin tamamı için aynı konuları döndürür. Bu, kullanıcının ilgi alanlarının çok fazlasını göstermekten kaçınmaya yardımcı olur. Daha fazla bilgiyi GitHub'da bulabilirsiniz.

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

  • Son üç hafta veya daha uzun bir süre boyunca kullanıcı için konuları gözlemlemediyseniz Topics API tekrar boş bir [] dizisi döndürür.

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

  • Gelecekteki performans analizlerinde kullanılmak üzere, kaynakta farklı bir iframe içindeki Topics API'ye yapılan JavaScript çağrılarının çalışma süresi ölçülmelidir.
  • Konular alındıktan sonra, iframe ve postMessage() konu oluşturmak için harcanan süre.

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

Üretime göre ölçeklendir

Bu noktada, Topics'i kontrollü bir ortamda (sahip olduğunuz bazı sitelerde) test etmiş olmanız gerekir. Her şey beklendiği gibi çalışıyorsa bu uygulamayı ölçeklendirmenin zamanı gelmiş demektir. 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 kitlelerinizi daha iyi anlayabilirsiniz.

Üretime nasıl ölçeklendirebileceğinize dair adım adım bir özet aşağıda verilmiştir:

  1. Konuya dayalı çözümünüzü daha yüksek trafik hacminde test edin.
    • iFrame'inizi daha fazla ziyaret sayısına sahip daha fazla sayıda sahibi olduğunuz siteye 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 bir şekilde çalışmaya başladıktan sonra, iframe'inizi kendi web sitelerine entegre etmek için yayıncılarla ortak ç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).
    • Konu verilerini diğer verilerle birlikte ek bir sinyal olarak dahil edin.
    • Gerçek zamanlı teklif verme test iş ortakları bulun.
    • Diğer verilerinize ek bir sinyal olarak konularla yardımcı program testi çalıştırın.

Yük testi

Sisteminizin trafiği kaldırabilmesi için konu tabanlı çözümünüzü yayıncıların sitelerine dağıtmadan önce yük testi yapmanızı öneririz.

  1. Sahip olduğunuz daha fazla hedef sitede, özellikle de trafik hacmi daha yüksek olan sitelerde kademeli olarak dağıtın.
  2. Beklenen trafiğinize göre konu verileriniz için yük testi yapın.
    • iframe'den arka ucunuza konu bilgilerini göndermeniz gerekecektir. Bu, Topics API sonuçlarını daha ayrıntılı bir şekilde işlemenize ve kullanıcı için daha alakalı reklamlar seçmenize yardımcı olacak ek bir sinyal olarak kullanmanıza olanak tanır. Yerleştirdiğiniz site sayısı arttıkça arka ucunuza gelen çağrıların sayısı önemli ölçüde artar. Arka ucunuzun iframe'den gelen çok sayıda çağrıyı işleyebildiğinden emin olun.
    • Analiz için metrik toplamayı ve günlükleri ayarlayın.
  3. Topics API'yi dağıttıktan hemen sonra son kullanıcı sorunlarını 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.