Configurer une intégration Open Bidding

Open Bidding permet aux places de marché et aux autres acheteurs d'exploiter les 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 un système d'enchères en temps réel personnalisée pour votre cas d'utilisation Open Bidding, et envoyez points de terminaison à votre responsable de compte Google pour effectuer 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'à pour accepter les demandes de n'importe quel éditeur. En mode privé, vous pouvez : collaborez avec l'équipe chargée de votre compte pour entrer en contact avec certains éditeurs et rester jusqu'à ce que vous soyez prêt pour le scaling. Lorsque vous quittez le mode privé, seront visibles par tous les éditeurs.

Protocoles et encodages compatibles

Nous vous recommandons d'utiliser l'implémentation OpenRTB de Google. Protocole Google RTB est obsolète. En savoir plus

Implémentation d'OpenRTB Google

L'implémentation OpenRTB de Google ne prend pas en charge toutes les fonctionnalités disponibles dans la spécification OpenRTB, et ajoute des extensions pour Authorized Buyers et Open Bidding. Fonctionnalité propre au système d'enchères Pour en savoir plus sur OpenRTB de Google et son rapport avec la solution propriétaire Authorized Buyers protocole d'enchères en temps réel, consultez le guide OpenRTB.

Gérer les demandes d'enchères entrantes

Open Bidding utilise la même structure BidRequest qu'Authorized Acheteurs, mais certains champs ne sont envoyés qu'aux participants Open Bidding. Consultez le guide de demande 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-ci d'Authorized Buyers, avec des champs exclusifs envoyés à Open Bidding. participants. 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é pour lequel vous souhaitez définir une enchère, la réponse peut différer de façon significative. Consultez les guides suivants pour savoir comment configurer votre pour répondre par des enchères pour les formats d'annonces courants:

Suivez les impressions pour réduire les écarts.

Nous vous recommandons vivement d'utiliser l'option facultative impression_tracking_url pour récupérer les données au niveau des impressions sur les dates d'enregistrement événements qui vous seront facturés. Pour OpenRTB, il apparaît sous la forme BidResponse.seatbid[].bid[].ext.impression_tracking_url, et en tant que BidResponse.ad[].impression_tracking_url dans standard.

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

Cette fonctionnalité permet de s'assurer que le nombre d'impressions pour lesquelles est facturé en fonction du nombre d'impressions payées Publicité sur le Réseau Display de Google Video 360 (DV360).

En identifiant précisément les impressions DV360 diffusées par Open les enchères, Google peut ensuite ajuster les enchères pour tenir compte des écarts entre les spams publicitaires et les événements facturables. pour vous assurer de ne pas être 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 demande Google, le google_query_id doit être propagé tel quel depuis Demandes Open Bidding envoyées aux plates-formes de demande Google Il s'agit d'une condition préalable Résolution des différences avec Open Bidding La durée actuellement attendue pour le google_query_id correspond à environ 64 octets.

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

Si la plate-forme de demande Google remporte l'enchère interne enchère, le champ third_party_buyer_token doit être propagé tel quel dans la réponse à l'enchère via l'impression Open Bidding. Cela permet plates-formes Google pour les éditeurs afin de s'assurer que l'enchère gagnante d'une enchère Le partenaire d'enchères définit une enchère pour le compte de la demande Google pour la même impression opportunité. La longueur maximale actuelle de ce champ devrait être de 150 octets.

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

Pour garantir que la résolution de l'écart s'applique aux enchères Demande Google, une place de marché est requise pour propager le balisage des créations Google sans aucun wrapper (tags de script, iFrames ou wrappers VAST). En raison du la résolution d'écarts, Google peut invalider et ne pas facturer les Impressions d'enchères qui n'étaient pas comptabilisées par les plates-formes de demande Google. Google vérifie régulièrement le balisage des créations pour s'assurer que les enchères avec third_party_buyer_token ont été envoyés pour la demande Google, et et non à un autre acheteur.

Créations HTML5

Un échange est nécessaire pour envoyer le balisage HTML Google en l'état, avec les macro-extensions propres aux places de marché qui s'appliquent normalement des pixels de suivi ou des scripts de suivi supplémentaires qu'une place de marché ajoute normalement.

Google n'est pas en mesure d'appliquer la résolution des écarts si une place de marché encapsule dans un tag (script, iframe ou toute autre techniques) qui chargent ou affichent le code HTML de Google par la suite.

Créations vidéo VAST

Pour être éligible à la résolution des différences, une place de marché doit utilisez l'une des approches suivantes pour renseigner VASTTagURI dans Réponses XML VAST:

  1. Une place de marché peut conserver la valeur de l'élément VASTTagURI comme suit : partie d'un document XML VAST renvoyé par Google dans le champ adm tel quel, avec les macro-extensions propres aux places de marché qui s'appliquent normalement.
  2. DV360 peut renseigner le champ nurl avec une URL de document VAST au format à une place de marché. Une place de marché peut alors transmettre la valeur nurl avec lequel Google (DV360) répond dans VASTTagURI , avec des macros spécifiques aux places de marché développées normalement, si nécessaire.

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

Accords

Les places de marché participant à Open Bidding peuvent utiliser Accords préférés (DP), Enchères privées (AP) 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 de l'accord provenant de l'espace de noms de la place de marché associé à l'enchère et transmis 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. Il est signalé aux éditeurs et affecte l'état de l'accord. prises en compte lors des enchères. Les valeurs possibles sont:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Vous trouverez ci-dessous un exemple de réponse à une 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"
    }
  }
}

Afin de remplir les données hébergées par Google les tables des correspondances, Les participants à Open Bidding peuvent utiliser l'une des options ci-dessous qui leur conviennent le mieux. a besoin:

  • Mise en correspondance des cookies: mise en correspondance initiée par l'acheteur ou la place de marché En savoir plus
  • Mise en correspondance des pixels: mise en correspondance initiée par Google En savoir plus
  • Assistant de mise en correspondance des cookies: mise en correspondance initiée par la place de marché avec les enchérisseurs En savoir plus

Gérer la latence

Vous devez utiliser les zones d'échange disponibles dans Guide d'appairage pour estimer la latence de vos points de terminaison d'enchérisseurs des demandes d'enchères entrantes.

Les places de marché importantes qui reçoivent un grand nombre de demandes d'enchères doivent envisager conclut un accord d'appairage avec Google pour réduire la latence volatilité. Apprenez-en plus sur l'appairage.

Macros de clic

Nous vous recommandons d'implémenter des macros de clic. Vous pourrez ainsi créer des rapports qui inclut les clics et les métriques dérivées des clics pour votre compte et pour le 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 qui peuvent être utiles à des fins de dépannage. Seuls les les ressources d'API suivantes sont actuellement accessibles:

Vous pouvez contacter votre responsable de compte technique pour configurer votre compte. pour accéder à ces API et récupérer l'identifiant de compte nécessaire pour créer des API appels. Pour obtenir une assistance technique concernant l'utilisation de ces API, vous pouvez contacter le alias d'assistance ENDapi-support@google.com

Ressources supplémentaires

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

Vous trouverez des exemples de demandes d'enchères et de réponses pour tous les protocoles acceptés dans la demande et Response (Réponse). .