Offerte in Protected Audience

Implementare deal, noto 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 facilitare i deal programmatici, vengono utilizzati gli ID postazione e gli ID offerta:

  • 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 accordo 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 facilita i deal utilizzando gli ID report che consentono di rendere disponibili gli ID utenza e deal per le offerte nelle aste, i punteggi e i report. Gli ID report forniscono un meccanismo che consente alle aziende di ad tech di ricevere questi ID deal e utenza nei report Protected Audience successivi all'asta per effettuare transazioni dei deal e organizzare le attività di fatturazione. Ci aspettiamo che acquirenti, venditori, agenzie e inserzionisti possano utilizzare strategie su misura per interpretare e comprendere gli ID deal e utenze che ricevono.

Procedura dettagliata

Di seguito sono riportati i passaggi per facilitare i deal in un'asta Protected Audience:

  1. L'acquirente registra gli ID deal e utenza nella configurazione dei gruppi di interesse prima dell'esecuzione dell'asta
    • Gli ID deal e utenze possono essere impostati nel campo ID report selezionabili (selectableBuyerAndSellerReportingIds).
    • Se l'ID postazione è lo stesso per tutti i deal, questo ID postazione può essere impostato in buyerAndSellerReportingId, mentre gli ID deal possono essere impostati nel campo degli 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 utenze 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.
di Gemini Advanced.

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 utenza è lo stesso per tutti i deal e non deve essere ripetuto, l'ID utenza 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
      buyerAndReportingId: '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 utenze per gli acquirenti durante la generazione dell'offerta

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(..., 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
  };
}

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 dei gruppi di interesse, è comunque valido per generateBid() per restituire un'offerta che non include selectedbuyerAndSellerReportingId. in questo caso, gli ID report forniti alle funzioni di generazione dei report se l'offerta vince seguiranno il comportamento degli ID report non selezionabili.

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 non ritiene che l'ID deal scelto dall'acquirente sia applicabile, il venditore 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 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 ID report che includono un selectedBuyerAndSellerReportingId saranno sempre disponibili all'interno di reportResult(). Tieni presente che, anche se in buyerReportingId viene controllata la presenza di k-anonymity, il valore è disponibile solo per la funzione di generazione di report sugli acquirenti e non per la funzione di generazione di report sul venditore qui.

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

  // ...
}

5. ID deal e utenze per i report sugli acquirenti

Lo stesso concetto dei report sui venditori si applica ai report sugli acquirenti. 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 degli ID report che includono un elemento selectedBuyerAndSellerReportingId saranno sempre disponibili in reportWin().

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

Interagisci e condividi il feedback