¿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.
;
};
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:
```http theme={null}
https://api.site.com/catalog/query?taxonomy=clothes
```
a:
```http theme={null}
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':
```http theme={null}
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:
```json theme={null}
{
"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:
```json theme={null}
{
"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:
```html theme={null}
