Saltar al contenido principal
Esta guía muestra cómo integrar los resultados de subasta de Topsort con tu índice existente de Algolia, permitiendo que productos orgánicos y promovidos se listen en el mismo flujo. Algolia es un potente motor de búsqueda que proporciona resultados rápidos y relevantes para navegar catálogos. Al integrar Algolia con Topsort, podemos sincronizar tu catálogo directamente en Topsort, sin necesitar integraciones de catálogo adicionales. La integración también te permitirá priorizar productos promovidos en los resultados orgánicos devueltos por Algolia. Consulta la integración Proxy de Topsort para más detalles.

​
Cómo Funciona

1

Prerrequisitos

Para integrar Topsort con Algolia, asegúrate de cumplir con estos prerrequisitos:
  • Tu catálogo de productos está almacenado en un índice de Algolia.
  • Estás consultando Algolia usando el SDK de Algolia.
2

Crear API Key

Crea una API key de Algolia con los siguientes permisos: search, browse, listIndexes (pueden necesitarse permisos adicionales como addObject y deleteObject dependiendo de cómo gestiones las actualizaciones de tu índice).
  • El permiso browse permite descargar tu catálogo completo.
  • El permiso listIndexes permite a Topsort verificar la fecha de última modificación del índice para evitar actualizaciones innecesarias
3

Compartir Detalles del Índice

Contacta al soporte de Topsort y comparte el nombre de tu índice de Algolia. Esto permite a Topsort configurar y comenzar a importar tu catálogo.
4

Configurar Topsort Proxy

Actualiza tu configuración del SDK de Algolia para apuntar al Proxy de Topsort. Esto permitirá a Topsort priorizar productos promovidos en los resultados orgánicos devueltos por Algolia.
import algoliasearch from 'algoliasearch/lite';

const client = algoliasearch('YourApplicationID', 'YourWriteAPIKey', {
  hosts: [{ url: 'myslug-sandbox.topsort.workers.dev' }],
});
const index = client.initIndex('your_index_name');

​
Resultados de Subasta y Rastreo de Eventos

Los productos promovidos priorizados en la respuesta del Proxy de Topsort tendrán un parámetro resolvedBidId que identifica únicamente la subasta de ese producto. Puedes usarlo para marcar visualmente el producto como “Promovido” para el usuario final. El resolvedBidId también es necesario para identificar el ganador de la subasta al reportar eventos (impresiones, clics, compras). Consulta nuestra documentación de Rastreo de Eventos para más detalles.