Saltar para o conteúdo principal

​
Anúncios de Banner em Páginas de Categoria

Para exibir anúncios de banner em páginas de categoria, o processo é similar ao das páginas de resultados de busca. Em vez de usar o campo searchQuery, você deve usar o campo category na sua solicitação de leilão. Existem três opções para especificar a categoria de marcas, produtos ou vendedores que participam do leilão:
  • Categoria Única
  • Múltiplas Categorias
  • Disjunções de Categoria

​
Exemplo de Solicitação - Banner de Categoria Única

Receba até 5 resultados de leilão em 1 chamada de API 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "homepage",
      "device": "mobile",
      "category": {
        "id": "c_yogurt"
      }
    }
  ]
}

​
Exemplo de Resposta - Categoria

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

​
Exemplo: Disjunções de Categoria

As disjunções de categoria permitem direcionar múltiplas categorias em uma única solicitação de leilão. Você pode especificar várias categorias e o leilão considerará anúncios de qualquer uma dessas categorias. Isso é útil quando você deseja exibir anúncios de banner que sejam relevantes para várias categorias em uma página específica. Aqui está uma solicitação de leilão com um único espaço de banner direcionado às categorias de botas de caminhada e tênis de corrida usando disjunções de categoria: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "categories-ribbon",
      "category": {
        "disjunctions": [["hiking_boots", "running_shoes"]]
      }
    }
  ]
}
A resposta de amostra abaixo inclui todas as informações necessárias para servir os anúncios 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
    }
  ]
}
Você pode solicitar até 5 leilões em uma única solicitação. Se você tiver múltiplos espaços de banner nas suas páginas de categoria, pode solicitar leilões para eles em uma única chamada.