Saltar al contenido 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.

Para servir anuncios de banner dirigidos en sus páginas de búsqueda basados en las consultas de los usuarios, simplemente incluya la consulta de búsqueda y el ID del espacio en su solicitud de subasta. Aquí hay un ejemplo que muestra un solo espacio de banner en una página de resultados de búsqueda para dispositivos móviles:
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "search_banner_top",
      "device": "mobile",
      "searchQuery": "blue running shoes"
    }
  ]
}
La respuesta de muestra a continuación proporciona toda la información necesaria para servir el anuncio de banner:
{
  "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 puede ser “product”, “brand”, “vendor” o “url” según el objetivo de la campaña de anuncios de banner ganadora.