Saltar para o conteúdo principal
Se você usa VTEX como sua plataforma de e-commerce, pode integrar o Topsort diretamente na sua loja VTEX para oferecer espaços publicitários aos seus vendedores. Esta integração é composta pelos seguintes aplicativos:
  • Integração de Catálogo
  • Integração de Leilões (Listagens Patrocinadas)
  • Integração de Eventos
Esses aplicativos trabalham juntos para sincronizar seu catálogo com o Topsort, exibir produtos patrocinados nos resultados de busca e rastrear interações do usuário para relatórios e otimização.

​
Pré-requisitos

  • Uma conta VTEX com acesso administrativo.
  • O VTEX IO Toolbelt instalado e configurado.
  • Uma conta Topsort com uma Chave de API do Marketplace e uma Chave de API Avançada.
Faça login na sua conta VTEX: 
vtex login {SEU_NOME_DE_CONTA}

​
Configurando sua Chave de API

Instale o aplicativo Topsort Services Settings: 
vtex install topsortpartnercl.services
Em seguida, configure a Chave de API:
  1. Vá para o admin do seu Workspace VTEX.
  2. Vá para App > Gerenciamento de Aplicativos e encontre o aplicativo de serviços.
  3. Clique em configurações e adicione a Chave de API, depois clique em Salvar.
Verifique a instalação acessando {{workspace__url}}/_v/ts/settings.

​
Importando Catálogo para o Topsort

Você pode integrar seu catálogo VTEX com o Topsort usando templates de feed XML. Etapas de Configuração:
  1. Navegue até Configurações da Loja > Canais > Integração XML no seu Admin VTEX
  2. Crie um novo template XML com os campos de produto necessários:
    • ID do Produto, título/nome, Marca, URL da Imagem, Preço (todos obrigatórios)
    • Descrição, Caminho da Categoria, código de referência SKU, EAN/código de barras (opcionais)
  3. Configure a Estrutura XML: 
<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <entry>
    <id>product-id</id>
    <title>Nome do Produto</title>
    <description>Descrição do produto</description>
    <productType>Categoria &gt; Subcategoria</productType>
    <brand>Nome da Marca</brand>
    <link>https://loja.com/url-produto</link>
    <imageLink>https://loja.com/imagem.jpg</imageLink>
    <price>99.99</price>
  </entry>
</feed>
  1. Gere e teste a URL do feed: https://{nome-do-seu-workspace}.vtexcommercestable.com.br/XMLData/{nome-do-xml}.xml
  2. Entre em contato com seu representante Topsort para configurar a integração do feed XML.

​
Listagens Patrocinadas nos Resultados de Busca

  1. Remova o aplicativo nativo vtex search resolver:
vtex uninstall vtex.search-resolver
  1. Instale o aplicativo Auction Integration:
vtex install topsortpartnercl.auctions@3.x
  1. Acesse o portal Admin VTEX, navegue até Apps > Meus Apps e encontre Topsort’s Auctions Integration.
  2. Configure o número de slots patrocinados e clique em Salvar.

​
Rastreando Eventos

O aplicativo Events Integration rastreia impressões, cliques e compras. 
vtex install topsortpartnercl.events@1.1.2
Acesse o portal Admin VTEX, navegue até Apps > Meus Apps e encontre Topsort’s Events Integration.

Precisa de ajuda com sua integração Topsort?

Fale conosco, a equipe de engenharia de integrações.Entre em contato através do seu canal de mensagens dedicado ou em support@topsort.com.Se você ainda não é cliente, agende uma demo com nossa equipe de vendas.