Saltar al contenido principal
La Events API te permite enviar datos de interacción de usuarios en tiempo real a Topsort. Estos datos alimentan la atribución de campañas, reportes y algoritmos de optimización.

​
Tipos de Eventos

Topsort rastrea tres tipos principales de eventos:
EventoDescripciónCuándo Enviar
ImpressionEl usuario ve un producto promovidoCuando un producto patrocinado se renderiza en pantalla
ClickEl usuario hace clic en un producto promovidoCuando un usuario hace clic en un producto patrocinado
PurchaseEl usuario completa una transacciónCuando se confirma un pedido

​
Opciones de Integración

Direct API

Envía eventos directamente a la Events API de Topsort para máximo control y flexibilidad.

Analytics.js

Usa nuestro SDK de JavaScript para rastreo de eventos fácil del lado del cliente.

Twilio Segment

Enruta eventos a través de Segment si ya lo estás usando para analytics.

RudderStack

Integra vía RudderStack para enrutamiento unificado de eventos.

​
Conceptos Clave

​
Resolved Bid ID

El resolvedBidId es un identificador único devuelto por la Auctions API que vincula un evento a un ganador de subasta específico. Esto es requerido para eventos de impresión y clic para habilitar la atribución adecuada. 
{
  "impressions": [
    {
      "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVh...",
      "occurredAt": "2023-05-01T12:00:00Z"
    }
  ]
}

​
Atribución de Eventos

Los eventos se atribuyen a campañas basándose en:
  • Atribución directa: El usuario interactúa con un producto promovido y convierte
  • Atribución de halo: El usuario ve un producto promovido pero compra un producto diferente del mismo vendedor
Aprende más sobre modelos de atribución.

​
Pasos de Implementación

1

Almacenar el Resolved Bid ID

Al mostrar ganadores de subastas, almacena el resolvedBidId de la respuesta de la subasta.
2

Rastrear Impresiones

Envía un evento de impresión cuando un producto patrocinado se hace visible para el usuario.
3

Rastrear Clics

Envía un evento de clic cuando un usuario hace clic en un producto patrocinado.
4

Rastrear Compras

Envía eventos de compra cuando se completan pedidos, incluyendo todos los productos comprados.

​
Ejemplo: Enviar Eventos

curl -X POST https://api.topsort.com/v2/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "impressions": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:00Z"
      }
    ],
    "clicks": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:05Z"
      }
    ]
  }'

​
Próximos Pasos

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