Soumissionnaires - Réponse à la soumission

Remarque

Non pris en charge : le protocole AppNexusBidding n’est plus pris en charge ; cette documentation est destinée uniquement à des fins héritées.
Si vous êtes un nouveau soumissionnaire qui intègre Xandr, consultez le protocole d’enchère OpenRTB 2.4.

Un soumissionnaire enverra une réponse d’offre après avoir reçu une demande de soumission de la part d’Impression Bus. La réponse à l’offre inclura l’offre du soumissionnaire (« prix ») et la création choisie ("creative_id" ou "creative_code"). Cette création sera servie si l’offre est finalement acceptée par le serveur publicitaire.

Implémentation

Spécifications

Bid_response

Champ	Type	Description
`debug_text`	string	Ce champ de texte facultatif s’affiche dans le journal de débogage lors de l’appel d’un TinyTag avec &debug=1&bidder=BIDDER_ID&dongle=DONGLE ajouté à la chaîne de requête. Note: DONGLE (un mot de passe pour protéger la sortie de débogage d’un soumissionnaire) n’est nécessaire que si un mot de passe a été défini pour votre soumissionnaire. Obligatoire: Non
`no_bid`	bool	Si la valeur est « true », cela indique à Impression Bus que vous avez retourné une réponse valide, mais que vous avez choisi de ne pas enchérir. Ce champ no_bid est préférable lorsque vous souhaitez afficher l’intégralité `no_bid` de la réponse, pas seulement une balise particulière. Obligatoire: Non

Bid_response-responses>[ ]

Champ	Type	Description
`member_id`	int	ID du membre dont le créateur est choisi par le soumissionnaire dans le tableau « membres » dans la demande. Obligatoire: Oui
`auction_id_64`	int	ID de l’enchère pour laquelle cette réponse est envoyée. Obligatoire: Oui
`exclusive`	bool	Phase propriétaire : Si la valeur est « true », le créatif de cette réponse est servi. Aucun autre soumissionnaire ne sera autorisé à se faire concurrence pour l’impression. Obligatoire: Non
`no_bid`	bool	Si la valeur est « true », cela signale à Impression Bus que vous avez retourné une réponse valide, mais que vous avez choisi de ne pas enchérir sur cette balise. Obligatoire: Non
`price`	double	Prix brut, exprimé en CPM, que le soumissionnaire est prêt à payer pour cette impression. S’il est exclusif, il est utilisé uniquement à des fins de création de rapports ; S’il n’est pas exclusif, seul un soumissionnaire qui paie plus que le prix de réserve sera en mesure de soumissionner aux enchères. Il doit s’agir d’un simple nombre décimal. Si la valeur est une chaîne, nous évaluerons la chaîne sur un 0. Vérifiez donc que la valeur est un nombre. Obligatoire: Non
`userdata_js`	string	Les commandes javascript userdata pour modifier les userdata si la réponse de ce soumissionnaire est sélectionnée. Note: Si le champ no_cookies sur la demande d’enchère est défini sur true, il n’existe aucune garantie que `userdata_js` les commandes seront exécutées correctement (car AppNexus peut ne pas être en mesure de stocker des informations sur l’utilisateur). Obligatoire: Non
`custom_notify_data`	chaîne	Ce champ de texte de forme libre peut être utilisé pour transmettre des informations à la demande de notification. Il s’agit d’une URL et/ou d’un cookie encodées automatiquement par ImpBus, afin qu’elle puisse être transmise sous forme de texte libre. Obligatoire: Non
`creative_id`	int	Phase propriétaire : ID du créatif à utiliser comme nouveau créatif par défaut pour l’impression. Phase non propriétaire : ID du créatif qui est soumis dans le cadre de la soumission du membre pour l’impression. Obligatoire: Oui (si aucun code n’est fourni).
`creative_code`	chaîne	Code personnalisé du créatif passé au service créatif. Obligatoire: Oui (si aucun code n’est fourni).
`click_url`	string	URL de clic à associer au créatif. Si le créatif a déjà configuré un `click_url` , la valeur de la réponse d’enchère est ajoutée à l’URL existante. Vous pouvez également utiliser des macros personnalisées pour votre suivi des clics. Obligatoire: Non
`pixel_url`	chaîne	URL de pixel à associer au créatif. Ce pixel sera utilisé pour l’inventaire non sécurisé. Obligatoire: Non
`pixel_type`	enum	Type de pixel à utiliser : « javascript » ou « image » (par défaut, image s’il n’est pas fourni). Obligatoire: Non
`deal_id`	int	ID de la transaction que vous souhaitez utiliser pour cette vente aux enchères. Obligatoire: Non

Bid_response-responses>[ ]->custom_macros[ ]

Champ	Type	Description
`name`	string	Nom de la macro à remplacer dans l’une des URL de la création (média, pixel, clic, etc.) ou dans le contenu. Le nom peut contenir des caractères à l’exception du carat (^) et doit être mis en forme comme `${MACRO_NAME}` dans les URL ou le contenu du créatif. Note: Les macros personnalisées sont remplacées APRÈS que les macros système ont été remplacées. Pour plus d’informations sur les macros personnalisées, consultez Creative Service. Obligatoire: Non
`value`	string	Valeur utilisée pour remplacer la macro. La valeur peut contenir des caractères à l’exception du carat (^). Ne pas placer de barres obliques dans une séquence d’échappement. Note: Même si la valeur est un entier, elle doit être placée entre guillemets doubles.

ID de la vente aux enchères

Chaque réponse d’enchère doit inclure l’ID d’enchère pour l’étiquette à laquelle elle répond. Plusieurs réponses peuvent être données pour la même enchère.
Les réponses aux enchères dans lesquelles no_bid est défini sur true doivent inclure l’ID de l’enchère.

Limites des données personnalisées (macros et données de notification)

AppNexus n’impose pas de limites aux données transmises dans le custom_macros tableau ou le custom_notify_data champ, mais nous vous recommandons de limiter le nombre total de données personnalisées transmises à 1 000 caractères ou moins. Ces données doivent être encodées et envoyées au navigateur de l’utilisateur pour certains types d’inventaire (vendeurs externes, emplacements iFrame) dans le cadre d’une URL de redirection, et les URL plus longues peuvent s’arrêter sous certains navigateurs et pour certains vendeurs.

Exemple

Réponse d’étiquette unique (à l’aide de l’ID créatif avec pixel)

{
   "bid_response":{
      "responses":[
         {
            "member_id":3,
            "price":11.170,
            "creative_id":11,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         }
      ]
   }
}

Étiquette unique, enchères multiples (à l’aide de l’ID créatif avec pixel)

{
   "bid_response":{
      "responses":[
         {
            "member_id":3,
            "price":11.170,
            "creative_id":11,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         },
         {
            "member_id":3,
            "price":9.200,
            "creative_id":12,
            "pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
            "pixel_type":"image",
            "auction_id_64": 2345245234523
         }
      ]
   }
}

Réponse à plusieurs étiquettes (à l’aide de code créatif et de macros personnalisées)

{
   "bid_response":{
      "responses":[
         {
            "member_id":7,
            "price":3.12,
            "creative_code":"23219",
            "custom_macros":[
               {
                  "name":"CAMPAIGN_ID",
                  "value":452346
               },
               {
                  "name":"INT_CODE",
                  "value":"a352-45we-sdr3"
               }
            ],
            "userdata_js":"update_frequency(23219)",
            "auction_id_64": 2345245234523
         },
         {
            "member_id":14,
            "price":1.14,
            "creative_code":"23219",
            "custom_macros":[
               {
                  "name":"CAMPAIGN_ID",
                  "value":452312
               },
               {
                  "name":"INT_CODE",
                  "value":"c231-4sa2-css5"
               }
            ],
            "userdata_js":"update_frequency(23219)",
            "auction_id_64": 2432387423232
         }
      ]
   }
}

Réponse à une transaction

{
   "bid_response":{
      "responses":[
         {
            "member_id":5555,
            "price":0.75,
            "creative_id":11,
            "auction_id_64": 5555508250840350700,
            "deal_id": 555664
         }
      ]
   }
   }

Last updated on 2025-10-21

Partager via