¿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 [Topsort JavaScript SDK](https://github.com/Topsort/topsort.js) es la biblioteca cliente oficial para integrarse con las APIs de subastas y seguimiento de eventos de Topsort. Construido en TypeScript, este SDK simplifica la integración, permitiendo la creación de un flujo end-to-end en minutos.
## Instalación
```html theme={null}
```
## Creando una Subasta
```javascript theme={null}
import { TopsortClient } from "https://unpkg.com/@topsort/sdk@latest/dist/index.mjs";
const topsortClient = new TopsortClient({ apiKey: window.TS.token });
const auctionDetails = {
auctions: [
{
type: "listings",
slots: 3,
searchQuery: "winter",
},
{
type: "banners",
slots: 1,
device: "desktop",
slotId: "slot123",
},
],
};
topsortClient
.createAuction(auctionDetails)
.then((result) => console.log("Auction Result", result))
.catch((error) => console.error("Auction Error", error));
```
## Reportando Eventos
```javascript theme={null}
const winners = auctionResult.results.flatMap((result) => result.winners || []);
if (winners.length > 0) {
const impressions = winners.map((winner) => ({
resolvedBidId: winner.resolvedBidId,
id: crypto.randomUUID(),
occurredAt: new Date().toISOString(),
opaqueUserId: crypto.randomUUID(),
placement: { path: "/search/winter" },
}));
topsortClient
.reportEvent({ impressions })
.then((result) => console.log("Event Result", result))
.catch((error) => console.error("Event Error", error));
}
```
## Errores Reintentables
La función `reportEvent` devuelve `retry: true` para errores 429 o 5xx:
```javascript theme={null}
topsortClient.reportEvent(eventPayload).then((result) => {
if (result.retry) {
console.warn("Transient error. Retry the call.");
}
});
```
Para la documentación completa y ejemplos end-to-end, consulta el [repositorio de GitHub](https://github.com/Topsort/topsort.js).
