> ## 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.

# Tipos de Leilão

> Entendendo os diferentes mecanismos de leilão no Topsort

export const LastUpdatedPt = ({date}) => {
  const label = "Última atualização:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

## Listagens Patrocinadas

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Listagens patrocinadas integram produtos promovidos nos resultados de busca ou
  páginas de categoria. Esses leilões permitem que os vendedores promovam
  produtos específicos dentro de contextos relevantes. O endpoint `/auctions` é
  usado para executar esses leilões.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Existem três tipos principais de listagens patrocinadas:
</div>

1. **Listagens patrocinadas de um conjunto de produtos:** Isso permite leilões para um conjunto predefinido de IDs de produtos. Apenas lances direcionados a esses produtos específicos participarão. Você também pode incluir pontuações de qualidade personalizadas para cada produto na requisição, que são números entre 0 e 1 indicando relevância.
2. **Listagens patrocinadas em páginas de categoria:** Esses leilões são para produtos pertencentes a categorias específicas. Apenas lances que visam produtos dentro das categorias especificadas serão considerados. As categorias podem ser especificadas usando um único ID, múltiplos IDs (todas as categorias) ou disjunções (pelo menos uma das categorias).
3. **Listagens patrocinadas em resultados de busca:** Esses leilões são para produtos relevantes às consultas de busca. Você pode usar o parâmetro `searchQuery`, ou combiná-lo com um conjunto predefinido de produtos para expandir a lista de lances.

## Banners Patrocinados

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Banners patrocinados permitem a criação de leilões para anúncios em banner em
  várias páginas, como páginas iniciais ou landing pages. Eles podem ser usados
  para sliders de página inicial, marcas em destaque e carrosséis. O endpoint
  `/auctions` é usado para leilões de banner, com o campo `type` definido como
  `"banners"`.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Leilões de banner podem ser segmentados com base em:
</div>

1. **Landing Pages:** Crie slots para páginas iniciais de alto tráfego ou landing pages personalizadas com SlotIDs únicos, nomes, URLs e dimensões de imagem.
2. **Categoria e Busca:** Permita que os vendedores segmentem categorias ou palavras-chave específicas usando os campos `categoryId` ou `searchQuery` na requisição do leilão.
3. **Carrosséis e Swimlanes:** Múltiplos vencedores de banner podem ser solicitados para carrosséis ou swimlanes especificando o número desejado de slots na requisição do leilão.

## Anúncios em Vídeo

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Anúncios em vídeo são projetados para aprimorar a experiência de marca e
  produto mostrando produtos em ação, aumentando a visibilidade e engajando os
  clientes. A criação de campanhas para anúncios em vídeo segue o mesmo processo
  dos anúncios em banner, permitindo upload de vídeo e configuração de campanha.
  Os formatos de vídeo suportados incluem MP4 e MOV, com duração de 6 a 20
  segundos e tamanho máximo de 200MB. Os marketplaces enviam um ID de slot e
  detalhes opcionais na requisição do leilão e recebem uma URL de vídeo na
  resposta.
</div>

## Marcas Patrocinadas

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Leilões de marcas patrocinadas permitem a promoção de marcas usando assets,
  texto e um produto associado. O endpoint dedicado para esses leilões é
  `/auctions/sponsored-brand`. Os campos principais na requisição incluem
  `winners` (número máximo de vencedores), `placementId` (ID do posicionamento
  do anúncio) e `triggers.products.ids` (array de IDs de produtos associados).
</div>

## Listagens de Viagem

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Listagens de viagem envolvem um novo endpoint de leilão e modelo de campanha
  projetado especificamente para o caso de uso de viagens, como hotéis e voos.
  Este tipo de leilão considera parâmetros únicos como `travel_window` (período
  da viagem), `day_of_check_in` e `types_of_travelers` (família, casal, solo,
  grupo). Esses parâmetros podem influenciar os valores dos lances através de
  valores multiplicadores. A requisição de leilão para listagens de viagem
  inclui detalhes como `type` (hotéis ou voos), `winners`, `products` (com IDs e
  pontuações de qualidade/preços opcionais) e um objeto `travelContext` com
  informações relevantes específicas de viagem.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Consulte a seção [API de Leilões](/pt/ad-server/auctions/auctions-api) no Guia
  de Integração para mais informações e exemplos sobre como criar Leilões.
</div>

***

<LastUpdatedPt date="2025-11-18" />