Korunan Kitlede Fırsatlar

Özel Pazar Yeri (PMP) olarak da bilinen anlaşmaları Protected Audience açık artırmasında uygulama

Genel Bakış

Özel Pazar Yeri (PMP) olarak da adlandırılan anlaşmalar, envanterin bir alt kümesindeki alıcılar için seçilmiş erişim veya tercih edilen fiyatlandırma sunar. Programatik anlaşmaları kolaylaştırmak için lisans kimlikleri ve anlaşma kimlikleri kullanılır:

  • Koltuk kimliğinin kaynağı alıcıdır ve alıcının müşterisini temsil eden bir tanımlayıcıdır. Koltuk kimliği, faturalandırmayla ilgili sonuçlara yol açabilir (ör. koltuk belirli bir satıcıyla indirimliyse).
  • Anlaşma kimliği alıcı veya satıcıdan gelir ve alıcı ile satıcı arasındaki sözleşmeyi temsil eden bir tanımlayıcıdır. Anlaşma kimliği; maliyet/fiyat, hacim taahhüdü, kitle bilgileri, ayrıcalık gibi özelliklere sahip olabilir.

Protected Audience, koltuk ve anlaşma kimliklerinin açık artırma teklifi, puanlama ve raporlama için kullanılabilir hale gelmesine olanak tanıyan raporlama kimliklerini kullanarak anlaşmaları kolaylaştırır. Raporlama kimlikleri, reklam teknolojisi şirketlerinin anlaşmaları işlemek ve faturalandırma çalışmalarını düzenlemek için açık artırma sonrası Protected Audience raporlarında bu anlaşma ve kol kimliklerini almaları için bir mekanizma sağlar. Alıcıların, satıcıların, ajansların ve reklamverenlerin, aldıkları anlaşma ve lisans kimliklerini yorumlamak ve anlamak için özel stratejilere sahip olmasını bekleriz.

Adım adım açıklamalı kılavuz

Protected Audience açık artırmasında anlaşmaları kolaylaştırma adımları aşağıdaki gibidir:

  1. Alıcı, açık artırma başlamadan önce anlaşma ve lisans kimliklerini ilgi alanı grubu yapılandırmasına kaydeder
    • Anlaşma ve lisans kimlikleri, seçilebilir raporlama kimlikleri alanında (selectableBuyerAndSellerReportingIds) ayarlanabilir.
    • Lisans kimliği tüm anlaşmalar için aynıysa bu lisans kimliği buyerAndSellerReportingId içinde ayarlanabilir ve anlaşma kimlikleri seçilebilir raporlama kimlikleri alanında (selectableBuyerAndSellerReportingIds) ayarlanabilir.
  2. Teklif oluşturma sırasında anlaşma ve lisans kimlikleri kullanılabilir hale gelir. Alıcı, selectableBuyerAndSellerReportingIds içinden bir anlaşma kimliği seçer. Alıcı, selectedBuyerAndSellerReportingId değeri döndürerek bu teklifle ilişkili anlaşma kimliğini içeren bir teklif oluşturur. Bir teklif yalnızca, döndürülen anlaşma kimliği diğer raporlama kimliklerinin ve ilgi alanı grubunun belirli özelliklerinin yanı sıra k-anonim ise açık artırmayı kazanabilir.
  3. Reklam puanlaması sırasında, seçilen anlaşma ve lisans kimlikleri satıcının kullanımına açılır.
  4. Anlaşma ve lisans kimlikleri, satıcının raporlama işlevlerinde kullanılabilir hale gelir.
  5. Anlaşma ve lisans kimlikleri, alıcının raporlama işlevlerinde kullanılabilir hale gelir.

1. Anlaşma ve lisans kimliği kaydı

Alıcı, açık artırma başlamadan önce anlaşma ve lisans kimliklerini ilgi alanı grubu yapılandırmasına kaydeder. Anlaşma ve lisans kimlikleri selectableBuyerAndSellerReportingIds içinde bir dize dizisi olarak ayarlanır. Lisans kimliği tüm anlaşmalar için aynıysa ve tekrarlanması gerekmiyorsa lisans kimliği bir dizeyi kabul eden buyerAndSellerReportingId alanına eklenebilir:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

Koltuk kimliği anlaşmalar için farklıysa aşağıdaki kurulum kullanılabilir:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. Teklif oluşturma sırasında alıcılar için anlaşma ve lisans kimlikleri

Teklif oluşturma sırasında alıcı, anlaşma kimliği için teklif vermek isteyip istemediğine karar verir. generateBid() ürününde alıcı, selectableBuyerAndSellerReportingIds üzerinden bir anlaşma kimliği seçebilir ve değeri selectedBuyerAndSellerReportingId olarak döndürebilir. Seçilen anlaşma kimliği selectableBuyerAndSellerReportingIds dizisinde değilse teklif reddedilir.

function generateBid(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

selectedbuyerAndSellerReportingId için döndürülen değere sahip bir teklif, yalnızca selectedbuyerAndSellerReportingId değerinin buyerAndSellerReportingId (varsa), buyerReportingId (varsa), ilgi alanı grubu sahibi, teklif verme komut dosyası URL'si, oluşturma URL'si ve reklam boyutu (reklam boyutu en az 2025'in 1. çeyreğine kadar bu kontrole dahil edilmez) ile birlikte k-anonim olması durumunda açık artırmayı kazanabilir.

selectablebuyerAndSellerReportingIds, ilgi alanı grubu yapılandırmasında tanımlanmış olsa bile generateBid() için selectedbuyerAndSellerReportingId içermeyen bir teklif döndürmesi yine de geçerlidir. Bu durumda, bu teklifin kazanması durumunda raporlama işlevlerine sağlanan raporlama kimlikleri, seçilemeyen raporlama kimliği davranışını izler.

İlk çağrının k-anonimlik kontrollerini geçen reklamlarla herhangi bir teklif oluşturmaması nedeniyle generateBid() tekrar çalıştırıldığında, k-anonimlik kontrolünü geçemeyen selectableBuyerAndSellerReportingIds, yeniden çalıştırma sırasında ilgi alanı grubunda yer almaz.

3. Reklam puanlaması sırasında satıcılar için fırsat ve lisans kimlikleri

Seçilen anlaşma kimliği ve varsa lisans kimliği scoreAd() tarafından erişilebilir. Satıcı, anlaşma kimliğini ve tüm özel şartları göz önünde bulundurarak kazanan teklifin istenen puanını belirtir. Satıcı, alıcı tarafından seçilen anlaşma kimliğinin geçerli olduğunu düşünmüyorsa teklifi sıfır veya negatif bir talep edilebilirlik puanı vererek reddeder.

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. Satıcı raporları için anlaşma ve lisans kimlikleri

Bir teklifin açık artırmayı kazanabilmesi için selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (varsa) ve buyerReportingId (varsa) ilgi alanı grubu sahibi, teklif komut dosyası URL'si, oluşturma URL'si ve reklam boyutu ile k-anonim olması gerekir (reklam boyutu en az 2025'in 1. çeyreğine kadar bu kontrole dahil edilmez). Bu nedenle, selectedBuyerAndSellerReportingId içeren raporlama kimliği değerleri her zaman reportResult() içinde kullanılabilir. buyerReportingId, k-anonimlik açısından kontrol edilse bile değerin burada yalnızca alıcı raporlama işlevi tarafından kullanılabileceğini unutmayın.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5. Alıcı raporlaması için anlaşma ve lisans kimlikleri

Satıcı raporlarında geçerli olan kavramlar alıcı raporlarında da geçerlidir. Bir teklifin açık artırmayı kazanabilmesi için selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (varsa) ve buyerReportingId (varsa) ilgi alanı grubu sahibi, teklif komut dosyası URL'si, oluşturma URL'si ve reklam boyutu ile k-anonim olması gerekir (reklam boyutu en az 2025'in 1. çeyreğine kadar bu kontrole dahil edilmez). Bu nedenle, selectedBuyerAndSellerReportingId içeren raporlama kimliği değerleri reportWin() içinde her zaman kullanılabilir.

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

Etkileşim kurma ve geri bildirim paylaşma