GA4 Measurement Protocol
Envía eventos a Google Analytics 4 desde cualquier entorno JavaScript — servidores, workers, dispositivos IoT, o cualquier lugar donde el navegador no esté disponible. Una librería ligera y sin dependencias diseñada para producción.
GA4 server-side, bien hecho
Measurement Protocol
Implementación completa del Measurement Protocol de GA4 con gestión automática de sesiones y clientes.
Ligera
Cero dependencias. Funciona en Node.js, Bun, Deno, Cloudflare Workers y cualquier runtime JavaScript.
Gestión de Sesiones
Manejo de sesiones integrado con IDs de sesión automáticos, contadores de sesiones y tracking de engagement.
Validación de Eventos
Modo debug con soporte de endpoint de validación para detectar problemas antes de producción.
Up and running in minutes
Send your first event
import { Ga4mp } from "ga4mp";
const ga4mp = Ga4mp.createInstance({
measurement_id: "G-XXXXXXXXXX",
api_secret: "your_api_secret",
});
// Set client and session
ga4mp.setClientId("my-client-id");
ga4mp.setSessionId("my-session-id");
// Send an event
const event = ga4mp.createEvent("purchase", {
currency: "USD",
value: 49.99,
transaction_id: "T-12345",
items: [{
item_id: "SKU-001",
item_name: "Premium Plan",
price: 49.99,
quantity: 1,
}],
});
await event.send();Validate before production
// Use debug mode to validate events
// before sending to production
const ga4mp = Ga4mp.createInstance({
measurement_id: "G-XXXXXXXXXX",
api_secret: "your_api_secret",
debug: true, // Uses validation endpoint
});
const event = ga4mp.createEvent("purchase", {
currency: "USD",
value: 49.99,
});
const result = await event.send();
console.log(result.validationMessages);When to use GA4MP
The Measurement Protocol shines when browser-based tracking isn't an option.
Server-side event tracking from your backend API
Offline conversion imports from CRM or POS systems
IoT and embedded device analytics
Cloudflare Workers, Lambda, or edge function tracking
Hablemos
Tanto si necesitas una implementación desde cero, una auditoría de tu configuración actual o asesoramiento experto — estamos aquí para ayudarte.