# Integrar eventos

Los eventos son las acciones que vuestros clientes realizan, y permiten a Biteral aprender cómo interactúan con vuestros productos. Por ejemplo, algunos de los eventos más importantes que Biteral recopila son la compra de productos, la navegación por vuestro catálogo o incluso las devoluciones.

# Enviar un evento

Llama a events()->ingest con un objeto EventPayload como parámetro. Consulta los tipos de eventos disponibles para saber qué parametros adicionales debes añadir al objeto.

Enviar un evento con PHP

/php-sdk/events/send-events/

Haz una petición POST al endpoint /events

Enviar un evento con la API

/api/endpoints/events/post/

# Cuándo enviar un evento

Lo más sencillo es enviar los eventos en el mismo instante en que se producen en tu sistema. Además, esto hará que los resultados de Biteral estén actualizados casi en tiempo real. Sin embargo, si vuestro sistema genera muchos eventos, es mejor enviar los eventos en grupo:

Enviar eventos en grupo con PHP

/php-sdk/events/send-events-batch/

Enviar eventos en grupo con la API

/api/endpoints/events/post/#enviar-varios-eventos-a-la-vez

¿Cuántos eventos se consideran muchos? Por norma general, si vuestro sistema produce más de 1 evento cada 5 segundos (0.2 eventos/segundo) de forma relativamente continuada, es necesario enviar los eventos en grupo.