Créer la réponse

Une fois que votre application a traité la demande d'enchère de Google, elle doit créer et d'envoyer une réponse. Ce guide explique comment coder votre application pour compiler la réponse.

Créer un message BidResponse

Authorized Buyers envoie l'BidRequest dans le corps du message un objet HTTP POST. La réponse envoyée par votre application l'en-tête Content-Type défini sur application/octet-stream et un corps de message composé d'un tampon de protocole sérialisé. Le protocole est un message BidResponse tel que défini dans realtime-bidding.proto Votre application doit renvoyer un BidResponse en réponse à chaque BidRequest. Délais d'inactivité et les réponses qui ne peuvent pas être analysées sont considérées comme des erreurs et des limitations Google aux enchérisseurs ayant des taux d'erreur élevés.

Si vous ne souhaitez pas définir d'enchère sur une impression, vous pouvez définir Champ processing_time_ms seul et conserver tous les autres champs vide. Vous pouvez obtenir realtime-bidding.proto données de référence.

ID de la création

Votre BidResponse spécifie une création via la méthode Champ buyer_creative_id (64 octets maximum). Même les créations similaires doit avoir des valeurs uniques pour buyer_creative_id si elles diffèrent par toute caractéristique notable, y compris, mais sans s'y limiter, la taille, l'URL déclarée, les attributs de création et les types de fournisseurs. En d'autres termes, vous devez donner différentes d'identifiants de création à deux annonces qui:

• Votre apparence ou votre comportement sont différents.
• Afficher des images différentes.
• Affichage par différents moyens (par exemple, une annonce se compose d'une image, tandis que l'autre contient des éléments Flash).

Lorsque vous concevez votre application, vous devez choisir une méthode systématique générer des identifiants pertinents pour les types de créations que vous prévoyez à envoyer.

Attributs d'annonce

Vous devez déclarer les attributs de création qui décrivent de manière exhaustive les et son ciblage dans la région BidResponse.Ad.attribute. La qui doivent être déclarés le sont (voir aussi la liste complète à buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  L'annonce contient un pixel ou une balise Web servant à créer une liste d'ID de cookie à des fins de remarketing ultérieur
• 8 Remarketing: IsRemarketing
  L'annonce cible les consommateurs en fonction de leur ID de cookie ou d'appareil la liste d'ID de cookies ou d'ID d'appareils représente un ensemble de consommateurs qui ont déjà interagi avec un site appartenant à l'acheteur ou représenté par celui-ci ;
• 9 UserInterestTargeting: IsUserInterestTargeted
  L'annonce cible les consommateurs en fonction de leur ID de cookie ou d'appareil la liste d'ID de cookies ou d'ID d'appareils représente un ensemble de consommateurs que l'acheteur défini comme un groupe d'intérêt commun.
• 30 InstreamVastVideoType: Vpaid
  L'annonce doit être compatible avec la norme VPAID pour s'afficher.
• 32 MraidType: MRAID
  L'annonce nécessite l'API MRAID pour s'afficher.

De plus, les attributs suivants sont acceptés, mais leur déclaration est n'est pas obligatoire, car Authorized Buyers les détecte automatiquement et les bloque autoriser) vos créations en fonction des valeurs détectées, plutôt qu'en fonction de votre déclaration. Voir API Créations pour savoir comment obtenir des commentaires sur les propriétés détectées créations.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  L'annonce ne peut s'afficher que si elle est compatible avec Flash.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  L'annonce ne nécessite pas de contenu Flash pour s'afficher.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  L'annonce peut s'afficher sur une page SSL. Notez qu'Authorized Buyers traite les créations avec des valeurs déclarées différentes pour cet attribut comme distinctes (elles seront examinées séparément et ont un état d'approbation distinct). Par conséquent, si vous utilisez à la fois SSL et SSL versions non SSL d'une même création, vous devez déclarer cet attribut en conséquence. afin que cette distinction soit reflétée correctement dans AdX.

Champs Open Bidding

Réponses aux enchères envoyées par les enchérisseurs sur la place de marché et le réseau participant au programme Open Source Les enchères sont semblables à celles des acheteurs Authorized Buyers des enchères en temps réel. Les clients Open Bidding peuvent spécifier un petit nombre des champs supplémentaires, et quelques champs existants peuvent avoir d’autres utilisations. Ces incluent les éléments suivants:

Recommandations

• Activez les connexions HTTPS persistantes (aussi appelées "keep-alive" ou "keep-alive"). "réutilisation de connexion") sur vos serveurs. Définissez le délai avant expiration sur 10 secondes minimum : des valeurs plus élevées sont bénéfiques dans de nombreux cas. Validation par Google pendant les tests de latence initiaux de votre application, car Authorized Buyers envoie des demandes à un taux élevé et doit éviter de latence lié à l'établissement d'une connexion TCP distincte pour chaque requête.

• Incluez l'URL de suivi des impressions (facultative) dont vous souhaitez effectuer le suivi lorsque le l'impression s'affiche plutôt que lorsque l'enchérisseur gagne. En raison de l'abandon entre les gains et les rendus, ce qui permet un suivi plus précis statistiques.

• Ne placez pas le code de votre système d'enchères dans un champ obsolète. ce qui peut entraîner l'échec de vos enchères avec des erreurs.
• Inclure BidResponse.Ad.width et BidResponse.Ad.height dans votre BidResponse. A BidResponse à une demande incluant plusieurs tailles d'annonces doit n'inclut pas les valeurs width et height, ont été retirés de la mise en concurrence.
• Limitez la taille de votre réponse à moins de 8 Ko. Les réponses très nombreuses peuvent augmenter et provoquer des délais d'inactivité.
• Suivez les consignes pour des enchères sur l'inventaire iOS qui nécessitent une attribution SKAdNetwork.

Exemple de réponse à l'enchère

Les exemples suivants représentent des exemples lisibles par l'humain des tampons de protocole et Requêtes JSON.

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Important:Les messages Protobuf présentés dans les sont représentés ici sous forme de texte intelligible. Cependant, ce n'est pas ainsi les messages sont envoyés par fil. Lorsque vous utilisez le tampon de protocole Google ou OpenRTB seuls les messages de réponse à l'enchère sérialisés sont acceptés.

Vous pouvez créer et sérialiser un message BidResponse à l'aide de la méthode le code C++ suivant:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Spécifier une création

Votre réponse à l'enchère spécifie la création à diffuser si votre enchère l'emporte. Votre enchère doit inclure l'un des formats d'annonces compatibles (AMP, vidéo ou native). Dans ce exemple, nous spécifions la création à l'aide du champ html_snippet.

Vous pouvez également spécifier votre création à l'aide de l'un des les champs suivants, selon le format d'annonce:

• Annonce affichée à l'aide d'un SDK <ph type="x-smartling-placeholder">
  </ph>
  • BidResponse.Ad.sdk_rendered_ad
• AMP <ph type="x-smartling-placeholder">
  </ph>
  • BidResponse.Ad.amp_ad_url
• Vidéo
  • BidResponse.Ad.video_url ou
  • BidResponse.Ad.video_vast_xml
• Format natif <ph type="x-smartling-placeholder">
  </ph>
  • BidResponse.Ad.native_ad

Spécifiez une annonce hébergée sur vos propres serveurs à l'aide d'un extrait de code HTML dans le champ html_snippet de BidResponse. La est inclus dans un iFrame inséré dans la page Web, ce qui entraîne l'affichage de l'annonce sont récupérées et affichées lors du chargement de la page. Vous devez créer le code HTML afin que l'annonce (bannière ou interstitiel) s'affiche correctement dans un iFrame et à une taille adaptée à l'espace publicitaire sur lequel vous enchérissez.

De plus, la taille d'annonce déclarée dans la réponse à l'enchère doit correspondre exactement à des combinaisons de tailles dans la demande d'enchère lorsque:

• Une annonce est une bannière standard (et non une annonce vidéo, native ou interstitielle).
• L'enchérisseur a déclaré la taille dans la réponse à l'enchère. La valeur "Déclaration de taille" est obligatoire lorsque plusieurs tailles sont présentes dans la requête.
• Les annonces interstitielles constituent une exception. Pour les interstitiels, la largeur doit correspondre à au moins 50% de la largeur de l'écran et à au moins 40% de la hauteur la hauteur de l'écran.

Le champ html_snippet accepte tout code HTML valide qui s'affiche correctement, mais gardez à l'esprit les restrictions liées à la spécification buyer_creative_id dans la section Create BidResponse message (Créer un message de réponse à l'enchère). Un permet d'insérer des informations supplémentaires dans les arguments des URL récupérées sur vos serveurs pour afficher l'annonce. Cela vous permet de transmettre des données arbitraires sur l'impression vers vos propres serveurs.

La plupart des règles concernant les extraits de code HTML renvoyés dans les réponses aux enchères sont identiques à pour les annonces tierces. Découvrez Authorized Buyers Consignes du programme, Conditions applicables aux tiers la diffusion d'annonces et Déclarer des URL de destination dans les annonces.

Spécifier des macros

L'extrait de code HTML qui définit une création peut inclure une ou plusieurs paires appelées "macros". Au moment de la diffusion de l'annonce, les valeurs sont remplacées par . Par exemple, l'application d'enchères de votre client peut utiliser WINNING_PRICE afin de déterminer le montant payé pour l'annonce, s'il remporte l'enchère. Pour analyser cette macro, vous devez implémenter une qui déchiffre les confirmations de prix. Reportez-vous à la section Prix du déchiffrement Confirmations.

Spécifiez une macro pour un extrait de code HTML au format %%MACRO%%, où MACRO est l'un des répertoriées dans le tableau ci-dessous.

Google exige que vous utilisiez soit les CLICK_URL_UNESC, soit CLICK_URL_ESC dans la création de l'annonce tierce diffusée. annonce. Google utilise les macros CLICK_URL pour effectuer le suivi des clics.

Pour utiliser une macro, incluez-la dans l'annonce afin que l'URL soit extraite au moment que quelqu'un clique dessus. La valeur renvoyée est une redirection vers une autre URL que vous ajoutez à CLICK_URL.

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>

<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>

<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>

<a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>

L'échappement d'URL dans les macros utilise le schéma suivant:

• Le caractère d'espacement est remplacé par un signe plus (+).
• Les caractères alphanumériques (0-9, a-z, A-Z) et les caractères de l'ensemble !()*,-./:_~ restent inchangés.
• Tous les autres caractères sont remplacés par %XX, où XX est la valeur hexadécimale chiffre représentant le caractère.

Restrictions des éditeurs

Les éditeurs utilisent l'BidRequest pour transmettre des restrictions sur les annonces qu'ils permettent. Vous devez appliquer les restrictions dans les champs suivants:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

Un champ spécifie les caractéristiques autorisées de l'annonce, et l'autre fonctionnalités non autorisées. Ne renvoyez jamais une annonce comportant une fonctionnalité non autorisée. Pour les appareils autorisés telles que le type de fournisseur, ne renvoient une annonce que si son type se trouve dans Liste allowed_vendor_type dans BidRequest. Consultez le Commentaires pour ces champs dans le tampon de protocole BidRequest pour en savoir plus.

Si un extrait de code HTML est renvoyé dans BidResponse, vous êtes pour définir précisément attribute, category, et click_through_url dans le BidResponse. Si une annonce possède plusieurs valeurs applicables pour ces champs, vous devez : inclure chaque valeur. Pour voir les commentaires associés à ces champs, consultez la Définition du tampon de protocole BidResponse. Les réponses pour lesquelles ces champs ne sont pas définis sont supprimées.

Les valeurs possibles de BidRequest.excluded_attribute sont les suivantes : (voir le fichier publisher-excludable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Les annonces ne sont pas autorisées si elles contiennent un pixel ou une balise Web servant à créer une liste de à des fins de remarketing ultérieur.
• 8 CookieTargeting: IsCookieTargeted
  Les annonces ne sont pas autorisées si elles ciblent les consommateurs sur la base de leur ID de cookie (que représente la liste des ID de cookie). un ensemble de consommateurs ayant précédemment interagi avec un site appartenant à l'acheteur ou représenté par celui-ci ;
• 9 UserInterestTargeting: IsUserInterestTargeted
  Les annonces ne sont pas autorisées si elles ciblent les consommateurs sur la base de leur ID de cookie (que représente la liste des ID de cookie). un ensemble de consommateurs que l'acheteur a défini comme appartenant à une catégorie d'intérêt commun.
• 21 CreativeType: Html
  Les annonces ne peuvent pas utiliser html_snippet ni snippet_template dans BidResponse.Ad.
• 22 CreativeType: VastVideo
  Les annonces ne peuvent pas utiliser le champ video_url dans BidResponse.Ad.
• 30 InstreamVastVideoType: Vpaid
  Les annonces ne doivent pas exiger la compatibilité avec la norme VPAID pour s'afficher.
• 32 MraidType: MRAID
  L'affichage de l'API MRAID n'est pas autorisé pour les annonces.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Les annonces ne doivent pas nécessairement être compatibles avec Flash pour s'afficher.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Les fonctionnalités HTML5 ne sont pas autorisées pour que les annonces s'affichent.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Les annonces ne sont pas autorisées à envoyer des requêtes non SSL.

Par conséquent, si le champ excluded_attribute contient la valeur 7, vous ne devez pas renvoyer une annonce utilisant un pixel ou une balise web pour créer une liste. Notez que si une annonce fait cela, elle doit alors définir la valeur 7 dans le champ d'attribut de BidResponse. De même, si le champ excluded_attribute contient la valeur 48, vous ne devez renvoyer que des annonces pouvant s'afficher sur une page SSL (et en conséquence déclarer l'attribut 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

De plus, le champ excluded_sensitive_category dans BidRequest utilise des codes issus du ad-sensitive-categories.txt disponible sur la page Données de référence. Voici les extensions description de certains de ces codes:

• 3 Politics
  Cette catégorie porte sur la politique ou les sujets sociaux controversés. n'inclut pas les annonces pour les organismes de presse, qui ne manifestent généralement pas de point de vue partisan.
• 4 Dating
  Cette catégorie inclut les services de rencontre et les communautés de rencontre en ligne.
• 5 Religion
  Cette catégorie inclut les annonces à caractère religieux, ainsi que les annonces défendant ou attaquant des opinions religieuses. n'inclut pas l'astrologie ni la spiritualité non confessionnelle.
• 7 Video Games (Casual & Online)
  Cette catégorie inclut les annonces concernant les jeux vidéo, les jeux en ligne et les jeux téléchargeables. mais pas les consoles de jeu vidéo.
• 8 Ringtones & Downloadables
  Modules complémentaires pour mobiles, tels que sonneries et autres goodies téléchargeables (économiseurs et fonds d'écran pour PC, thèmes de profil et images pour réseaux sociaux).
• 10 Get Rich Quick
  Schémas promettant des revenus rapides.
• 18 Weight Loss
  Cette catégorie inclut la perte de poids, les régimes, ainsi que les produits et programmes associés. ne concerne pas les annonces relatives à l'alimentation saine ou à la forme physique en général.
• 19 Cosmetic Procedures & Body Modification
  Cette catégorie concerne les liftings, les liposuccions, les opérations au laser, l'épilation, les implants capillaires, les tatouages et les modifications corporelles.
• 23 Drugs & Supplements:
  Cette catégorie inclut les annonces concernant les marchands de produits pharmaceutiques, de vitamines, de compléments alimentaires et autres produits associés. n'inclut pas de ressources fournissant des informations sur les drogues.
• 24 Sexual & Reproductive Health
  Cette catégorie inclut les annonces liées à la sexualité et aux problèmes d'infertilité. n'inclut pas les ressources normales liées aux grossesses.
• 35 Social Casino Games
  Cette catégorie inclut les simulations de jeux d'argent et de hasard (y compris, sans s'y limiter, le poker, les machines à sous, le bingo, les loteries, les paris sportifs, le pari sur des courses, ainsi que d'autres jeux de cartes et de casino) ne proposant aucune récompense de valeur (par exemple, de l'argent ou des prix).
• 36 Significant Skin Exposure
  Images d'annonces dans lesquelles des parties du corps humain (du sternum à la mi-cuisse) ne sont pas vêtues ou si le corps porte des sous-vêtements, des maillots de bain, de la lingerie ou d'autres vêtements transparents, ou encore des articles non vestimentaires tels qu'une serviette ou un drap de lit.
• 37 Sensationalism
  Annonces visant à inciter les utilisateurs à cliquer dessus en attisant leur curiosité, souvent par le biais d'un message d'accroche contenant du texte ou des images outranciers. Cette catégorie inclut les annonces qui portent sur des sujets à caractère sensationnel (tels que l'arrestation, le décès ou le divorce de célébrités) ou qui ont pour but de choquer les utilisateurs.

Open Measurement

Les formats d'annonces actuellement compatibles incluent les annonces vidéo, les bannières et les annonces interstitielles. Pour en savoir plus, Pour savoir comment utiliser Open Measurement dans une réponse à l'enchère contenant ces formats, consultez le centre d'aide du SDK Open Measurement. .

Exemples de réponses aux enchères

Les sections suivantes présentent des exemples de réponses aux enchères pour différents types d'annonces.

Bannière d'application

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

Interstitiel pour application

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

Vidéo interstitielle pour application

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Annonce native d'application

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

Vidéo Web

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Bannière Web mobile pour l'enchérisseur sur une place de marché

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}