Korunan kitle için hata ayıklama raporları

Protected Audience hata ayıklama raporlaması, reklam teknolojisi geliştiricilerinin uzaktan Açık artırma kazanıldığında veya kaybedildiğinde cihazlardan GET isteği alacak URL'ler. Bu aşağıdaki kullanım alanlarına olanak tanır:

  • Kazanılan ve kaybedilen açık artırma sonuçlarıyla ilgili raporlar alın.
  • Açık artırmaların neden kaybedildiğini öğrenin. Örneğin: Bunun bir sorun olup olmadığını anlama bir teklifli sistem veya puanlama komut dosyası uygulamasıyla ya da temel mantık sorunuyla karşılaşabilirsiniz.
  • JavaScript mantığı güncellendiğinde ortaya çıkan sorunları tespit etme

Etkinlik düzeyinde hata ayıklama raporları, Özel Korumalı Alan'da test etmek için kullanılabilir Geliştirici Önizlemesi 9. Hata ayıklama raporları, AdID'nin şu olduğu tüm cihazlarda desteklenir: kullanılabilir.

Uzun vadeli plan, platformun açık artırma sonuçlarını en alakalı Özel Toplama hizmeti. Bu sayede, olaydan sonra raporlama tek tek kullanıcıların özel kitlelerine katılmak için kullanılamaz. yayıncısına ait uygulamadır. Etkinlik düzeyinde raporlama, yeterli raporlama düzeyine ulaşana kadar geçicidir. çerçeve yayınlanır.

Chrome'un orijinal FLEDGE kaynak denemesinde hata ayıklama raporlaması hakkında daha fazla bilgi teklife bakın.

Kullanım

Hata ayıklama raporlaması, Bunlar bir URL dizesi bağımsız değişkeni alır:

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

Aşağıdaki örnekte kazanan teklifin sahibi olan bir reklam açık artırması kaybı ve dahili değişken. 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ırmadır.

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

URL değişkenleri

Hata ayıklama URL'sine eklenebilecek değişkenler eşdeğerleridir (yine de ${topLevelWinningBid} ve Bileşen kavramı olmadığından ${topLevelMadeWinningBid} kullanılamıyor açık artırmaları) kaldırın.

Değişken adı Açıklama
winningBid Kazanan teklifin değeri.
madeWinningBid Bu özel alıcının alıcı olup olmadığını temsil eden boole değeri kazanan teklifi bu özel kitle veya başka bir kitle tarafından vermiştir özel bir kitle oluşturabilirsiniz.
highestScoringOtherBid 2022'de en yüksek ikinci olarak puanlanan teklifin değeri Satıcının scoreAd komut dosyası. Bu teklifin en yüksek ikinci teklif olmayabileceğini unutmayın değerini belirtmesi gerekir. Çünkü puanlar ve teklifler bağımsız olabilir.
madeHighestScoringOtherBid Bu özel kitlenin alıcısının olup olmadığını temsil eden boole değeri ya da bu özel işlemle ${highestScoringOtherBid} tutarında teklif verdi. veya aynı alıcıya sahip başka bir özel kitle olabilir.
rejectReason Satıcının bir reklamı neden reddettiğini açıklayan, isteğe bağlı olarak teklif verirsiniz. 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 adınızla eşleşmelidir.
  • URL; alan adı ve https:// dahil olmak üzere 4096 karakteri aşmamalıdır. önek ve değiştirilen açık artırma verilerini içerir.
  • Gelecekteki sürümlerde, hata ayıklama ping'leri yalnızca kablosuz ağa bağlıyken gönderilir.

Cihaz üzerindeki davranış

Mobil ortamda, bellek ve ağ kullanımının korunması temel önceliktir. Bu nedenle, hata ayıklama raporları gruplar halinde gerçekleşir.

Aşağıdaki sistem özellikleri, toplu kullanım oranını ve boyutunu kontrol eder. geliştirme için daha düşük değerlere ayarlanır:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Hata ayıklama raporunun beklenen gecikmesi, açık artırmadan sonraki 15-60 dakika arasındadır tamamlandı.

Hata ayıklama raporlarının eksiksiz olması konusunda kesin bir garanti verilmez. Cihaz sunucuya çağrı gönderilmeden önce yeniden başlatılması veya reklam hizmetleri işleminin çöktüğünü, 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. URL'ler belirtilen sınıra ulaşıldıktan sonra kaydedilen kayıtlar sessizce iptal edilir.

Son olarak, kullanıcı AdId'yi devre dışı bıraktıysa hata ayıklama raporları gönderilir. Bu Geliştirici Önizlemesi 9'da uygulanmadı, ancak gelecekte uygulanacak sürümleri vardı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'leri
  • Her istek, etkinlik düzeyinde tek bir hata ayıklama raporunu temsil eder: Tek bir reklam açık artırması kaybetme ihtimalini ifade eder.
  • Her isteğin gövdesi yoktur. Tüm veriler sorgu parametrelerinde yer alır.
  • Büyük yanıt yükleri, performansı ve veri kullanımını olumsuz yönde etkileyebilir ve yok sayılır.