Protected Audience API açık artırma sonuçları hakkında rapor oluşturma

Protected Audience API açık artırma raporları oluşturmak için satıcı ve alıcı rehberi.

Bu makale, şunun için rapor oluşturmayla ilgili teknik bir referanstır: Deneme sürümünün mevcut yinelemesinde kullanılan Protected Audience API açık artırması kazananları Protected Audience API.

Kullanım ömrü boyunca geliştirici kılavuzunu okuyun döngüsünü takip edebilir ve Protected Audience API açıklayıcısına göz atarak etkinlik düzeyinde raporlama (geçici).

Geliştirici değil misiniz? Protected Audience API API'ye genel bakış sayfasını inceleyin.

Protected Audience API raporu nedir?

İki kullanılabilir Protected Audience API raporu vardır:

  • Satıcı raporu: Reklam açık artırmasının kazananı satıcıyı bilgilendirir.
  • Alıcı raporu: Yalnızca kazanan alıcılar tarafından, açık artırmayı kazandığını öğrenmek için kullanılabilir.

Uzun vadeli plan, tarayıcının açık artırma sonuçlarını rapor etmesine izin vermektir. Private Aggregation API API'lerine sahip satıcılar ve alıcılar. Etkinlik düzeyinde geçici bir bildirme mekanizması olarak, Satıcı için reportResult() ve kazanan teklif veren için reportWin() sendReportTo() işlevini çağırın. Bu işlem tek bir bağımsız değişken alır: açık artırma tamamlandıktan sonra getirilen bir URL'yi temsil eder. Bu URL, raporlanacak etkinlik düzeyindeki bilgiler.

API işlevleri

Satıcı: reportResult()

Satıcının decisionLogicUrl içinde sağlanan JavaScript'i (ayrıca scoreAd()), açık artırmayı bildirmek için reportResult() işlevi içerebilir yardımcı olur.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

Bu işleve iletilen bağımsız değişkenler şunlardır:

auctionConfig

Açık artırma yapılandırma nesnesi navigator.runAdAuction() işlevine aktarıldı.

browserSignals

Açık artırma hakkında bilgi sağlayan, tarayıcı tarafından oluşturulan bir nesne. Örneğin:

  {
    'topWindowHostname': 'publisher.example',
    'interestGroupOwner': 'https://dsp.example',
    'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
    'bid': <bidValue>,
    'desirability': <winningAdScore>
  }

Bu işlevin döndürülen değeri,sellerSignals kazanan teklif verenin reportWin() işlevi.

Alıcı: reportWin()

Kazanan teklif verenin JavaScript'i (ayrıca generateBid() sağlamıştır) açık artırma sonucunu bildirmek için bir reportWin() işlevi ekleyin.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}

Bu işleve iletilen bağımsız değişkenler şunlardır:

auctionSignals ve perBuyerSignals

Kazanan için aynı değerler generateBid() adlı reklam kaynağına iletildi teklif vereni de içerir.

sellerSignals

reportResult() için döndürülen değer. Bu değer, satıcıya alıcıya bilgi iletme fırsatı sunar.

browserSignals

Açık artırma hakkında bilgi sağlayan, tarayıcı tarafından oluşturulan bir nesne. Örneğin:

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid': <bidValue>
}

Geçici raporlama uygulaması

Chrome'da açık artırma raporlaması için geçici olarak kullanılabilen iki yöntem vardır:

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

Bu yöntemlerin her biri tek bir bağımsız değişken alır: açık artırma sonrasında getirilecek bir URL tamamlandı. Hem scoreAd() hem de scoreAd() dahil olmak üzere birden çok kez çağrılabilirler. Farklı URL bağımsız değişkenleriyle generateBid().

Chrome, yalnızca bir açık artırma tamamlanıncaya kadar hata ayıklama kayıp/kazanma raporları gönderir. Eğer açık artırma iptal edildiğinde (örneğin, yeni gezinme nedeniyle) hiçbir rapor oluşturabilirsiniz.

Bu yöntemler, chrome://settings/adPrivacy altındaki tüm Reklam gizliliği API'lerini etkinleştirdiğinizde Chrome'da varsayılan olarak kullanılabilir. Koşu Protected Audience API'yi etkinleştirmek için komut satırı işaretlerine sahip Chrome'da, BiddingAndScoringDebugReportingAPI işaretini ekleyerek yöntemleri açıkça etkinleştirmeniz gerekir. İşaret etkinleştirilmezse yöntemler kullanılabilir durumda kalır ancak hiçbir şey yapılmaz.

Tüm Protected Audience API referansları

API referans kılavuzları mevcuttur:

Protected Audience API açıklayıcısı da özellik desteği ve kısıtlamalar hakkında ayrıntılı bilgi sağlar.

Sonraki adım

Herkesin yararlanabileceği bir API geliştirdiğimizden emin olmak için sizinle görüşmeler yapmak istiyoruz.

API'yi tartışın

Diğer Özel Korumalı Alan API'lerinde olduğu gibi bu API de belgelenmiş ve herkese açık olarak tartışılmıştır.

API ile deneme yapma

Protected Audience API hakkında denemeler yapabilir ve görüşmelere katılabilirsiniz.