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

bookmark_border Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

Satıcılar tarafından gerçekleştirilen cihaz üzerinde açık artırmalar

Reklam alanı satan bir sitede cihaz üzerinde Protected Audience açık artırması yapılıyor. açık artırmayı yürüten tarafa satıcı olarak atıfta bulunulmalıdır. Pek çok taraf, bir projeyi satıcılar: bir site kendi reklam açık artırmasını yürütebilir veya üçüncü taraf bir reklam içerebilir komut dosyası kullanabilir veya açık artırmayı birleştiren bir STP kullanabilir sunucu tarafında yapılan diğer reklam açık artırma etkinlikleriyle cihaz üzerinde açık artırmadır. Satıcılar cihaz üzerinde reklam açık artırmasında üç temel iş vardır:

1. (a) Hangi alıcıların katılabileceğine ve (b) tekliflerden hangilerinin tekliflerine Satıcılar karar verir? bu alıcıların ilgi alanı gruplarının açık artırmaya girmeye uygun olması gerekir. Bu şekilde web sitesinde hangi reklamların görünmesine izin verileceğine ilişkin site kurallarını sayfasını ziyaret edin.
2. Açık artırmanın iş mantığından satıcılar sorumludur: JavaScript her teklifin fiyatını ve meta verilerini dikkate alan ve "istenebilirlik" puanı. İstenebilirlik puanı en yüksek olan teklif, açık artırmadır.
3. Satıcılar, açık artırma sonucu hakkında raporlar hazırlar. Bu raporlardaki bilgiler arasında şunlar yer alır: ve diğer ödemeler dahil edilir. Kazanan ve kaybeden alıcılar da kendi raporlamalarını yapabilirler.

Bu belgede, cihaz üzerinde açık artırmanın nasıl yapılandırılıp 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ı gerçekleştirmek için ilk adım açık artırmayı yapılandırın. Bu işlem, bir auctionConfig nesnesi oluşturarak gerçekleştirilir. Bu tür bir yapılandırma örneği aşağıda verilmiştir:

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 zorunlu olan özellikler yalnızca seller, decisionLogicUrl ve interestGroupBuyers.

İ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 tarafından yapılandırılanlar, sellerSignals, perBuyerSignals ve perBuyerTimeouts alanları) isteğe bağlı olarak somut değerler olarak değil, Vaatler şeklinde sağlanabilir. Bu, açık artırmanın bazı bölümlerinde (ör. komut dosyalarının ve güvenilir sinyallerin yüklenmesi) ve hesaplama (veya ağ) ile çakışmak için yalıtılmış iş akışı işlemlerinin başlatılması alınması). İş uygulaması komut dosyaları yalnızca çözülmüş değerler; Söz konusu Vaat reddedilirse, söz konusu Vaat reddedilirse açık artırma iptal edilir. veya başka şekillerde iptal edilmiş olabilirler.

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

Bazı durumlarda, birden fazla satıcı açık artırmaya katılmak isteyebilir. başka bir açık artırmaya aktarılan ayrı açık artırmaların kazananları satıcıdır. Tamamlanmayan 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 şunları içerebilir: Her satıcının bileşen açık artırması için ek açık artırma yapılandırmaları. İlgili içeriği oluşturmak için kullanılan her birinin kazanan teklifi, ilgili teklif simülasyon aracından "üst düzey" en son kararı veren açık artırmadır. İlgili içeriği oluşturmak için kullanılan Bileşen açık artırmalarının auctionConfig kadarı kendi açık artırmalarına sahip olmayabilir componentAuctions. componentAuctions boş olmadığında interestGroupBuyers boş olmalıdır. Yani belirli bir Korumalı Alan Kitle açık artırması, tek bir satıcı varken bileşen açık artırmaları yokken veya Aksi takdirde, 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ı" arasından kazananlar.

Açık artırmayı yürüt

Satıcı, kullanıcının tarayıcısına bir reklam açık artırmasının başlatılması için istekte bulunur. Bu istekle navigator.runAdAuction() aranıyor.

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

runAdAuction() çağrısı, reklama çözümlenen bir Vaat döndürür. değil yayıncının sayfasındaki herhangi bir kodun kazanan reklamı veya Aksi takdirde runAdAuction() sonucundan içeriği hakkında bilgi edinir. Öğe AuctionConfig içinde resolveToConfig işareti doğru değerine ayarlandı. Yalnızca çitli bir ortamda oluşturulabilecek FencedFrameConfig nesne döndürülür çerçeve. İşaret yanlış değerine ayarlanırsa opak bir URN döndürülür. iframe'de oluşturulur. runAdAuction, boş bir değer döndürebilir. herhangi bir reklam seçilmediğini gösterir. Bu durumda, satıcı İçeriğe dayalı hedeflenmiş bir reklam oluşturmak için kullanılır.