Enchérir lors d'enchères pour acheter un espace publicitaire

En tant qu'acheteur d'annonces (DSP et annonceurs), vous pouvez participer à une enchère d'annonces Protected Audience sur le site de l'éditeur pour cibler un groupe d'intérêt que vous avez défini sur le site de l'annonceur. En participant aux enchères Protected Audience, vous pouvez toucher vos clients identifiés sur d'autres sites tout en respectant leur confidentialité.

Dans une enchère Protected Audience, vous fournissez la logique permettant de générer l'enchère, et le navigateur la calcule à l'aide de cette logique. Cela diffère des autres architectures d'enchères, dans lesquelles vous soumettez directement l'enchère au lieu de fournir la logique.

Vous fournissez votre logique de génération d'enchères dans la fonction JavaScript generateBid(). Le fichier est hébergé sur votre serveur. Lorsque vous ajoutez un utilisateur à un groupe d'intérêt, l'emplacement de ce fichier est transmis à la configuration du groupe d'intérêt en tant que biddingLogicUrl.

Pendant les enchères, le navigateur récupère la logique d'enchères que vous avez spécifiée dans le champ biddingLogicUrl et exécute votre fonction generateBid() pour chaque groupe d'intérêt dans un environnement isolé sécurisé dont la communication avec le contexte extérieur est limitée. Lorsque generateBid() est exécuté, le navigateur transmet des signaux à la fonction en tant qu'arguments. Ces signaux contiennent diverses informations provenant de différentes sources, telles que les données first party de l'éditeur, les données du vendeur, les données en temps réel, etc. Vous pouvez utiliser ces signaux pour calculer l'enchère. La valeur est renvoyée par l'appel generateBid(). Une fois les enchères envoyées, le navigateur exécute la logique de notation du vendeur sur chaque enchère pour calculer le score de désirabilité du vendeur.

generateBid()

Vous trouverez ci-dessous une description des arguments de la fonction generateBid() et de la structure de l'enchère renvoyée par la fonction :

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

Arguments

generateBid() utilise les arguments suivants :

Signaux du navigateur

L'objet browserSignals comporte les propriétés suivantes :

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

Calculer une enchère

Pour calculer une valeur d'enchère, le code dans generateBid() peut utiliser les propriétés des paramètres de la fonction.

Exemple :

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

Retourner une enchère

generateBid() renvoie un objet avec les propriétés suivantes :