Usa Topics con ofertas programáticas en Protected Audience

Aprende a usar los intereses de Topics como una entrada para el proceso de ofertas y subastas de Protected Audience. Protected Audience tiene varios puntos en los que el comprador y el vendedor pueden pasar indicadores propios a los procesos de ofertas y subastas. Los indicadores que proporciona Topics se pueden usar para enriquecer los datos disponibles durante el proceso de selección de anuncios y ofertas con información sobre los intereses actuales de los usuarios, lo que aumenta el valor potencial del inventario de anuncios.

Antes de leer esta guía, asegúrate de familiarizarte con Topics y Protected Audience.

Obtener temas

Cuando llame a la API de Topics, el llamador verá una selección de los temas que observó anteriormente para ese navegador.

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

En este tema de caso: 310 se asigna a "Deportes/ciclismo".

Estos ejemplos muestran que los valores de tema se usan directamente, pero una implementación completa puede optar por procesarlos o combinarlos con otros datos.

Cómo usar temas para definir condicionalmente un grupo de interés

El tema resultante se puede usar directamente para agregar un usuario a un grupo de interés.

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

Proporciona temas de compradores a un grupo de interés

Los temas actuales (o los datos procesados a partir de ellos) se pueden incluir en la userBiddingSignals cuando se crea el grupo de interés. Esto le permite al comprador usar temas cuando hace ofertas.

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

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Cómo proporcionar temas del vendedor en una subasta

Los temas actuales visibles para el vendedor (o los datos procesados de ellos) pueden incluirse en una combinación de auctionSignals, sellerSignals o perBuyerSignals cuando se configura la subasta. Esto le permite al comprador usar temas al hacer ofertas y al vendedor usar temas al calificar las ofertas.

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

Utilizar temas al hacer ofertas

Luego, cuando se llama a la función generateBid() del comprador, se pueden usar los temas registrados que se pasaron (al igual que cualquier otro dato proporcionado en los indicadores) para ayudar en las ofertas. Por ejemplo, el ofertante podría usar la presencia de la categoría "Deportes/ciclismo" tema para realizar una oferta más alta con este custom-bikes grupo de interés.

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

Usar temas al puntuar las ofertas

Después de ofertar cuando se llama a la función scoreAd() del vendedor, los temas registrados se pueden usar como cualquier otro dato que se haya pasado desde la configuración de la subasta. Por ejemplo, es posible que el vendedor desee ponderar las ofertas más altas para los anuncios que coinciden con los temas detectados.

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
  //...
}