Offerte in Protected Audience

Implementazione dei deal, noti anche come marketplace privato (PMP), in un'asta Protected Audience

Panoramica

I deal, noti anche come marketplace privato (PMP), offrono agli acquirenti un accesso selezionato o prezzi scontati a un sottoinsieme di inventario. Per semplificare i deal programmatici, vengono utilizzati gli ID postazione e gli ID deal:

  • Un ID postazione proviene dall'acquirente ed è un identificatore che rappresenta il cliente dell'acquirente. Un ID utenza potrebbe avere implicazioni per la fatturazione, ad esempio se un'utenza ha uno sconto con un determinato venditore.
  • Un ID deal proviene dall'acquirente o dal venditore ed è un identificatore che rappresenta un contratto tra un acquirente e un venditore. Un ID deal può avere proprietà quali costo/prezzo, impegno di volume, informazioni sul pubblico, esclusività e altro ancora.

Protected Audience semplifica i deal utilizzando gli ID report, che consentono di rendere disponibili gli ID account e deal per le offerte nelle aste, il calcolo del punteggio e la generazione di report. Gli ID report forniscono alle società di tecnologia pubblicitaria un meccanismo per ricevere questi ID deal e seat nei report post-asta di Protected Audience al fine di effettuare transazioni sui deal e organizzare le attività di fatturazione. Ci aspettiamo che acquirenti, venditori, agenzie e inserzionisti possano avere strategie personalizzate per interpretare e comprendere gli ID deal e seat che ricevono.

Procedura dettagliata

I passaggi per facilitare i deal in un'asta Protected Audience sono i seguenti:

  1. L'acquirente registra gli ID deal e seat nella configurazione del gruppo di interesse prima dell'esecuzione dell'asta
    • Gli ID deal e utenze possono essere impostati nel campo ID report selezionabili (selectableBuyerAndSellerReportingIds).
    • Se l'ID posto è lo stesso per tutti i deal, puoi impostarlo in buyerAndSellerReportingId e gli ID deal nel campo ID report selezionabili (selectableBuyerAndSellerReportingIds).
  2. Durante la generazione dell'offerta, gli ID deal e utenza diventano disponibili. L'acquirente seleziona un ID deal da selectableBuyerAndSellerReportingIds. L'acquirente genera un'offerta che include un ID deal associato all'offerta restituendo un selectedBuyerAndSellerReportingId. Un'offerta può vincere l'asta solo se l'ID deal restituito è k-anonymous insieme ad altri ID report e a determinate proprietà del gruppo di interesse.
  3. Durante la valutazione degli annunci, gli ID deal e seat selezionati diventano disponibili per il venditore.
  4. Gli ID deal e utenza diventano disponibili nelle funzioni di generazione dei report del venditore.
  5. Gli ID deal e utenza diventano disponibili nelle funzioni di generazione dei report dell'acquirente.

1. Registrazione di ID deal e utenze

L'acquirente registra gli ID deal e seat nella configurazione del gruppo di interesse prima dell'esecuzione dell'asta. Gli ID deal e utenza sono impostati in selectableBuyerAndSellerReportingIds come un array di stringhe. Se l'ID posto è lo stesso per tutti i deal e non è necessario ripeterlo, l'ID posto può essere aggiunto nel campo buyerAndSellerReportingId che accetta una stringa:

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
      buyerReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

Se l'ID posto è diverso per i deal, puoi utilizzare la seguente configurazione:

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. ID deal e postazioni per gli acquirenti durante la generazione delle offerte

Durante la generazione dell'offerta, l'acquirente decide se vuole fare offerte per un ID deal. In generateBid(), l'acquirente può selezionare un ID deal da selectableBuyerAndSellerReportingIds e restituire il valore come selectedBuyerAndSellerReportingId. L'offerta viene rifiutata se l'ID deal selezionato non è nell'array selectableBuyerAndSellerReportingIds.

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

  // ...

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

Un'offerta con un valore restituito per selectedbuyerAndSellerReportingId può vincere l'asta solo se il valore di selectedbuyerAndSellerReportingId è k-anonimo insieme a buyerAndSellerReportingId (se presente), buyerReportingId (se presente) il proprietario del gruppo di interesse, l'URL dello script di offerta, l'URL di rendering e le dimensioni dell'annuncio (le dimensioni dell'annuncio sono escluse da questo controllo almeno fino al primo trimestre del 2025).

Anche se selectablebuyerAndSellerReportingIds è definito nella configurazione del gruppo di interesse, è comunque valido per generateBid() restituire un'offerta che non include un selectedbuyerAndSellerReportingId. In questo caso, gli ID report forniti alle funzioni di generazione di report se questa offerta vinceranno seguiranno il comportamento dell'ID report non selezionabile.

Nei casi in cui generateBid() viene eseguito di nuovo perché la chiamata iniziale non ha generato offerte con annunci che hanno superato i controlli di k-anonymity, i selectableBuyerAndSellerReportingIds che non superano il controllo k-anonymity non saranno presenti nel gruppo di interesse alla nuova esecuzione.

3. ID deal e utenze per i venditori durante la valutazione degli annunci

L'ID deal selezionato, insieme a un ID postazione se presente, vengono resi accessibili a scoreAd(). Il venditore fornisce il punteggio di desiderabilità dell'offerta vincente tenendo conto dell'ID deal e di eventuali termini speciali. Se il venditore ritiene che l'ID deal scelto dall'acquirente non sia applicabile, rifiuta l'offerta assegnandole un punteggio di desiderabilità pari a zero o negativo.

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

  // ...
}

4. ID deal e postazioni per i report dei venditori

Ricorda che un'offerta può vincere l'asta solo se selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (se presente) e buyerReportingId (se presente) sono in forma anonima con il proprietario del gruppo di interesse, l'URL dello script di offerta, l'URL di rendering e le dimensioni dell'annuncio (le dimensioni dell'annuncio sono escluse da questo controllo almeno fino al primo trimestre del 2025). Di conseguenza, i valori ID report che includono un selectedBuyerAndSellerReportingId saranno sempre disponibili all'interno di reportResult(). Tieni presente che, anche se per buyerReportingId viene controllata l'anonimizzazione k, il valore è disponibile solo per la funzione di generazione di report per gli acquirenti e non per la funzione di generazione di report per i venditori.

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

  // ...
}

5. ID deal e utenze per i report sugli acquirenti

Lo stesso concetto dei report per i venditori si applica ai report per gli acquirenti. Ricorda che un'offerta può vincere l'asta solo se selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (se presenti) e buyerReportingId (se presenti) sono k-anonimi con il proprietario del gruppo di interesse, l'URL dello script di offerta, l'URL di rendering e le dimensioni dell'annuncio (queste ultime sono escluse da questo controllo almeno fino al primo trimestre del 2025). Di conseguenza, i valori degli ID report che includono un elemento selectedBuyerAndSellerReportingId saranno sempre disponibili in reportWin().

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

Coinvolgere e condividere feedback