Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

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.