> ## 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. # Atribuição de Banners > Aprenda como usar a API de leilões para alcançar a atribuição de compras de banners. Atribuir conversões à campanha correta é vital para otimizar o desempenho da campanha e permitir decisões baseadas em dados. Porque os banners podem vincular a vários tipos de destinos, configurar a atribuição requer um pouco mais de trabalho em comparação com as listagens. Neste exemplo, você aprenderá como configurar a atribuição para banners que vinculam a produtos, marcas ou vendedores. Vamos começar. # Visão Geral No contexto da atribuição de banners, o objetivo principal é rastrear e atribuir as conversões resultantes das interações com um banner e os produtos associados ao banner que você configurou na Topsort. Às vezes, um usuário pode ver um banner, clicar nele e depois realizar uma compra mais tarde. Em tais casos, é essencial atribuir a compra ao banner que inicialmente captou a atenção do usuário. ## Prática Comum/Recomendação Quando um usuário vê um banner dentro de uma página, qualquer compra subsequente de produtos associados ao banner pelo mesmo usuário deve ser atribuída à campanha do banner. # Implementação: Métodos de Atribuição Atualmente, existem **dois métodos principais** para atribuir uma compra a um banner dentro da plataforma, dependendo do tipo de página de destino para a qual o banner redireciona: um são as páginas de detalhe e listagem de produtos (PDP e PLP), e o outro são as páginas de vendedores. ## 1. Páginas de Detalhe e Listagem de Produtos (PDP e PLP) Este método envolve enviar um `resolvedBidId` junto com um objeto `additionalAttribution` em um evento de rastreamento vinculado a um produto específico. A jornada do usuário segue esta sequência: ### **Passo 1:** **A Página Carrega com um Banner** * Uma página com um banner que venceu um leilão da Topsort é carregada. * Se o banner estiver configurado para cobrar por CPM (Custo Por Mil), um **evento de impressão de banner** deve ser enviado à Topsort, incluindo o `resolvedBidId` da resposta do leilão, para fins de faturamento. * Se o usuário clicar no banner e ele estiver configurado para cobrar por CPC (Custo Por Clique), um **evento de clique de banner** deve ser enviado à Topsort, novamente usando o `resolvedBidId` da resposta do leilão, para fins de faturamento. ### **Passo 2:** **Clique do Usuário e Redirecionamento** * Ao clicar no banner, o usuário é redirecionado para a página de destino especificada. * A partir deste ponto, entram em jogo diferentes requisitos de eventos dependendo do tipo de página de destino do banner: **Caso 1.1. PDP (Página de Detalhe do Produto)** * Se o banner redirecionar para uma Página de Detalhe do Produto, um **evento de clique de produto** deve ser reportado à Topsort quando o usuário clicar no banner. * Este evento deve incluir o `resolvedBidId` do banner e o objeto `additionalAttribution`. * Neste caso, o objeto `additionalAttribution` deve ter: * **`id`**: ID do produto do produto clicado. * **`type`**: Definido como "product". * Esta abordagem garante que qualquer compra subsequente do produto seja atribuída ao banner original. Exemplo de um evento de clique com o objeto `additionalAttribution`: ```json theme={null} { "clicks": [ { "id": "9dcb05ad-9bb4-40da-bd71-663cab413564", "resolvedBidId": "ChAGcYkXyzR3q5UEOql7QpBd...", "placement": { "path": "/home/banner-destination-page" }, "occurredAt": "2024-10-23T06:03:21.403Z", "opaqueUserId": "7205415c-179f-4f7f-9fde-3ca8e7f16bc7", "additionalAttribution": { "id": "MKJY40600", "type": "product" } } ] } ``` **Caso 1.2. PLP (Página de Listagem de Produtos)** * Se o banner levar a uma Página de Listagem de Produtos, um **evento de clique de produto** deve ser enviado à Topsort apenas depois que o usuário clicar em um dos produtos listados. * Este evento deve incluir tanto o `resolvedBidId` do banner quanto um objeto `additionalAttribution`. * Isso garante que qualquer compra subsequente do produto clicado seja atribuída corretamente ao banner inicial. **Caso 1.3. BLP (Página de Destino de Marca ou Vendedor)** * Se o banner levar a uma página de marca ou vendedor, e o objetivo for atribuir as compras subsequentes àquela marca/vendedor, então deve ser usada a **atribuição Halo**. Consulte a próxima seção para mais detalhes. ## 2. Atribuição de vendedor Quando o banner redireciona para uma página de destino de vendedor ou se todas as compras de produtos de um vendedor após ver um banner relacionado a ele devem ser atribuídas, então usamos a atribuição Halo. Este tipo de atribuição vincula indiretamente uma compra ao banner associando o vendedor ou marca do `resolvedBidId` do evento de banner original. Isso garante que as compras sejam atribuídas mesmo quando o caminho de conversão não é direto. A atribuição Halo pode funcionar de duas maneiras: ### **2.1. Atribuição Apenas de Vendedor:** Os banners podem atribuir todas as compras de produtos de um vendedor específico ao banner que levou o usuário à página do vendedor. Entre em contato com a equipe da Topsort para configurar este método de atribuição em [support@topsort.com](mailto:support@topsort.com). ### **2.2. Vendedor + Outra Atribuição:** Esta abordagem é usada quando nem todos os banners redirecionam para páginas de vendedores e existem múltiplos tipos de páginas de destino. O fluxo é o mesmo descrito em [Páginas de Detalhe e Listagem de Produtos (PDP e PLP)](#1-páginas-de-detalhe-e-listagem-de-produtos-pdp-e-plp), mas cada item de produto comprado deve ser reportado com seu ID de vendedor. Exemplo: ```json theme={null} { "purchases": [ { "id": "06581ac9-0098-7797-b913-820b6bbbbed4", "opaqueUserId": "065e8780-d526-789c-a813-cd1a9ab08d8e", "occurredAt": "2024-10-28T07:43:54-06:00", "items": [ { "vendorId": "VEIA929919", "unitPrice": 900, "quantity": 1, "productId": "MKQUJ9191" } ] } ] } ```