Skip to main content

​
Configuración básica

Puedes instalar la integración de Google Analytics (GA4) desde nuestro Marketplace. Una vez instalada, podrás obtener resúmenes de tráfico, analizar el rendimiento por fuente y por página, monitorear cambios con alertas, listar propiedades disponibles y enviar resúmenes semanales.

​
Funcionalidades

​
Resumen de tráfico

Obtén métricas básicas de tráfico (usuarios, sesiones, pageviews, tasa de rebote y duración media de sesión) para un periodo dado. Inputs:
  • propertyId (string) — ID de la propiedad de GA4 (p. ej. "123456789").
  • dateRange (enum: YESTERDAY | LAST_7_DAYS | LAST_30_DAYS | CUSTOM) — Rango de fechas.
  • customStartDate (opcional, string) — Fecha inicio YYYY-MM-DD (requerido si dateRange es CUSTOM).
  • customEndDate (opcional, string) — Fecha fin YYYY-MM-DD (requerido si dateRange es CUSTOM).
Ejemplo: 
{
  "propertyId": "123456789",
  "dateRange": "CUSTOM",
  "customStartDate": "2025-11-01",
  "customEndDate": "2025-11-15"
}

​
Rendimiento por fuente

Consulta las fuentes/canales de tráfico y su desempeño, ordenando por una métrica específica. Inputs:
  • propertyId (string) — ID de la propiedad de GA4.
  • dateRange (enum: YESTERDAY | LAST_7_DAYS | LAST_30_DAYS | CUSTOM) — Rango de fechas.
  • metric (enum: sessions | conversions | avgSessionDuration) — Métrica a analizar.
  • customStartDate (opcional, string) — Fecha inicio YYYY-MM-DD (requerido si dateRange es CUSTOM).
  • customEndDate (opcional, string) — Fecha fin YYYY-MM-DD (requerido si dateRange es CUSTOM).
Ejemplo: 
{
  "propertyId": "123456789",
  "dateRange": "LAST_7_DAYS",
  "metric": "sessions",
  "customStartDate": "2025-11-09",
  "customEndDate": "2025-11-15"
}

​
Rendimiento de página

Obtén métricas de rendimiento para una página o path específico. Inputs:
  • propertyId (string) — ID de la propiedad de GA4.
  • pagePath (string) — Path de la página (p. ej. "/landing/promo").
  • dateRange (enum: YESTERDAY | LAST_7_DAYS | LAST_30_DAYS | CUSTOM) — Rango de fechas.
  • customStartDate (opcional, string) — Fecha inicio YYYY-MM-DD (requerido si dateRange es CUSTOM).
  • customEndDate (opcional, string) — Fecha fin YYYY-MM-DD (requerido si dateRange es CUSTOM).
Ejemplo: 
{
  "propertyId": "123456789",
  "pagePath": "/credito-pymes",
  "dateRange": "CUSTOM",
  "customStartDate": "2025-11-01",
  "customEndDate": "2025-11-15"
}

​
Monitorear cambio de tráfico

Monitorea cambios en métricas clave y envía alertas cuando superen un umbral. Inputs:
  • propertyId (string) — ID de la propiedad de GA4.
  • metric (enum: users | sessions | conversions) — Métrica a monitorear.
  • thresholdPercent (number) — Umbral porcentual (p. ej. 20 para ±20%).
  • direction (enum: increase | decrease) — Dirección del cambio a monitorear.
  • channel (opcional, enum: whatsapp | slack | email) — Canal para alertar.
  • webhookUrl (opcional, string) — Webhook para notificaciones.
Ejemplo: 
{
  "propertyId": "123456789",
  "metric": "sessions",
  "thresholdPercent": 20,
  "direction": "decrease",
  "channel": "slack",
  "webhookUrl": "https://hooks.slack.com/services/T000/B000/XXXX"
}

​
Listar propiedades

Lista todas las propiedades de GA4 disponibles para el usuario autenticado. Inputs: Sin inputs. Ejemplo: 
{}

​
Enviar resumen semanal

Genera y envía un reporte semanal de desempeño con diferentes niveles de detalle. Inputs:
  • propertyId (string) — ID de la propiedad de GA4.
  • metricSet (enum: basic | detailed | complete) — Nivel de detalle.
  • channel (opcional, enum: whatsapp | slack | email) — Canal para enviar el reporte.
  • webhookUrl (opcional, string) — Webhook para envío (si aplica).
  • recipientEmail (opcional, string) — Correo destinatario (si aplica).
Ejemplo: 
{
  "propertyId": "123456789",
  "metricSet": "complete",
  "channel": "email",
  "webhookUrl": "https://api.ejemplo.com/hooks/ga",
  "recipientEmail": "reportes@empresa.com"
}