Proteside Docs

Verificar la instalación

Confirma en el dashboard y en la consola del navegador que el SDK está activo en el checkout.

Después de publicar el snippet, abre la página de checkout de la tienda en un navegador. En pocos segundos el SDK empieza a reportar. Usa los tres puntos de abajo para confirmar que todo está bien.

En el dashboard

Indicador superior

En la parte superior del dashboard (en la versión para computadora) hay un indicador de estado del SDK:

  • Proteside activo (verde): la tienda tiene tráfico real reciente del SDK.
  • Proteside no detectado (rojo): no hay tráfico real reciente.

El indicador es un enlace a Ajustes → Páginas y Dominios. Ahí, la sección Páginas detectadas lista cada página que ya envió eventos, agrupada por dominio, con la insignia SDK activo (actividad reciente) o No detectado.

Salud del SDK

La página Salud del SDK muestra si el SDK está reportando tráfico real de clientes, separado de la verificación sintética.

Página Salud del SDK con la franja de estado, los dominios con tráfico real, las métricas de 48 horas, el gráfico de eventos por hora, las versiones del SDK y la configuración
EstadoSignificado
SDK activoSesiones reales de clientes reportaron recientemente.
SDK no detectadoTodavía no se recibió ningún evento.
Solo verificación sintéticaSolo el verificador sintético de Proteside envió eventos. Todavía ningún cliente real pasó por el checkout con el SDK.
SDK silenciosoHay historial, pero ninguna sesión de cliente reciente. Verifica si el snippet sigue publicado.
SDK en pausa (modo desarrollador)El modo desarrollador está activado y el SDK no ejecuta protecciones.

La página también muestra los Dominios con tráfico real, los totales de las últimas 48 horas, el gráfico Eventos por hora, las Versiones del SDK vistas en los últimos 7 días y la configuración actual (canal, modo desarrollador y modo de protección). Los datos se agregan por hora: recarga la página para actualizarla.

Más detalles en Salud del SDK.

En el navegador

Abre el checkout, abre las herramientas para desarrolladores (F12) y usa la pestaña Consola (Console).

Estado del SDK

Proteside.getStatus()

Respuesta esperada, unos segundos después de la carga:

{
  initialized: true,            // el SDK terminó de iniciar
  version: '1.2.0',
  installationOrderValid: true  // false = hay un script antes del snippet
}
ResultadoQué significa
Proteside is not definedEl shield.js no cargó. Revisa si el snippet está publicado, si la CSP permite cdn.proteside.com y si un bloqueador de anuncios no interfirió.
initialized: false durante más de unos segundosFalta el data-key, la clave tiene un formato inválido o el shield.js se cargó como type="module".
installationOrderValid: falseHay algún script antes del snippet. Consulta Solución de problemas.

Si el modo desarrollador está activado, la Salud del SDK muestra SDK en pausa (modo desarrollador).

Snippet completo

Abre el código fuente de la página publicada (Ctrl+U) y comprueba que el bloque entre <!-- Proteside Start --> y <!-- Proteside End --> sea el primer elemento del <head> y tenga las dos etiquetas: el <script> inline del bootstrapper y la etiqueta del shield.js.

Solicitudes de red

En la pestaña Red (Network), filtra por proteside:

SolicitudRespuesta esperada
shield.js desde cdn.proteside.com200
Solicitudes a app.proteside.coméxito (2xx), unos segundos después de la carga

Un error 4xx indica un problema de clave o de cuenta: revisa la Salud del SDK. Si cambiaste la clave, copia el snippet actual en Páginas y Dominios.

Qué esperar en los primeros minutos

  1. Primeros segundos: initialized: true en la consola y las primeras solicitudes a app.proteside.com.
  2. Hasta 30 segundos: recarga el dashboard. El indicador superior pasa a Proteside activo y la página aparece en Páginas detectadas.
  3. Primeros minutos: los scripts de la página aparecen en Scripts con el estado Requiere revisión. Revisa y autoriza los legítimos; consulta Scripts.
  4. Cuando un cliente pague: las tarjetas de Integridad de Pagos pasan de ESPERANDO a INTACTO a medida que se valida cada método. Consulta Integridad de pagos y Pix.

El gráfico de Salud del SDK se agrega por hora. Un evento recién enviado puede tardar unos minutos en aparecer ahí, aunque el indicador superior ya esté en verde.

Próximos pasos

En esta página