Configurer une intégration Open Bidding

Open Bidding permet aux places de marché et aux autres acheteurs d'exploiter l'infrastructure d'enchères en temps réel de Google pour définir des enchères sur l'inventaire Google Ad Manager et AdMob.

Pour participer à Open Bidding, configurez une intégration des enchères en temps réel personnalisée pour votre cas d'utilisation d'Open Bidding, puis envoyez des points de terminaison de l'enchérisseur à votre responsable de compte Google pour qu'il effectue des tests afin de vérifier que l'intégration fonctionne correctement. Une fois l'opération effectuée, vous n'avez pas à la répéter.

Limiter votre intégration à certains éditeurs

Votre intégration Open Bidding peut rester en "mode privé" jusqu'à ce que vous soyez prêt à accepter les demandes de n'importe quel éditeur. En mode privé, vous pouvez collaborer avec votre équipe de gestion de compte pour vous connecter à certains éditeurs et rester dans cet état jusqu'à ce que vous soyez prêt à passer à l'échelle. Une fois que vous quittez le mode privé, votre compte est visible par tous les éditeurs.

Protocoles et encodage compatibles

Vous pouvez utiliser OpenRTB au format JSON ou Protobuf. En savoir plus

Implémentation OpenRTB de Google

L'implémentation OpenRTB de Google n'est pas compatible avec toutes les fonctionnalités de la spécification OpenRTB et ajoute des extensions pour les acheteurs certifiés et les fonctionnalités spécifiques à Open Bidding. Pour en savoir plus, consultez le guide OpenRTB.

Gérer les demandes d'enchères entrantes

Open Bidding utilise la même structure BidRequest qu'Authorized Buyers, mais certains champs sont envoyés exclusivement aux participants à Open Bidding. Consultez le guide des demandes pour en savoir plus sur les champs spécifiques à Open Bidding envoyés dans la demande d'enchère.

Répondre avec une enchère

Open Bidding utilise également une structure BidResponse semblable à celle d'Authorized Buyers, avec certains champs exclusifs envoyés aux participants à Open Bidding. Consultez le guide des réponses pour en savoir plus sur les champs spécifiques à Open Bidding que vous pouvez utiliser pour répondre.

Selon le format d'annonce préféré avec lequel vous souhaitez définir une enchère, la structure de la réponse peut varier de manière significative. Consultez les guides suivants pour vous aider à configurer votre application d'enchérisseur afin qu'elle réponde avec des enchères pour les formats d'annonces courants:

Suivre les impressions pour réduire les écarts

Nous vous recommandons vivement d'utiliser le champ BidResponse.seatbid.bid.ext.impression_tracking_url facultatif pour récupérer des données au niveau des impressions sur le moment où Google enregistre les événements facturables pour lesquels vous serez facturé.

Résolution des différences de demande Google (bêta)

Cette fonctionnalité vise à s'assurer que le nombre d'impressions pour lesquelles une place de marché est facturée correspond au nombre d'impressions payées par Google Display & Video 360 (DV360).

En identifiant avec précision les impressions DV360 diffusées par Open Bidding, Google peut ajuster les différences au niveau du spam publicitaire et des événements facturables. Ainsi, vous ne serez pas facturé pour les impressions pour lesquelles vous n'êtes pas payé.

propager "google_query_id" dans les demandes d'enchères ;

Pour vous assurer que le nombre d'impressions valides correspond à la demande Google, le google_query_id doit être propagé tel quel à partir des demandes Open Bidding vers les plates-formes de demande Google. Il s'agit d'une condition préalable à la résolution des différences Open Bidding. La longueur attendue actuelle de google_query_id est d'environ 64 octets.

propager "third_party_buyer_token" dans les réponses aux enchères ;

Si la plate-forme de demande Google remporte une mise aux enchères interne d'une place de marché, le champ third_party_buyer_token doit être propagé tel quel dans la réponse d'enchère via l'impression Open Bidding. Cela permet aux plates-formes d'éditeurs Google d'établir que l'enchère gagnante d'un partenaire Open Bidding est une enchère au nom de la demande Google pour la même opportunité d'impression. La longueur maximale actuelle de ce champ devrait être de 150 octets.

Transmettre la balise Google pour les créations telle quelle dans les réponses aux enchères

Pour que la résolution des différences s'applique aux enchères provenant de la demande Google, une place de marché est requise pour propager le balisage de création Google sans aucun wrapper (tags de script, iFrames ou wrappers VAST). En raison de la résolution de la divergence, Google peut invalider les impressions Open Bidding qui n'ont pas été comptabilisées par les plates-formes de demande Google et ne pas les facturer. Google vérifie régulièrement la balise de création pour confirmer que les enchères avec third_party_buyer_token ont été envoyées au nom de la demande Google et non d'un autre acheteur.

Créations HTML5

Une place de marché doit envoyer le balisage HTML Google tel quel, avec les extensions de macro spécifiques à la place de marché qui s'appliquent normalement et, éventuellement, des pixels ou des scripts de suivi supplémentaires qu'une place de marché ajoute normalement.

Google ne peut pas appliquer la résolution des différences si une place de marché encapsule la création HTML Google dans une balise (script, iframe ou d'autres techniques) qui charge ou affiche ensuite le code HTML Google.

Créations vidéo VAST

Pour pouvoir bénéficier de la résolution des différences, une place de marché doit utiliser l'une des approches suivantes pour renseigner VASTTagURI dans les réponses XML VAST:

  1. Une place de marché peut conserver la valeur de l'élément VASTTagURI dans le document XML VAST renvoyé par Google dans le champ BidResponse.seatbid.bid.adm tel quel, avec des extensions de macro spécifiques à la place de marché qui s'appliquent normalement.
  2. DV360 peut renseigner le champ BidResponse.seatbid.bid.adm.nurl avec une URL de document VAST dans les réponses aux enchères d'une place de marché. Une place de marché peut ensuite transmettre cette valeur avec la balise VASTTagURI, les macros spécifiques à la place de marché étant développées normalement si nécessaire.

Si nécessaire, une place de marché peut spécifier des outils de suivi des événements et des erreurs VAST supplémentaires dans le document XML VAST.

Offres

Les places de marché participant à Open Bidding peuvent utiliser les accords préférés et les enchères privées avec Open Bidding. L'ID et le type de l'accord doivent être spécifiés comme suit:

Champ Description
BidResponse.seatbid.bid.dealid ID de l'accord de l'espace de noms de la place de marché associé à l'enchère et communiqué aux éditeurs. Il s'agit d'un texte UTF-8 arbitraire qui ne doit pas dépasser 64 octets.
BidResponse.seatbid.bid.ext.exchange_deal_type Énumération spécifiant le type d'accord. Cette information est communiquée aux éditeurs et affecte la façon dont l'accord est traité lors de la mise aux enchères. Les valeurs possibles sont les suivantes:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Voici un exemple de réponse d'enchère pour les enchères dynamiques et les enchères en temps réel.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Pour renseigner les tables de correspondances hébergées par Google, les participants à Open Bidding peuvent utiliser l'une des options ci-dessous qui leur convient le mieux:

  • Mise en correspondance des cookies: mise en correspondance initiée par l'acheteur ou la place de marché En savoir plus
  • Mise en correspondance par pixel: mise en correspondance initiée par Google. En savoir plus
  • Cookie Match Assist: mise en correspondance initiée par la place de marché avec ses enchérisseurs En savoir plus

Gérer la latence

Vous devez utiliser les emplacements de négociation indiqués dans le guide de mise en pairage pour estimer la latence de vos points de terminaison d'enchères lorsqu'ils répondent aux demandes d'enchères entrantes.

Les places de marché de grande envergure qui reçoivent un volume élevé de demandes d'enchères doivent envisager de conclure un accord de peering avec Google afin de réduire la latence et la volatilité de la latence. En savoir plus sur l'appairage

Macros de clic

Nous vous recommandons d'implémenter des macros de clic. Vous pourrez ainsi créer des rapports incluant les clics et les métriques dérivées des clics pour votre compte et pour les éditeurs avec lesquels vous collaborez. En savoir plus

API

Les clients Open Bidding peuvent utiliser les API REST Authorized Buyers pour accéder aux données qui peuvent être utiles à des fins de dépannage. Seules les ressources d'API suivantes sont actuellement accessibles:

Vous pouvez contacter votre responsable de compte technique pour configurer votre compte afin d'accéder à ces API et pour récupérer l'ID de compte nécessaire pour effectuer des appels d'API. Pour obtenir une assistance technique sur l'utilisation de ces API, vous pouvez contacter l'alias d'assistance adxbuyerapi-support@google.com.

Ressources supplémentaires

Exemples de demandes et de réponses d'enchères

Vous trouverez des exemples de requêtes et de réponses d'enchères pour tous les protocoles compatibles dans les guides Request (Requête) et Response (Réponse).