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:

  • Un ID de siège provient de l'acheteur et est un identifiant qui représente le client de l'acheteur. Un ID de siège peut avoir des implications en termes de facturation, par exemple si une licence est associée à une remise auprès d'un vendeur 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 que le coût/prix, l'engagement sur le volume, les informations sur l'audience, l'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 le même pour toutes les offres spéciales, vous pouvez le définir dans buyerAndSellerReportingId et les ID des offres spéciales 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 gagner l'enchère que si l'ID de l'accord renvoyé est k-anonyme, ainsi que d'autres ID de reporting et certaines propriétés du groupe de centres d'intérêt.
  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 de l'accord et de la place deviennent disponibles dans les fonctions de reporting du vendeur.
  5. Les ID de l'accord et des emplacements sont disponibles dans les fonctions de création de rapports de l'acheteur.

1. Enregistrement des ID d'accord et de licence

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
      buyerReportingId: '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 d'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 parmi selectableBuyerAndSellerReportingIds et renvoyer la valeur selectedBuyerAndSellerReportingId. L'enchère est refusée si l'ID de l'accord sélectionné ne figure pas dans le tableau selectableBuyerAndSellerReportingIds.

function generateBid(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

  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 d'intérêts, generateBid() peut toujours renvoyer une enchère qui n'inclut pas de selectedbuyerAndSellerReportingId. Dans ce cas, les ID de rapport fournis aux fonctions de création de rapports si cette enchère est gagnante suivront le comportement des ID de rapport non sélectionnables.

Si generateBid() est réexécuté parce que l'appel initial n'a généré aucune enchère avec des annonces ayant réussi les vérifications d'anonymat k, les selectableBuyerAndSellerReportingIds qui ne réussissent pas la vérification d'anonymat k ne seront pas présentes dans le groupe d'intérêts lors de la nouvelle exécution.

3. ID de l'accord et de la licence pour les vendeurs lors de l'attribution de scores aux annonces

L'ID de l'accord sélectionné, ainsi qu'un ID de licence utilisateur, le cas échéant, sont mis à la disposition de scoreAd(). Le vendeur indique le niveau d'attractivité 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 de l'accord et de la licence pour les rapports des 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 rapport qui incluent un selectedBuyerAndSellerReportingId seront toujours disponibles dans reportResult(). Notez que même si la k-anonymité est vérifiée pour buyerReportingId, la valeur n'est disponible que pour la fonction de création de rapports pour les acheteurs, et non pour la fonction de création de rapports pour les vendeurs.

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'
    buyerReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

Interagir et envoyer des commentaires