Passer au contenu principal
Pour diffuser des bannières publicitaires ciblées sur vos pages de recherche en fonction des requêtes des utilisateurs, incluez simplement la requête de recherche et l’ID d’emplacement dans votre requête d’enchère. Voici un exemple présentant un seul emplacement de bannière sur une page de résultats de recherche pour les appareils mobiles : 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "search_banner_top",
      "device": "mobile",
      "searchQuery": "blue running shoes"
    }
  ]
}
L’exemple de réponse ci-dessous fournit toutes les informations nécessaires pour diffuser la bannière publicitaire : 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "product",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
winnerType peut être “product”, “brand”, “vendor” ou “url” en fonction de la cible de la campagne de bannières publicitaires gagnante.