Saltar al contenido principal
El proxy es una capa intermedia entre el backend del marketplace y el servidor de resultados (el servidor de Algolia, por ejemplo). Actúa como un puente entre el marketplace, el motor de búsqueda y Topsort. Esto permite al proxy ingerir los ganadores de la subasta recuperados de Topsort en la respuesta proporcionada por el motor de búsqueda, y devolver la respuesta final fusionada al marketplace. El proxy es compatible con la mayoría de los stacks tecnológicos, y ha sido probado con plataformas como VTEX, Algolia y Salesforce.

​
Cómo Usar el Proxy

Para comenzar a usar el proxy, solo necesitas cambiar el hostname en tu llamada API existente, desde tu catálogo o motor de búsqueda a nuestro proxy. Por ejemplo, cambiar de: 
https://api.site.com/catalog/query?taxonomy=clothes
a: 
https://site.proxy.topsort.com/catalog/query?taxonomy=clothes
Y nosotros nos encargamos del resto. Enviamos la solicitud al motor de subasta de Topsort y al catálogo o motor de búsqueda. Si alguno de los productos devueltos por el catálogo o motor de búsqueda está promocionado, lo indicaremos en la respuesta fusionada que construiremos, la cual será devuelta al marketplace. Actualmente, el proxy admite respuestas application/json. El soporte para XML y GraphQL está planificado.

​
Cómo Se Agregan los Productos Promocionados

Considera la siguiente solicitud, que obtiene productos de la taxonomía ‘office’: 
GET https://api.site.com/catalog/query?taxonomy=office
La respuesta del catálogo o servidor de búsqueda sin la integración del proxy de Topsort: 
{
  "products": [
    { "id": "1", "name": "High-Speed Color Laser Printer" },
    { "id": "2", "name": "Adjustable Height Standing Desk" },
    { "id": "3", "name": "Ergonomic Swivel Office Chair" },
    { "id": "4", "name": "Wireless Keyboard and Mouse Combo" },
    { "id": "5", "name": "Magnetic Whiteboard with Marker Set" }
  ]
}
Después de fusionar productos promocionados en la respuesta: 
{
  "products": [
    {
      "id": "3",
      "name": "Ergonomic Swivel Office Chair",
      "rank": 1,
      "resolvedBidId": "..."
    },
    {
      "id": "6",
      "name": "Multi-drawer Filing Cabinet",
      "rank": 2,
      "resolvedBidId": "..."
    },
    { "id": "1", "name": "High-Speed Color Laser Printer" },
    { "id": "2", "name": "Adjustable Height Standing Desk" },
    { "id": "4", "name": "Wireless Keyboard and Mouse Combo" }
  ],
  "topsort": {
    "winners": [
      { "rank": 1, "type": "product", "id": "3", "resolvedBidId": "..." },
      { "rank": 2, "type": "product", "id": "6", "resolvedBidId": "..." }
    ]
  }
}

​
Entendiendo los Nuevos Campos

  • rank: La posición del producto promocionado en la subasta.
  • resolvedBidId: Un ID único usado para rastrear el producto en analytics.
Un nuevo objeto llamado topsort se agrega al nivel raíz solo cuando se incluyen productos promocionados.

​
Cómo Rastrear Eventos

Si usas la biblioteca analytics.js de Topsort o Events API, usa los campos product id y resolvedBidId para rastrear las interacciones del usuario: 
<div class="product" data-ts-product="3" data-ts-resolved-bid="resolvedBidId">
  ...
</div>

​
Características del Proxy

  • Caché de Respuestas: Reduce la latencia al almacenar en caché respuestas exitosas del catálogo o motor de búsqueda.
  • Modo Staging: Permite probar antes de poner en vivo.
  • Soporte de Sincronización de Catálogo: Envía información para mantener el catálogo de Topsort actualizado.
  • Logging Integrado: Recopila datos sobre productos, subastas y rendimiento.

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