Korunan kitle için hata ayıklama raporları

Korunan Kitle hata ayıklama raporları, reklam teknolojisi geliştiricilerinin açık artırma kazanıldığında veya kaybedildiğinde cihazlardan GET isteği almak için uzak URL'leri bildirmelerine olanak tanır. Bu, aşağıdaki kullanım alanlarını mümkün kılar:

  • Kazanılan ve kaybedilen açık artırma sonuçlarının raporlarını alın.
  • Açık artırmaların neden kaybolduğunu anlayın. Örneğin: Sorunun, teklif verme veya puanlama komut dosyası uygulaması ya da temel mantık sorunu olup olmadığını anlayın.
  • JavaScript mantığı güncellendiğinde ortaya çıkan sorunları tespit edin

Etkinlik düzeyinde hata ayıklama raporları, Özel Korumalı Alan Geliştirici Önizlemesi 9'da test etmek için kullanılabilir. Hata ayıklama raporları, Reklam Kimliğinin kullanılabildiği tüm cihazlarda desteklenir.

Uzun vadeli plan, platformun Özel Toplama hizmetiyle açık artırma sonuçlarını raporlamasını sağlamaktır. Bu, işlem sonrası raporlamanın, bireysel kullanıcıların özel kitlelerini yayıncının uygulamasıyla birleştirmek için kullanılamamasını sağlar. Etkinlik düzeyinde raporlama, yeterli bir raporlama çerçevesi yayınlanana kadar geçicidir.

Chrome'un orijinal FLEDGE kaynak denemesi teklifinde hata ayıklama raporları hakkında daha fazla bilgi edinin.

Kullanım

Hata ayıklama raporlaması, aşağıdaki JavaScript API'leri kullanılarak uygulanır. Her ikisi de bir URL dizesi bağımsız değişkeni alır:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

Aşağıdaki örnekte, kazanan teklif ve bir dahili değişken içeren reklam açık artırması kaybı bildirilmektedir. Bu veriler daha sonra hata ayıklama amacıyla kullanılabilir.

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

${winningBid} şablonu, açık artırma tamamlandıktan sonra gerçek değerle değiştirilir.

Satıcılar isteğe bağlı olarak scoreAds işlevinden bir rejectReason döndürebilir:

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

Satıcı reddetme nedeni belirtmezse bunun yerine not-available gönderilir.

URL değişkenleri

Hata ayıklama URL'sine eklenebilecek değişkenler, Chrome'daki karşılıklarına karşılık gelir (yine de Android'de bileşen açık artırmaları kavramı olmadığından ${topLevelWinningBid} ve ${topLevelMadeWinningBid} kullanılamaz).

Değişken adı Açıklama
winningBid Kazanan teklifin değeri.
madeWinningBid Bu özel kitlenin alıcısının kazanan teklifi, bu özel kitleden mi yoksa aynı alıcıyla başka bir özel kitleden mi yaptığını gösteren boole değeridir.
highestScoringOtherBid Satıcının scoreAd komut dosyası tarafından ikinci en yüksek olarak puanlanan teklifin değeri. Puanlar ve teklifler bağımsız olabileceğinden, bunun ikinci en yüksek teklif değeri olmayabileceğini unutmayın.
madeHighestScoringOtherBid Bu özel kitlenin alıcısının ${highestScoringOtherBid} teklifini bu özel kitleden mi yoksa aynı alıcıdan başka bir özel kitleden mi yaptığını gösteren boole değeridir.
rejectReason Satıcının bir teklifi neden reddettiğini açıklayan, isteğe bağlı olarak ayarlanan bir dize. Aşağıdaki değerlerden herhangi biri olabilir:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

Sınırlamalar

  • URL ana makinesi, kayıtlı Özel Korumalı Alan alanınızla eşleşmelidir.
  • URL; alan, https:// öneki ve değiştirilen açık artırma verileri dahil olmak üzere 4096 karakteri aşmamalıdır.
  • Gelecekteki sürümlerde hata ayıklama ping'leri yalnızca kablosuz ağa bağlıyken gönderilir.

Cihaz üzerindeki davranış

Mobil ortamlarda, belleği ve ağ kullanımını korumak temel önceliklerden biridir. Bu nedenle, hata ayıklama raporları gruplar halinde gerçekleşir.

Aşağıdaki sistem özellikleri, geliştirme için daha düşük değerlere ayarlanabilen grup oranını ve boyutunu kontrol eder:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Hata ayıklama raporunun beklenen gecikme süresi, açık artırma tamamlandıktan sonra 15-60 dakikadır.

Hata ayıklama raporlarının eksiksiz olması konusunda kesin bir garanti verilmez. Sunucuya yapılan çağrılar gönderilmeden önce cihaz yeniden başlatılırsa veya reklam hizmetleri işlemi kilitlenirse bu etkinlikler atlanır.

Her reklam teknolojisinin açık artırma başına maksimum 75 kayıtlı hata ayıklama URL'si sınırı vardır. Bu sınıra ulaşıldıktan sonra kaydedilen URL'ler sessizce çıkarılır.

Son olarak, kullanıcı AdId'ni devre dışı bıraktıysa hata ayıklama raporları gönderilir. Bu özellik, Geliştirici Önizlemesi 9'da uygulanmamaktadır, ancak gelecekteki sürümlerde uygulanacaktır.

Reklam teknolojisi sunucusu davranışı

Reklam teknolojisi sunucuları, hata ayıklama raporlaması için aşağıdaki davranışlara sahip olmalıdır:

  • Cihaz, forDebuggingOnly.* API'leriyle belirttiğiniz sunucuya GET istekleri gönderir.
  • Her istek, etkinlik düzeyinde tek bir hata ayıklama raporunu temsil eder: tek bir reklam açık artırması kazancı veya açık artırma kaybı.
  • Her isteğin gövdesi yok. Tüm veriler sorgu parametrelerindedir.
  • Büyük yanıt yükleri, performansı ve veri kullanımını olumsuz yönde etkileyebilir ve göz ardı edilir.