Yayıncının sayfasında bir reklam açık artırması oluşturun

Protected Audience API açık artırmasını nasıl yapılandıracağınızı öğrenin.

Satıcılar tarafından cihaz üzerinde yürütülen açık artırmalar

Cihaz üzerinde Protected Audience açık artırması, reklam alanı satan bir sitede gerçekleşir. Açık artırmayı yapan tarafa satıcı diyoruz. Birçok taraf satıcı olarak hareket edebilir: Bir site kendi reklam açık artırmasını yürütebilir, açık artırmayı kendisi için yürütecek bir üçüncü taraf komut dosyası içerebilir veya cihaz üzerinde açık artırma yürütmeyi diğer sunucu tarafı reklam açık artırması etkinlikleriyle birleştiren bir SSP kullanabilir. Satıcıların cihaz üzerinde reklam açık artırmasında üç temel görevi vardır:

1. Satıcılar (a) hangi alıcıların katılabileceğine ve (b) bu alıcıların ilgi gruplarından gelen hangi tekliflerin açık artırmaya girmeye uygun olduğuna karar verir. Bu sayede satıcı, sayfada hangi reklamların görünmesine izin verileceğiyle ilgili site kurallarını uygulayabilir.
2. Satıcılar, açık artırmanın iş mantığından sorumludur: Her teklifin fiyatını ve meta verilerini dikkate alan ve bir "istenirlik" puanı hesaplayan JavaScript kodu. En yüksek uygunluk puanına sahip teklif açık artırmayı kazanır.
3. Satıcılar, açık artırma sonucuyla ilgili raporlama yapar. Bu raporlama, ödeme fiyatı ve diğer ödemelerle ilgili bilgileri içerir. Kazanan ve kaybeden alıcılar da kendi raporlarını oluşturabilir.

Bu belgede, cihaz üzerinde açık artırmanın nasıl yapılandırılacağı ve başlatılacağı açıklanmaktadır.

Protected Audience API reklam açık artırması yapılandırma

Protected Audience API reklam açık artırması çalıştırmak için ilk adım, açık artırmayı yapılandırmaktır. Bu işlem, auctionConfig nesnesi oluşturularak yapılır. Bu tür bir yapılandırmaya örnek:

const auctionConfig = {
  seller: 'https://seller.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://buyer-1.example', 'https://buyer-2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://buyer-1.example': {...},
    'https://buyer-2.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://buyer-1.example': 50,
    'https://buyer-2.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://component-seller.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ],
  resolveToConfig: [true|false],
};

AuctionConfig tesis

Zorunlu özellikler

auctionConfigs için yalnızca seller, decisionLogicUrl ve interestGroupBuyers özellikleri gereklidir.

İsteğe bağlı özellikler

auctionConfigs için kalan özellikler isteğe bağlıdır.

Sinyalleri eşzamansız olarak sağlama

Bazı sinyallerin değerleri (auctionSignals, sellerSignals, perBuyerSignals ve perBuyerTimeouts alanları tarafından yapılandırılanlar) isteğe bağlı olarak somut değerler yerine Promises olarak sağlanabilir. Bu, açık artırmanın bazı bölümlerinin (ör. komut dosyalarının ve güvenilir sinyallerin yüklenmesi, yalıtılmış iş parçacığı süreçlerinin başlatılması) bu değerlerin hesaplanması (veya ağdan alınması) ile çakışmasına olanak tanır. İşletim birimi komut dosyaları yalnızca çözümlenen değerleri görür. Bu tür bir Promise reddedilirse açık artırma, zaten başarısız olmadıysa veya başka şekillerde iptal edilmediyse iptal edilir.

Birden fazla satıcıyla açık artırma yapılandırma

Bazı durumlarda, birden fazla satıcı bir açık artırmaya katılmak isteyebilir. Ayrı açık artırmaların kazananları, başka bir satıcı tarafından yürütülen başka bir açık artırmaya aktarılır. Bu ayrı açık artırmalara bileşen açık artırmaları denir. Bu bileşen açık artırmalarını kolaylaştırmak için componentAuctions nesnesi, her satıcının bileşen açık artırması için ek açık artırma yapılandırmaları içerebilir. Bu bileşen açık artırmalarının her birindeki kazanan teklif, açık artırmanın nihai sonucunu belirleyen "üst düzey" açık artırmaya iletilir. Bileşen açık artırmalarının auctionConfig kendi componentAuctions olmayabilir. componentAuctions boş değilse interestGroupBuyers boş olmalıdır. Yani, herhangi bir Protected Audience açık artırmasında tek bir satıcı vardır ve bileşen açık artırması yoktur ya da tüm teklifler bileşen açık artırmalarından gelir ve üst düzey açık artırma yalnızca bileşen açık artırmalarının kazananları arasından seçim yapabilir.

Açık artırmayı çalıştırma

Satıcı, navigator.runAdAuction() işlevini çağırarak reklam açık artırması başlatmak için kullanıcının tarayıcısına istek gönderir.

try {
  const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
  // Handle error.
}

runAdAuction() çağrısı, reklamla sonuçlanan bir Promise döndürür. Yayıncı sayfasındaki hiçbir kodun, kazanan reklamı incelemesi veya runAdAuction() sonucundan içeriği hakkında bilgi edinmesi mümkün değildir. resolveToConfig işaretinin AuctionConfig içinde true olarak ayarlanması durumunda, yalnızca sınırlı bir çerçevede oluşturulabilen bir FencedFrameConfig nesnesi döndürülür. İşaret yanlış olarak ayarlanırsa bir iFrame'de oluşturulabilen opak bir URN döndürülür. runAdAuction işlevinin boş değer döndürmesi ve hiçbir reklamın seçilmediğini belirtmesi mümkündür. Bu durumda satıcı, içeriğe dayalı hedeflenmiş bir reklam yayınlamayı seçebilir.