Saltar al contenido principal

Guía de Inicio Rápido

🚀 Acceso Inmediato al CDP​

Para Usuarios de Negocio​

  1. Acceder al Dashboard

  2. Explorar Métricas Principales

    • Segmentación RFM (11 segmentos)
    • Customer Lifetime Value (CLV)
    • Análisis de churn
    • Salud del negocio 360°

  3. Activar tu Primera Campaña

    • Email automation
    • Recuperación de carritos abandonados
    • Segmentación por comportamiento

Para Desarrolladores​

1. Configuración Inicial​

# Clonar repositorio (requiere acceso privado)
git clone https://github.com/NomadaDigital01/nerdistan-datalake.git
cd nerdistan-datalake

# Instalar dependencias Python
pip install -r requirements.txt

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus credenciales

2. Variables de Entorno Requeridas​

# Database
DATABASE_URL=postgresql://user:password@host:port/database

# API Settings
PORT=8000
DEBUG=false
ENVIRONMENT=production

# JWT
JWT_SECRET=your-secret-key

# Integrations
VTEX_API_KEY=your-vtex-key
VTEX_API_TOKEN=your-vtex-token

3. Iniciar Desarrollo Local​

# Backend API
python app.py

# Frontend (repositorio separado)
git clone https://github.com/NomadaDigital01/nerdistan-cdp-frontend.git
cd nerdistan-cdp-frontend
npm install
npm start

📊 APIs Principales​

Customer APIs​

# Enviar evento de cliente
POST /api/v2/cdp/events
{
  "tenant_id": 1,
  "customer_id": "123",
  "event_type": "purchase",
  "data": {...}
}

# Obtener perfil completo
GET /api/v2/cdp/customers/123/profile?tenant_id=1

# Timeline de actividad
GET /api/v2/cdp/customers/123/timeline?tenant_id=1

Analytics APIs​

# Análisis RFM
GET /api/v2/cdp/analytics/rfm?tenant_id=1

# Predicción de churn
GET /api/v2/cdp/analytics/churn?tenant_id=1

# Customer Lifetime Value
GET /api/v2/cdp/analytics/clv?tenant_id=1

Processing APIs​

# Ejecutar procesamiento CDP
POST /api/v2/cdp/process/1

# Ver estado del procesamiento
GET /api/v2/cdp/process/1/status

🎯 Casos de Uso Rápidos​

1. Segmentación RFM Automática​

import requests

# Obtener segmentos RFM
response = requests.get(
    "https://nerdistan-datalake-production.up.railway.app/api/v2/cdp/analytics/rfm",
    params={"tenant_id": 1}
)

segments = response.json()
# Champions, Loyal Customers, Potential Loyalists, etc.

2. Predicción de Churn​

# Detectar clientes en riesgo
response = requests.get(
    "https://nerdistan-datalake-production.up.railway.app/api/v2/cdp/analytics/churn",
    params={
        "tenant_id": 1,
        "risk_threshold": 0.7
    }
)

at_risk_customers = response.json()

3. Email Automation​

# Activar campaña de recuperación de carritos
response = requests.post(
    "https://nerdistan-datalake-production.up.railway.app/api/v2/cdp/campaigns/abandoned-cart",
    json={
        "tenant_id": 1,
        "trigger_hours": 24,
        "email_template": "cart_recovery_v2"
    }
)

🔄 Flujo de Trabajo Típico​

1. Data Ingestion​

# Configurar webhooks VTEX
POST /webhook/vtex/order

# Importar datos históricos
POST /api/v2/cdp/import/historical

2. Processing​

# Ejecutar todos los sistemas CDP
POST /api/v2/cdp/process/{tenant_id}

3. Analytics​

# Revisar métricas generadas
GET /api/v2/cdp/analytics/business-health?tenant_id=1

4. Activation​

# Activar campañas basadas en insights
POST /api/v2/cdp/campaigns/launch

📈 Métricas Clave​

MétricaValor ActualObjetivo
Clientes Procesados149,522200K+
Tenants Activos510+
Uptime API99.9%99.95%
Tiempo Respuesta<200ms<150ms

🆘 Solución de Problemas​

Error de Autenticación​

# Verificar JWT token
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://nerdistan-datalake-production.up.railway.app/health

Error de Tenant​

# Listar tenants disponibles
GET /api/v2/tenant-integrations

Error de Processing​

# Ver logs del último procesamiento
GET /api/v2/cdp/process/{tenant_id}/logs

📚 Próximos Pasos​

  1. Explorar API Completa: API Docs
  2. Configurar Integraciones: Guía de Integraciones
  3. Implementar Analytics: Analytics Endpoints
  4. Activar Automation: Email Automation

💡 Tip: Utiliza el Dashboard CDP para explorar visualmente todos los datos antes de implementar vía API.