Passer au contenu principal

​
Carrousels et swimlanes de bannières

Vous pouvez créer des carrousels et des swimlanes en utilisant les bannières en demandant une enchère pour les bannières et en spécifiant le nombre de bannières dont vous avez besoin pour le carrousel ou la swimlane. Les candidats de bannières seront les campagnes de bannières créées pour le slotId lié au carrousel ou à la swimlane. Topsort renverra l’id de produit des gagnants et les ressources avec des liens vers les créations à ajouter au carrousel ou à la swimlane.
Vous pouvez également créer un seul emplacement de bannière pour le carrousel ou la swimlane et demander 3 résultats de l’enchère.
Par exemple, supposons que vous ayez une page de destination “Rentrée scolaire” avec un carrousel présentant trois campagnes de différentes marques. Lorsqu’un visiteur arrive sur cette page, vous ferez une requête avec le paramètre slots défini sur 3 afin que Topsort puisse fournir au moins trois gagnants. Après avoir reçu les gagnants, vous pouvez ajouter les trois bannières publicitaires au carrousel. S’il y a moins de trois gagnants, vous pouvez soit ajouter une image de secours pour les promotions de votre marketplace, soit afficher seulement une ou deux bannières.

​
Requête

Voici un exemple de requête d’enchère pour un carrousel avec trois emplacements de bannières ciblant les marques : 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 3,
      "slotId": "backtoschool-carousel"
    }
  ]
}

​
Réponse

La réponse comprendra trois produits que vous pouvez afficher dans le carrousel, classés par les résultats de l’enchère. S’il n’y a pas d’enchères qualifiantes (pas de gagnants) ou s’il y a eu une erreur, la réponse sera vide. Dans ce cas, vous ne pouvez afficher que les résultats organiques. Une nouvelle variable booléenne, error, indique si l’enchère a été résolue avec succès. Voici un exemple de réponse pour un appel avec une requête d’enchère utilisant l’API V2 au format JSON : 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "brand",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        },
        {
          "rank": 2,
          "type": "brand",
          "id": "p_8VKDt",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_Paesa2N-1x.png"
            }
          ]
        },
        {
          "rank": 3,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbasnx-2x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}