Saltar para o conteúdo 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 anúncios de banner direcionados nas suas páginas de busca baseados nas consultas dos usuários, simplesmente inclua a consulta de busca e o ID do espaço na sua solicitação de leilão. Aqui está um exemplo que mostra um único espaço de banner em uma página de resultados de busca para dispositivos móveis: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "search_banner_top",
      "device": "mobile",
      "searchQuery": "blue running shoes"
    }
  ]
}
A resposta de amostra abaixo fornece todas as informações necessárias para servir o anúncio 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 pode ser “product”, “brand”, “vendor” ou “url” dependendo do objetivo da campanha de anúncios de banner vencedora.