Saltar al contenido principal

​
Anuncios de Banner en Páginas de Categoría

Para mostrar anuncios de banner en páginas de categoría, el proceso es similar al de las páginas de resultados de búsqueda. En lugar de usar el campo searchQuery, debe usar el campo category en su solicitud de subasta. Hay tres opciones para especificar la categoría de marcas, productos o vendedores que participan en la subasta:
  • Categoría Única
  • Múltiples Categorías
  • Disyunciones de Categoría

​
Ejemplo de Solicitud - Banner de Categoría Única

Reciba hasta 5 resultados de subasta en 1 llamada API 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "homepage",
      "device": "mobile",
      "category": {
        "id": "c_yogurt"
      }
    }
  ]
}

​
Ejemplo de Respuesta - Categoría

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

​
Ejemplo: Disyunciones de Categoría

Las disyunciones de categoría le permiten dirigirse a múltiples categorías en una sola solicitud de subasta. Puede especificar múltiples categorías y la subasta considerará anuncios de cualquiera de esas categorías. Esto es útil cuando desea mostrar anuncios de banner que sean relevantes para varias categorías en una página específica. Aquí hay una solicitud de subasta con un solo espacio de banner dirigido a las categorías de botas de senderismo y zapatos para correr usando disyunciones de categoría: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "categories-ribbon",
      "category": {
        "disjunctions": [["hiking_boots", "running_shoes"]]
      }
    }
  ]
}
La respuesta de muestra a continuación incluye toda la información necesaria para servir los anuncios de banner: 
{
  "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
    }
  ]
}
Puede solicitar hasta 5 subastas en una sola solicitud. Si tiene múltiples espacios de banner en sus páginas de categoría, puede solicitar subastas para ellos en una sola llamada.