Configurer une intégration Open Bidding

Open Bidding permet aux places de marché et à d'autres acheteurs de tirer parti de 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 Open Bidding, puis envoyez des points de terminaison d'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 contacter l'équipe chargée de votre compte pour contacter certains éditeurs et rester dans cet état jusqu'à ce que vous soyez prêt à évoluer. Une fois que vous aurez quitté le mode privé, votre compte sera visible par tous les éditeurs.

Protocoles et encodage compatibles

Open Bidding utilise les protocoles RTB propriétaires d'Authorized Buyers et d'OpenRTB. En savoir plus

Implémentation dans Google OpenRTB

L'implémentation OpenRTB de Google n'est pas compatible avec toutes les fonctionnalités disponibles dans la spécification OpenRTB. Elle ajoute des extensions pour Authorized Buyers et les fonctionnalités spécifiques à Open Bidding. Pour en savoir plus sur l'implémentation d'OpenRTB de Google et sur son lien avec le protocole d'enchères en temps réel propriétaire Authorized Buyers, 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 uniquement 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, certains champs exclusifs étant envoyés aux participants Open Bidding. Consultez le guide de réponse pour en savoir plus sur les champs spécifiques à Open Bidding que vous pouvez utiliser pour répondre.

La structure de la réponse peut varier considérablement selon le format d'annonce préféré avec lequel vous souhaitez définir une enchère. Consultez les guides suivants pour configurer votre application d'enchères 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 facultatif impression_tracking_url pour récupérer les données au niveau des impressions lorsque Google enregistre des événements facturables qui vous seront facturés. Pour OpenRTB, cette valeur est présentée sous la forme BidResponse.seatbid[].bid[].ext.impression_tracking_url et BidResponse.ad[].impression_tracking_url dans le protocole Google.

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

Cette fonctionnalité vise à garantir que le nombre d'impressions facturées à une place de marché 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 écarts 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 garantir que le nombre d'impressions valides correspond à la demande Google, l'google_query_id doit être propagée en l'état depuis les demandes Open Bidding aux plates-formes de demande Google. Il s'agit d'une condition préalable à la résolution des écarts 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 la mise aux enchères interne d'une place de marché, le champ third_party_buyer_token doit être propagé en l'état dans la réponse à l'enchère via l'impression Open Bidding. Cela permet aux plates-formes d'éditeurs Google de déterminer que l'enchère gagnante d'un partenaire Open Bidding correspond à une enchère émise pour le compte de la demande Google pour la même opportunité d'impression. La longueur maximale actuelle de ce champ est normalement de 150 octets.

Transmettre le balisage des créations Google tel qu'il est dans les réponses aux enchères

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

Créations HTML5

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

Google n'est pas en mesure d'appliquer la résolution des différences si une place de marché encapsule une création HTML Google dans une balise (script, iframe ou une autre technique) 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 afin de 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 adm tel quel, avec des extensions de macro spécifiques à la place de marché qui s'appliquent normalement.
  2. DV360 peut renseigner le champ 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 la valeur nurl avec laquelle Google (DV360) répond dans la balise VASTTagURI, avec des macros spécifiques à la place de marché développées normalement si nécessaire.

Si nécessaire, une place de marché peut spécifier d'autres outils de suivi des événements et des erreurs VAST dans un 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. Vous devez spécifier l'ID et le type de l'accord comme suit:

Champ Description
Protocole OpenRTB:
BidResponse.seatbid[].bid[].dealid

Protocole Google:
BidResponse.ad[].adslot[].exchange_deal_id		 ID d'accord provenant de l'espace de noms de la place de marché associé à l'enchère et indiqué aux éditeurs. Il s'agit d'un texte UTF8 arbitraire qui ne doit pas dépasser 64 octets.
Protocole OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Protocole Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Énumération spécifiant le type d'accord. Cette information est transmise aux éditeurs et affecte la façon dont l'accord est traité lors des enchères. Les valeurs possibles sont les suivantes:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Vous trouverez ci-dessous un exemple de réponse à l'enchère OpenRTB pour les accords préférés/AP.

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 tableaux de correspondance hébergés par Google, les participants Open Bidding peuvent utiliser l'une des options ci-dessous qui correspondent le mieux à leurs besoins:

  • Mise en correspondance des cookies: mise en correspondance initiée par un acheteur ou une place de marché En savoir plus
  • Mise en correspondance de pixels: mise en correspondance initiée par Google En savoir plus
  • Cookie Match Assist: mise en correspondance initiée par une place de marché avec ses enchérisseurs En savoir plus

Gérer la latence

Vous devez utiliser les zones d'échange disponibles dans le Guide d'appairage pour estimer la latence que vos points de terminaison d'enchérisseur auront lors de la réponse aux demandes d'enchères entrantes.

Les grandes places de marché qui reçoivent un grand nombre de demandes d'enchères doivent envisager de conclure un accord d'appairage avec Google afin de réduire la latence et les fluctuations de la latence. Obtenez plus d'informations sur l'appairage.

Macros de clic

Nous vous recommandons d'implémenter des macros de clic. Vous pourrez ainsi créer des rapports qui incluent 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 à des données 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 envoyer un e-mail à l'alias d'assistance beaucoupapi-support@google.com.

Ressources supplémentaires

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

Vous trouverez des exemples de demandes et de réponses pour tous les protocoles compatibles dans les guides sur les demandes et les réponses.