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

# Solicitação e Resposta de Leilão de Marcas Patrocinadas

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>
    </>;
};

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Os leilões de Marcas Patrocinadas funcionam enviando solicitações de leilão com detalhes de
  posicionamento e gatilhos de segmentação, e então recebendo respostas estruturadas contendo
  campanhas vencedoras com todos os ativos criativos e metadados necessários.
</div>

## Modelos Disponíveis

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  As campanhas de Marcas Patrocinadas são criadas usando um dos três modelos pré-construídos:
</div>

* **Coleção de Produtos**: Vários produtos exibidos em uma página de destino para descoberta abrangente de produtos
* **Destaque de Produto**: Produto único e um criativo
* **Destaque da Loja**: Direciona tráfego diretamente para a página da loja de um fornecedor para reconhecimento de marca

## Solicitação de Leilão

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  As solicitações de leilão para Marcas Patrocinadas seguem o formato padrão de leilão com
  gatilhos específicos para segmentação e suporte para filtragem baseada em geolocalização:
</div>

```json theme={null}
{
  "auctions": [
    {
      "winners": 2,
      "placementId": "some-placement",
      "triggers": {
        "products": {
          "ids": ["pmk_1", "pmk_8"]
        },
        "category": {
          "id": "electronics"
        },
        "searchQuery": "cool electronics"
      },
      "geoTargeting": "santiago",
      "opaqueUserId": "user-123"
    }
  ]
}
```

### Parâmetros da Solicitação

* **winners**: Número de campanhas de marcas patrocinadas a retornar
* **placementId**: Identificador do espaço de posicionamento de marcas patrocinadas
* **triggers**: Critérios de segmentação usando um dos seguintes:
  * **products.ids**: Array de IDs de produtos específicos para segmentar
  * **category.id**: Categoria de produto para segmentação mais ampla
  * **searchQuery**: Termos de pesquisa para segmentação baseada em palavras-chave
* **geoTargeting**: Identificador de localização geográfica para filtragem de campanha baseada em localização
* **opaqueUserId**: Identificador anônimo do usuário para personalização e segmentação aprimorada

### Comportamento de Filtragem por Geolocalização

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  O sistema de leilão filtra automaticamente as campanhas com base na segmentação por geolocalização:
</div>

* **Correspondência de Localização**: Campanhas com configurações específicas de geolocalização só participam quando o campo `geoTargeting` corresponde às suas localizações configuradas
* **Sem Geolocalização**: Campanhas sem restrições de geolocalização participam de todos os leilões independentemente do valor `geoTargeting`
* **Várias Localizações**: Campanhas direcionadas a várias localizações participam quando a solicitação corresponde a qualquer uma de suas localizações configuradas
* **Compatibilidade com Versões Anteriores**: Campanhas existentes sem geolocalização continuam a funcionar como antes

## Resposta do Leilão

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  A resposta do leilão retorna campanhas vencedoras de marcas patrocinadas com ativos
  criativos completos e metadados:
</div>

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "resolvedBidId": "ChAGc-G66Wt7LKQEOcW8VBdIEhABjz_zDXx7db-ZYpxiwJ3DGhABjr4Lt_J0_a7Xv_uIfyOXIgUKATEQATDrrg8",
          "productId": "pmk_1",
          "type": "url",
          "id": "www.topsort.com",
          "vendorId": "vendor_id",
          "content": {
            "headline": "Campaign Headline",
            "logo": "https://some.url.com/logo.jpeg"
          },
          "campaignId": "018f3ff3-0d7c-7b75-bf99-629c62c09dc3",
          "productIds": ["pmk_1", "pmk_4", "pmk_8"]
        }
      ],
      "error": false
    }
  ]
}
```

### Campos da Resposta

#### Objeto Winner

* **rank**: Classificação de posição da campanha vencedora
* **resolvedBidId**: Identificador único para rastreamento de lance e atribuição
* **productId**: Identificador do produto principal da campanha
* **type**: Tipo de campanha (sempre "product" para marcas patrocinadas)
* **id**: Identificador da campanha
* **title**: Título da campanha para fins de exibição
* **campaignId**: UUID da campanha de marcas patrocinadas
* **productIds**: Array de todos os produtos incluídos na campanha (1-5 produtos)

#### Array de Assets

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Ativos criativos para renderizar o anúncio de marcas patrocinadas:
</div>

* **url**: URL da CDN para o ativo
* **role**: Tipo de ativo ("image" para banner criativo, "logo" para logotipo da marca)
* **contentType**: Tipo MIME do ativo
* **contentLength**: Tamanho do arquivo em bytes
* **width/height**: Dimensões do ativo em pixels

#### Objeto Content

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Conteúdo da campanha para renderização:
</div>

* **headline**: Texto do título da campanha
* **brandName**: Nome da marca ou fornecedor
* **creative1**: URL de ativo criativo adicional (vídeos, imagens secundárias)

## Notas de Implementação

### Flexibilidade de Renderização

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Os ativos criativos, título e productIds são retornados separadamente na
  resposta do leilão, permitindo que você renderize esses elementos de acordo com seus
  requisitos de design frontend. O array de assets contém todos os componentes criativos
  necessários com identificação clara de função.
</div>

### Suporte Multi-Produto

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  As campanhas de marcas patrocinadas podem promover de 1 a 5 produtos simultaneamente. O
  array `productIds` contém todos os produtos incluídos na campanha, enquanto
  `productId` representa o produto principal para fins de rastreamento.
</div>

### Integração de Modelos

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Embora as campanhas sejam criadas usando modelos disponíveis (Coleção de Produtos,
  Destaque de Produto, Destaque da Loja), a resposta do leilão fornece todos os
  ativos e conteúdo necessários independentemente do modelo usado, garantindo
  integração consistente em todos os tipos de campanha.
</div>

### Especificações de Conteúdo

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Todos os ativos criativos (imagens e vídeos) carregados para campanhas de Marcas Patrocinadas
  devem atender a estes requisitos:
</div>

* **Formatos suportados**: JPEG, PNG, WEBP, GIF, MP4
* **Tamanho máximo do arquivo**: 5MB por criativo/vídeo

***

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