Utilizzare Topics con le offerte programmatiche in Protected Audience

Scopri come utilizzare gli interessi di Topics come input per la procedura di asta e di offerta di Protected Audience. Protected Audience è disponibile in diversi punti in cui l'acquirente e il venditore possono passare indicatori proprietari nel processo di offerta e asta. Gli indicatori forniti da Topics possono essere utilizzati per arricchire i dati disponibili durante il processo di offerta e di selezione degli annunci con informazioni sugli interessi attuali degli utenti, aumentando il valore potenziale dell'inventario pubblicitario.

Prima di leggere questa guida, assicurati di acquisire familiarità sia con Topics che con Protected Audience.

Visualizza argomenti

Quando chiami l'API Topics, il chiamante vedrà una selezione di argomenti che ha osservato in precedenza per quel browser.

const currentTopics = await document.browsingTopics();
// Example result
[
  {
    "configVersion": "chrome.2",
    "modelVersion": "4",
    "taxonomyVersion": "2",
    "topic": 310,
    "version": "chrome.2:2:4"
  }
]

In questo caso l'argomento: 310 è mappato a "Sport/Ciclismo".

Questi esempi mostrano i valori dell'argomento utilizzati direttamente, ma un'implementazione completa può scegliere di elaborarli o combinarli con altri dati.

Utilizzare gli argomenti per definire in modo condizionale un gruppo basato sugli interessi

L'argomento risultante può essere utilizzato direttamente per scegliere di aggiungere un utente a un gruppo basato sugli interessi.

if (currentTopics[0].topic === 310) { // Interest in "Sports/Cycling"
  const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  }
}

Fornire argomenti dell'acquirente a un gruppo di interesse

Gli argomenti correnti (o i dati elaborati al loro interno) possono essere inclusi nell'userBiddingSignals durante la creazione del gruppo basato sugli interessi. In questo modo l'acquirente può utilizzare gli argomenti quando fa offerte.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  userBiddingSignals: {
    topics: currentTopics,
    ....
  },
  ...
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Fornire gli argomenti del venditore a un'asta

Gli argomenti correnti visibili al venditore (o i dati elaborati al loro interno) possono essere inclusi in una combinazione di auctionSignals, sellerSignals o perBuyerSignals durante la configurazione dell'asta. In questo modo sia l'acquirente può utilizzare gli argomenti quando fanno offerte sia il venditore di utilizzare gli argomenti per valutare le offerte.

const myAuctionConfig = {
  seller: 'https://ssp.example',
  auctionSignals: {
    topics: currentTopics,
  },
  sellerSignals: {
    topics: currentTopics,
  },
  perBuyerSignals: {
    'https://dsp.example': {
      topics: currentTopics,
      // ...
    },
    // ...
  },
  // ...
};
const result = await navigator.runAdAuction(myAuctionConfig);

Utilizza gli argomenti quando fai offerte

Successivamente, quando viene chiamata la funzione generateBid() dell'acquirente, gli argomenti registrati trasmessi possono essere utilizzati (proprio come qualsiasi altro dato fornito negli indicatori) per facilitare le offerte. Ad esempio, l'offerente potrebbe utilizzare la presenza della colonna "Sport/Ciclismo" argomento per fare offerte più alte con questo custom-bikes gruppo di interesse.

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  const topics = interestGroup.userBiddingSignals.topics;
  // Use the topic values in the bidding logic.
}

Utilizza gli argomenti per assegnare un punteggio alle offerte

Dopo aver fatto un'offerta, quando viene chiamata la funzione scoreAd() del venditore, gli argomenti registrati possono essere utilizzati come qualsiasi altro dato trasmesso dalla configurazione dell'asta. Ad esempio, il venditore potrebbe decidere di aumentare la ponderazione delle offerte per gli annunci che corrispondono agli argomenti rilevati.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals, directFromSellerSignals) {
  const sellerTopics = actionConfig.auctionSignals.topics;
  // or corresponding key in sellerSignals
  // use the topics values to score the ads
  //...
}