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, aşağıdaki kullanım alanlarını sağlar:

  • Kazanılan ve kaybedilen açık artırma sonuçlarıyla ilgili raporlar alın.
  • Açık artırmaların neden kaybedildiğini anlayın. Örneğin: Sorunun teklif verme veya puanlama komut dosyası uygulamasıyla ilgili mi yoksa temel mantıkla ilgili mi 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ı raporlamasını sağlamaktır. Bu sayede, tek tek kullanıcıların özel kitlelerini yayıncının uygulamasına katılmak için sonradan raporlamanın kullanılamamasını sağlar. Yeterli bir raporlama çerçevesi yayınlanana kadar etkinlik düzeyinde raporlama geçicidir.

[Chrome'un orijinal FLEDGE kaynak deneme önerisindeki 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 dahili bir değişkenle 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);

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

Satıcılar isteğe bağlı olarak scoreAds işlevlerinden 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ı ret nedeni belirlemezse bunun yerine not-available gönderilir.

URL değişkenleri

Hata ayıklama URL'sine eklenebilecek değişkenler Chrome'daki benzerlerine karşılık 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, kazanan teklifi bu özel kitle veya aynı alıcıya sahip başka bir özel kitle üzerinden verip vermediğini temsil eden bir boole değeri.
highestScoringOtherBid Satıcının scoreAd komut dosyası tarafından ikinci en yüksek puanı alan 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 kitle veya aynı alıcıya sahip başka bir özel kitle üzerinden verip vermediğini temsil eden bir boole değeri.
rejectReason Satıcının isteğe bağlı olarak belirlediği ve bir teklifi neden reddettiğini açıklayan 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 barındırıcısı, kayıtlı Özel Korumalı Alan alanınızla eşleşmelidir.
  • URL; alan adı, https://önek ve değiştirilmiş 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 belleği ve ağ kullanımını korumak temel önceliktir. Bu nedenle, hata ayıklama raporları toplu olarak gönderilir.

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

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Hata ayıklama raporunun beklenen gecikmesi, açık artırmanın tamamlanmasından 15-60 dakika sonradır.

Hata ayıklama raporlarının eksiksizliği konusunda kesin bir garanti yoktur. Cihaz yeniden başlatılırsa veya adservices işlemi, sunucuya çağrı gönderilmeden önce kilitlenirse bu etkinlikler atlanır.

Her reklam teknolojisi için 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ığında kayıtlı URL'ler sessizce kaldırı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 istekte gövde yoktur. Tüm veriler sorgu parametrelerindedir.
  • Büyük yanıt yükleri performansı ve veri kullanımını olumsuz yönde etkileyebilir ve yoksayılır.