Configurer une intégration Open Bidding

Open Bidding permet aux plates-formes d'échange et aux autres acheteurs d'exploiter l'infrastructure d'enchères en temps réel de Google pour enchérir sur l'inventaire Google Ad Manager et AdMob.

Pour participer à Open Bidding, configurez une intégration d'enchères en temps réel personnalisée pour votre cas d'utilisation Open Bidding, puis envoyez les 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 l'équipe chargée de votre compte pour vous associer à certains éditeurs et rester dans cet état jusqu'à ce que vous soyez prêt à évoluer. Une fois le mode privé désactivé, votre compte sera visible par tous les éditeurs.

Protocoles et encodage compatibles

Vous pouvez utiliser OpenRTB aux formats JSON ou Protobuf. En savoir plus

Implémentation Google OpenRTB

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

Traiter les demandes d'enchères entrantes

Open Bidding utilise la même structure BidRequest qu'Authorized Buyers, mais certains champs sont exclusivement envoyés 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 auxquels vous pouvez répondre.

La structure de la réponse peut varier considérablement en fonction du format d'annonce préféré avec lequel vous prévoyez d'enchérir. 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'annonce courants :

Suivre les impressions pour réduire les écarts

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

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 s'assurer que le nombre d'impressions valides correspond à la demande Google, le google_query_id doit être propagé tel quel des demandes Open Bidding aux 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 les enchères internes d'une place de marché, le champ third_party_buyer_token doit être propagé tel quel dans la réponse aux enchères 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 pour la demande Google pour la même opportunité d'impression. La longueur maximale actuelle de ce champ devrait être de 150 octets.

Transmettre le balisage de création Google tel quel dans les réponses aux enchères

Pour que la résolution des écarts s'applique aux enchères provenant de la demande Google, une place de marché doit propager le balisage de création Google sans aucun wrapper (balises de script, iFrames ou wrappers VAST). En raison de la résolution des écarts, 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érifiera régulièrement le balisage des créations 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 plate-forme d'échange est requise pour envoyer le balisage HTML Google tel quel, avec les expansions de macros spécifiques à la plate-forme d'échange qui s'appliquent normalement, et, éventuellement, des pixels de suivi ou des scripts supplémentaires qu'une plate-forme d'échange ajoute normalement.

Google ne peut pas résoudre les écarts si une plate-forme d'échange enveloppe une 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 que les différences puissent être résolues, une place de marché doit utiliser l'une des approches suivantes pour renseigner VASTTagURI dans les réponses XML VAST :

  1. Un échange 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 les expansions de macros spécifiques à l'échange qui s'appliquent normalement.
  2. DV360 peut remplir le champ BidResponse.seatbid.bid.adm.nurl avec une URL de document VAST dans les réponses aux enchères envoyées à une place de marché. Une place de marché peut ensuite transmettre cette valeur avec le tag VASTTagURI, avec les macros spécifiques à la place de marché développées normalement si nécessaire.

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

Offres

Les places de marché participant à Open Bidding peuvent utiliser des accords préférés (AP) et des enchères privées (EP) avec Open Bidding. L'ID et le type d'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 UTF8 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é dans les 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 aux enchères pour PD/PA.

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 remplir les tables de correspondance hébergées par Google, les participants Open Bidding peuvent utiliser l'une des options ci-dessous, selon leurs besoins :

  • Cookie matching : mise en correspondance initiée par l'acheteur ou l'ad exchange En savoir plus
  • Correspondance Pixel : 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 trading indiqués dans le Guide sur le peering pour estimer la latence de vos points de terminaison d'enchérisseur lorsqu'ils répondent aux demandes d'enchères entrantes.

Les grandes plates-formes d'échange qui reçoivent un volume élevé de demandes d'enchères doivent envisager de conclure un accord de peering avec Google pour réduire la latence et sa volatilité. En savoir plus sur le peering

Macros de clic

Nous vous recommandons d'implémenter des macros de suivi des clics. Cela vous permettra de générer des rapports incluant les clics et les métriques dérivées des clics pour votre compte et pour les éditeurs avec lesquels vous travaillez. 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 concernant 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

Des exemples de demandes et de réponses d'enchères pour tous les protocoles compatibles sont disponibles dans les guides Demande et Réponse.