Qué se mide
Los eventos describen comportamiento de producto, no un expediente del cliente. El tracking plan cubre registro y login, onboarding, KYC/KYB, payins, payouts, transferencias, swaps, tarjetas, banking, verificaciones públicas, soporte y operación admin. Los eventos server son autoritativos para dinero; el front solo registra comportamiento de UI. Las propiedades permitidas son valores acotados comocountry, currency,
method, service, status, source, account_type, locales y bandas de
monto o score. Se excluyen emails, nombres, teléfonos, RUT/tax IDs, números de
cuenta o tarjeta, montos exactos, cuerpos raw, identidad de proveedor, tokens y
motivos AML/CFT. Los valores se filtran y scrubbean antes de salir.
Consentimiento y banner opt-in
La analítica es opt-in. El banner explica el propósito y permite aceptar o rechazar. Hasta aceptar, el SDK no se inicializa y la configuración queda desactivada para collection. Una decisión de rechazo se respeta y no se fuerza en la siguiente carga. Las páginas autenticadas usanGET /v1/me/analytics-config. Las superficies
anónimas usan GET /v1/public/analytics-config; allí no se entrega identidad.
La configuración incluye consent_required, cb_env, proxy_path, el hint de
host EU y un token vacío cuando analytics está desactivado.
Replay solo en el portal
El session replay se activa solo en el portal autenticado y después del opt-in. Está desactivado en páginas admin y en toda superficie pública. El cliente shipped enmascara inputs y texto por defecto, bloquea selectores sensibles y cubre material QR; replay nunca es una grabación de soporte ni una fuente de identidad.Proxy first-party
El navegador envía tráfico PostHog al path same-origin/a/*. El proxy acepta
solo e, i, batch, decide, array, static y capture, reenvía el
contenido necesario y headers PostHog-*, elimina cookies y headers de forwarding
y fija el bearer token al proyecto. El límite es 64 MiB, timeout upstream 10 s y
throttle de 1.200 requests por IP/hora. Paths desconocidos, tokens inválidos y
analytics desactivado fallan cerrado.
Endpoints de configuración
La referencia OpenAPI contiene las respuestas completas:GET /v1/me/analytics-config(getMyAnalyticsConfig) — portal de cuenta autenticado; entregadistinct_idygroup_idHMAC solo si está habilitado, además dereplay: truecuando corresponde.GET /v1/public/analytics-config(getPublicAnalyticsConfig) — tracker, consent, verificación y embeds anónimos;replaysiempre es false.
service_unavailable,
invalid_token, rate_limited, not_found y upstream_unavailable.
Preguntas frecuentes
¿CBPay envía datos personales a analytics?
¿CBPay envía datos personales a analytics?
No. La allowlist excluye identificadores directos y valores financieros exactos. Los IDs son HMAC opacos y los montos usan bandas.
¿Puedo usar replay en una página admin o pública?
¿Puedo usar replay en una página admin o pública?
No. Replay solo existe en el portal y está enmascarado. Las configuraciones admin y públicas devuelven
replay: false.¿Qué pasa si PostHog no está configurado?
¿Qué pasa si PostHog no está configurado?
Los endpoints entregan flags desactivados y el proxy responde
503 service_unavailable; la operación de negocio continúa sin analytics.¿Dónde están retención y borrado?
¿Dónde están retención y borrado?
El tracking plan define un año para eventos, 90 días para replay y borrado del ID HMAC cuando se elimina una cuenta.