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.
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:
|
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.