Passer au contenu principal

​
Bannières publicitaires sur les pages de catégories

Pour afficher des bannières publicitaires sur les pages de catégories, le processus est similaire à celui des pages de résultats de recherche. Au lieu d’utiliser le champ searchQuery, vous devez utiliser le champ category dans votre requête d’enchère. Il existe trois options pour spécifier la catégorie des marques, produits ou vendeurs participant à l’enchère :
  • Catégorie unique
  • Catégories multiples
  • Disjonctions de catégories

​
Exemple de requête - Bannière de catégorie unique

Recevez jusqu’à 5 résultats d’enchères en 1 appel API 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "homepage",
      "device": "mobile",
      "category": {
        "id": "c_yogurt"
      }
    }
  ]
}

​
Exemple de réponse - Catégorie

{
  "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
    }
  ]
}

​
Exemple : Disjonctions de catégories

Les disjonctions de catégories vous permettent de cibler plusieurs catégories dans une seule requête d’enchère. Vous pouvez spécifier plusieurs catégories et l’enchère prendra en compte les annonces de l’une de ces catégories. Cela est utile lorsque vous souhaitez afficher des bannières publicitaires pertinentes pour diverses catégories sur une page spécifique. Voici une requête d’enchère avec un seul emplacement de bannière ciblant à la fois les catégories de chaussures de randonnée et de chaussures de course en utilisant des disjonctions de catégories : 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "categories-ribbon",
      "category": {
        "disjunctions": [["hiking_boots", "running_shoes"]]
      }
    }
  ]
}
L’exemple de réponse ci-dessous comprend toutes les informations nécessaires pour diffuser les bannières publicitaires : 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "vendor",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
Vous pouvez demander jusqu’à 5 enchères dans une seule requête. Si vous avez plusieurs emplacements de bannières sur vos pages de catégories, vous pouvez demander des enchères pour eux en un seul appel.