Accords dans Protected Audience

Implémenter des accords, également appelés places de marché privées (PMP), dans une enchère Protected Audience

Présentation

Les accords, également appelés places de marché privées, offrent aux acheteurs un accès à sélection ou à des prix préférentiels sur un sous-ensemble de l'inventaire. Pour faciliter les accords programmatiques, les ID de siège et les ID d'accord sont utilisés:

  • L'ID de siège provient de l'acheteur. Il s'agit d'un identifiant qui représente le client de l'acheteur. Un ID de siège peut avoir des conséquences sur la facturation, par exemple si un siège bénéficie d'une remise auprès d'un marchand donné.
  • L'ID de l'accord provient de l'acheteur ou du vendeur. Il s'agit d'un identifiant qui représente un accord entre un acheteur et un vendeur. Un ID d'accord peut comporter des propriétés telles qu'un coût/prix, un engagement de volume, des informations sur l'audience, une exclusivité, etc.

Protected Audience facilite les accords en utilisant des ID de reporting. Ils permettent aux ID de sièges et d'accords de devenir disponibles pour les enchères, l'évaluation et la création de rapports. Les ID de reporting permettent aux entreprises de technologie publicitaire de recevoir ces ID d'accord et de siège dans les rapports Protected Audience post-enchères afin de négocier des accords et d'organiser les efforts de facturation. Nous nous attendons à ce que les acheteurs, les vendeurs, les agences et les annonceurs aient des stratégies personnalisées pour interpréter et comprendre les ID de l'accord et des espaces publicitaires qu'ils reçoivent.

Tutoriel

Pour faciliter les accords dans une mise aux enchères Protected Audience, procédez comme suit :

  1. L'acheteur enregistre l'accord et les ID de siège dans la configuration du groupe d'intérêt avant le lancement de l'enchère.
    • Vous pouvez définir les ID de l'accord et de la place dans le champ ID de reporting sélectionnables (selectableBuyerAndSellerReportingIds).
    • Si l'ID de siège est identique pour tous les accords, il peut être défini dans buyerAndSellerReportingId, et les ID d'accord peuvent être définis dans le champ des ID de reporting sélectionnables (selectableBuyerAndSellerReportingIds).
  2. Lors de la génération des enchères, les ID d'accord et de siège deviennent disponibles. L'acheteur sélectionne un ID d'accord dans selectableBuyerAndSellerReportingIds. L'acheteur génère une enchère qui inclut un ID d'accord associé à cette enchère en renvoyant un selectedBuyerAndSellerReportingId. Une enchère ne peut remporter l'enchère que si l'ID d'accord renvoyé est "k-anonyme" avec d'autres ID de reporting et si les propriétés du groupe de centres d'intérêt sont sélectionnées.
  3. Lors de l'évaluation des annonces, le vendeur peut accéder aux ID d'accord et de siège sélectionnés.
  4. Les ID d'accord et de siège deviennent disponibles dans les fonctions de création de rapports du vendeur.
  5. Les ID d'accord et de siège deviennent disponibles dans les fonctions de reporting de l'acheteur.

1. Enregistrement des ID d'offre et de siège

L'acheteur enregistre les ID d'accord et de siège dans la configuration du groupe d'intérêt avant le lancement de l'enchère. Les ID de l'offre et de la place sont définis dans selectableBuyerAndSellerReportingIds sous la forme d'un tableau de chaînes. Si l'ID de siège est le même pour toutes les offres et qu'il n'a pas besoin d'être répété, vous pouvez l'ajouter dans le champ buyerAndSellerReportingId, qui accepte une chaîne :

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);

Si l'ID de siège est différent pour les accords, vous pouvez utiliser la configuration suivante:

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 d'accord et de siège pour les acheteurs lors de la génération d'enchères

Lors de la génération des enchères, l'acheteur décide s'il souhaite enchérir sur un ID d'accord. Dans generateBid(), l'acheteur peut sélectionner un ID d'accord dans selectableBuyerAndSellerReportingIds et renvoyer la valeur sous la forme selectedBuyerAndSellerReportingId. L'enchère est refusée si l'ID d'accord sélectionné ne figure pas dans le tableau 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
  };
}

Une enchère avec une valeur renvoyée pour selectedbuyerAndSellerReportingId ne peut remporter l'enchère que si la valeur de selectedbuyerAndSellerReportingId est k-anonyme conjointement avec buyerAndSellerReportingId (le cas échéant), buyerReportingId (le cas échéant) le propriétaire du groupe de centres d'intérêt, l'URL du script d'enchères, l'URL de rendu et la taille de l'annonce (la taille de l'annonce est exclue de cette vérification jusqu'au 1er trimestre 2025 minimum).

Même si selectablebuyerAndSellerReportingIds est défini dans la configuration du groupe de centres d'intérêt, il est toujours possible que generateBid() renvoie une enchère qui n'inclut pas de selectedbuyerAndSellerReportingId. Dans ce cas, les ID de reporting fournis aux fonctions de création de rapports si cette enchère l'emporte suivront le comportement des ID de reporting non sélectionnables.

Si generateBid() est réexécuté, car l'appel initial n'a généré aucune enchère avec des annonces ayant passé les contrôles de k-anonymat, alors les selectableBuyerAndSellerReportingIds qui échouent au contrôle de k-anonymat ne seront pas présentes dans le groupe d'intérêt lors de la réexécution.

3. ID d'offre et de siège pour les vendeurs lors de l'évaluation des annonces

L'ID de l'accord sélectionné, ainsi que l'ID de siège s'il est présent, sont accessibles à scoreAd(). Le vendeur fournit le score de désirabilité de l'enchère gagnante en tenant compte de l'ID de l'accord et de toute condition spéciale. Si le vendeur ne pense pas que l'ID d'accord choisi par l'acheteur s'applique, il rejette l'enchère en lui attribuant un score de désirabilité nul ou négatif.

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

  // ...
}

4. ID d'accord et de siège pour les rapports sur les vendeurs

N'oubliez pas qu'une enchère ne peut gagner l'enchère que si selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (le cas échéant) et buyerReportingId (le cas échéant) sont k-anonymes avec le propriétaire du groupe d'intérêts, l'URL du script d'enchères, l'URL de rendu et la taille de l'annonce (la taille de l'annonce est exclue de cette vérification jusqu'au premier trimestre 2025 au moins). Par conséquent, les valeurs d'ID de reporting qui incluent un selectedBuyerAndSellerReportingId seront toujours disponibles dans reportResult(). Notez que même si la propriété k-anonymat de buyerReportingId est vérifiée, cette valeur n'est disponible que pour la fonction de création de rapports sur les acheteurs, et non pour la fonction de création de rapports sur le vendeur ici.

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

  // ...
}

5. ID de l'accord et de la licence pour les rapports sur les acheteurs

Le même concept que celui des rapports sur les vendeurs s'applique aux rapports sur les acheteurs. N'oubliez pas qu'une enchère ne peut remporter l'enchère que si les éléments selectedBuyerAndSellerReportingId, buyerAndSellerReportingId (le cas échéant) et buyerReportingId (le cas échéant) sont k-anonymes avec le propriétaire du groupe de centres d'intérêt, l'URL du script d'enchères, l'URL de rendu et la taille de l'annonce (la taille de l'annonce est exclue de cette vérification jusqu'au 1er trimestre 2025 minimum). Par conséquent, les valeurs d'ID de reporting qui incluent un selectedBuyerAndSellerReportingId seront toujours disponibles dans reportWin().

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

Interagir et partager des commentaires