Debugging

Si tienes problemas con el tracking, aquí tienes varias formas de debuggear.

Modo Debug

Activa el modo debug para ver logs detallados en la consola del navegador:

<script>
  ReferrerTracker.configure({
    apiKey: 'TU_API_KEY',
    debug: true  // Activa logs en consola
  });
</script>

Qué verás en la consola:

  • Validación de licencia (éxito/fallo)
  • Valores capturados (UTM params, click IDs, referrer)
  • Campos rellenados automáticamente
  • Eventos enviados al servidor

Verificar que el Script Carga

Abre la consola del navegador (F12) y ejecuta:

// Verificar que el script está cargado
console.log(typeof ReferrerTracker);
// Debería mostrar: "object"

// Ver la configuración actual
console.log(ReferrerTracker);

Verificar Cookies

Para ver las cookies creadas:

  1. Abre las DevTools del navegador (F12)
  2. Ve a la pestaña Application (Chrome) o Storage (Firefox)
  3. Expande Cookies en el sidebar
  4. Selecciona tu dominio
  5. Busca cookies con prefijo rt_

Verificar Campos de Formulario

Para comprobar que los campos se están rellenando:

// En la consola del navegador
document.getElementById('rt_source').value;
document.getElementById('rt_medium').value;
document.getElementById('rt_campaign').value;

// Debería mostrar los valores capturados

Problemas Comunes

1. El script no carga

Solución:

  • Verifica que la ruta del script sea correcta: <script src="/referrer-tracker.min.js">
  • Comprueba que el archivo existe en tu servidor
  • Revisa la consola por errores 404

2. Los campos no se rellenan

Solución:

  • Verifica que los IDs de los campos sean correctos: id="rt_source", id="rt_medium", etc.
  • Asegúrate de que el script se carga antes de que el formulario esté en el DOM
  • Activa el modo debug para ver qué valores se están capturando

3. No se capturan los UTM parameters

Solución:

  • Verifica que la URL tenga los parámetros: ?utm_source=google&utm_medium=cpc
  • Los parámetros se guardan en cookies, así que solo necesitan estar en la primera visita
  • Limpia las cookies y vuelve a visitar con los parámetros UTM