Korunan kitle için hata ayıklama raporları

Protected Audience hata ayıklama raporları, reklam teknolojisi geliştiricilerin bir açık artırma kazanıldığında veya kaybedildiğinde cihazlardan GET isteği almak için uzak URL'ler bildirmesine olanak tanır. Bu sayede aşağıdaki kullanım alanları etkinleştirilir:

  • Kazanılan ve kaybedilen açık artırma sonuçlarıyla ilgili raporlar alma.
  • Açık artırmaların neden kaybedildiğini anlayın. Örneğin: Teklif verme veya puanlama komut dosyası uygulamasıyla ilgili bir sorun mu yoksa temel mantıkla ilgili bir sorun mu olduğunu anlayın.
  • JavaScript mantığı güncellendiğinde sorunları keşfetme

Etkinlik düzeyinde hata ayıklama raporları, Özel Korumalı Alan Geliştirici Önizlemesi 9'da test edilebilir. Hata ayıklama raporlaması, AdId'nin kullanılabildiği tüm cihazlarda desteklenir.

Uzun vadeli plan, platformun Özel Toplama Hizmeti ile açık artırma sonuçlarını bildirmesini sağlamaktır. Bu, sonradan yapılan raporlamanın, tek tek kullanıcıların özel kitlelerini yayıncının uygulamasına 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 raporlaması][10] hakkında daha fazla bilgi edinin.

Kullanım

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

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

Aşağıdaki örnekte, kazanan teklif ve bir dahili değişkenle birlikte bir reklam açık artırması kaybı raporlanmaktadır. 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, scoreAds işlevlerinden isteğe bağlı olarak 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ı bir ret nedeni belirlemezse bunun yerine not-available gönderilir.

URL değişkenleri

Hata ayıklama URL'sine eklenebilen değişkenler, Chrome'daki karşılıklarına denk gelir (Android'de bileşen açık artırması 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, bu özel kitle veya aynı alıcıya sahip başka bir özel kitle aracılığıyla kazanan teklifi verip vermediğini gösteren bir Boole değeri.
highestScoringOtherBid Satıcının scoreAd komut dosyası tarafından en yüksek ikinci puanı alan teklifin değeri. Puanlar ve teklifler birbirinden 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, bu özel kitle veya aynı alıcıya sahip başka bir özel kitle aracılığıyla ${highestScoringOtherBid} teklifini verip vermediğini gösteren bir Boole değeri.
rejectReason Bir satıcı tarafından isteğe bağlı olarak ayarlanan ve teklifi neden reddettiğini açıklayan 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 adı, https:// öneki ve değiştirilen açık artırma verileri dahil olmak üzere 4.096 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 üzerinde davranış

Mobil ortamda bellek ve ağ kullanımını korumak temel önceliktir. Bu nedenle, hata ayıklama raporları toplu olarak oluşturulur.

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

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Bir açık artırma tamamlandıktan sonra hata ayıklama raporunun gecikme süresinin 15-60 dakika olması beklenir.

Hata ayıklama raporlarının eksiksizliği konusunda kesin bir garanti verilmez. Cihaz yeniden başlatılırsa veya sunucuya yapılan çağrılar gönderilmeden önce adservices işlemi kilitlenirse bu etkinlikler bırakılır.

Her reklam teknolojisinin, açık artırma başına en fazla 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 bırakılır.

Son olarak, kullanıcı AdId'yi devre dışı bıraktıysa hata ayıklama raporları gönderilir. Bu özellik, Developer Preview 9'da uygulanmamıştı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, tek bir etkinlik düzeyinde hata ayıklama raporunu (tek bir reklam açık artırması kazanımı veya açık artırma kaybı) temsil eder.
  • Her isteğin gövdesi yoktur. Tüm veriler sorgu parametrelerindedir.
  • Büyük yanıt yükleri performansı ve veri kullanımını olumsuz etkileyebilir ve yok sayılır.