Saltar al contenido principal
Si usas VTEX como tu plataforma de e-commerce, puedes integrar Topsort directamente en tu tienda VTEX para ofrecer espacios publicitarios a tus vendedores. Esta integración está compuesta por las siguientes apps:
  • Catalog Integration
  • Auctions Integration (Sponsored Listings)
  • Events Integration
Estas apps trabajan juntas para sincronizar tu catálogo con Topsort, mostrar productos patrocinados en los resultados de búsqueda y rastrear las interacciones del usuario para reportes y optimización.

​
Prerrequisitos

  • Una cuenta VTEX con acceso administrativo.
  • El VTEX IO Toolbelt instalado y configurado.
  • Una cuenta Topsort con un Marketplace API Key y un Advanced API Key.
Inicia sesión en tu cuenta VTEX: 
vtex login {YOUR_ACCOUNT_NAME}

​
Configurando tu API Key

Instala la app Topsort Services Settings: 
vtex install topsortpartnercl.services
Luego configura el API Key:
  1. Ve al admin de tu VTEX Workspace.
  2. Ve a App > App Management y encuentra la app services.
  3. Haz clic en settings y agrega el API Key, luego haz clic en Save.
Verifica la instalación yendo a {{workspace__url}}/_v/ts/settings.

​
Importando Catálogo a Topsort

Puedes integrar tu catálogo VTEX con Topsort usando plantillas de feed XML. Pasos de Configuración:
  1. Navega a Store Settings > Channels > XML Integration en tu Admin VTEX
  2. Crea una nueva plantilla XML con los campos de producto requeridos:
    • Product ID, title/name, Brand, Image URL, Price (todos requeridos)
    • Description, Category path, SKU reference code, EAN/barcode (opcionales)
  3. Configura la Estructura XML: 
<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <entry>
    <id>product-id</id>
    <title>Product Name</title>
    <description>Product description</description>
    <productType>Category &gt; Subcategory</productType>
    <brand>Brand Name</brand>
    <link>https://store.com/product-url</link>
    <imageLink>https://store.com/image.jpg</imageLink>
    <price>99.99</price>
  </entry>
</feed>
  1. Genera y prueba la URL del feed: https://{your-workspace-name}.vtexcommercestable.com.br/XMLData/{name-of-the-xml}.xml
  2. Contacta a tu representante de Topsort para configurar la integración del feed XML.
  1. Elimina la app nativa vtex search resolver:
vtex uninstall vtex.search-resolver
  1. Instala la app Auction Integration:
vtex install topsortpartnercl.auctions@3.x
  1. Accede al portal Admin de VTEX, navega a Apps > My Apps, y encuentra Topsort’s Auctions Integration.
  2. Configura el número de slots patrocinados y haz clic en Save.

​
Rastreando Eventos

La app Events Integration rastrea impresiones, clics y compras. 
vtex install topsortpartnercl.events@1.1.2
Accede al portal Admin de VTEX, navega a Apps > My Apps, y encuentra Topsort’s Events Integration.

¿Necesitas ayuda con tu integración de Topsort?

Habla con nosotros, el equipo de ingeniería de integraciones.Contáctanos a través de tu canal de mensajería dedicado o en support@topsort.com.Si aún no eres cliente, agenda una demo con nuestro equipo de ventas.