Saltar al contenido principal

Soluciona problemas de Cookies

Soluciona problemas de Cookies

Empieza con una ventana privada y conserva el registro de Network. Así evitas confundir una decisión guardada con el comportamiento actual.

El banner no aparece por dominio​

Confirma que el dominio registrable del sitio coincide con la página que carga el banner.

  • www.example.com y shop.example.com usan example.com
  • example.net necesita otro sitio
  • No incluyas protocolo, puerto ni ruta
  • En localhost o 127.0.0.1, el banner solo carga en sandbox. Sigue prueba el banner en local

Busca la solicitud a cookie_banner_embeds en Network. Un rechazo por origen suele indicar que el token pertenece a otro dominio.

El sitio no está publicado o está deshabilitado​

Revisa el estado en Cookies > Sitios:

  • Draft: guarda los cambios y activa el sitio para publicar
  • Inactivo: abre el editor y activa el selector Activo
  • Activo: confirma que instalaste el token csite_... del mismo sitio

Una configuración draft no reemplaza la revisión publicada hasta que seleccionas Aplicar cambios o activas el sitio.

CSP bloquea el runtime​

Revisa errores Content Security Policy en Console. Agrega las fuentes de Soyio a tu política existente:

Content-Security-Policy
script-src 'self' https://cdn.jsdelivr.net https://www.googletagmanager.com;
connect-src 'self' https://app.soyio.id https://sandbox.soyio.id;
frame-src https://cookies.soyio.id https://sandbox-cookies.soyio.id;

Conserva tus nonces. El runtime copia el nonce de un script inerte al activarlo.

El loader está duplicado o carga tarde​

Mantén una sola instalación de cookie-loader.js.

  1. Busca cookie-loader.js en el HTML final y en Network
  2. Elimina copias agregadas por un tag manager, plugin, layout duplicado o bloque de CMS
  3. Carga el loader como el primer script del <head>, sin async ni defer
  4. En Next.js agrega el loader como <script> en el <head> del root layout, no con next/script
  5. No cargues tags opcionales antes del loader

Si el comando default de Google Consent Mode aparece después de un evento o configuración, el loader se ejecutó tarde. El loader también lo informa con una advertencia en la consola. Confirma que el loader sea el primer script del <head> y que no tenga async ni defer.

Un box del SDK no carga junto al banner​

Si cargas el banner con cookie-loader.js y usas ConsentBox, ConsentFormBox o PrivacyCenterBox desde el paquete npm, la página tiene dos copias del SDK. Antes de 3.24.0, la copia que carga después falla con Request listener already exists for IFRAME_HEIGHT_CHANGE en Console: el box no aparece o el banner no se muestra.

  1. Usa 3.24.0 o superior en la URL de cookie-loader.js
  2. Actualiza @soyio/soyio-widget a 3.24.0 o superior en tu proyecto
  3. Busca en Network otras copias del SDK con una versión anterior y actualízalas

Un script opcional se ejecuta sin consentimiento​

Soyio no bloquea scripts normales. Reescribe cada script opcional:

<script
  type="text/plain"
  data-soyio-category="analytics"
  data-src="https://example.com/analytics.js"
></script>

Para scripts inline, conserva el contenido y usa type="text/plain" más data-soyio-category. Para módulos, agrega data-soyio-type="module".

Si usas GTM, agrega verificaciones de consentimiento y dispara tags desde soyio_consent_update. Sigue la guía de bloqueo y verificación.

El banner vuelve a aparecer​

El banner se muestra otra vez cuando la decisión guardada ya no es válida:

  • Venció: la decisión superó la vigencia del consentimiento configurada
  • Cambió la configuración: publicaste una revisión nueva del banner
  • Se borró la cookie: el visitante limpió sus cookies o usa una ventana privada

Abre el sitio en Cookies > Sitios y revisa el vencimiento en el detalle de la decisión.

El escaneo falla o queda parcial​

Revisa primero que:

  • El scanner esté habilitado para el sitio
  • El dominio responda públicamente por HTTPS
  • Los redirects permanezcan en el dominio esperado
  • La página no muestre CAPTCHA, bloqueo anti-bot o acceso restringido
  • Las páginas principales carguen dentro de un tiempo razonable

Permite la IP del scanner​

Todas las solicitudes del scanner salen desde una IP fija:

23.21.207.147

Si usas un WAF, CDN o protección anti-bot (por ejemplo Cloudflare, Akamai o AWS WAF), agrega esta IP a tu lista de permitidos para que no reciba CAPTCHA, desafíos ni bloqueos. Si tu proveedor pide notación CIDR, como AWS WAF, usa 23.21.207.147/32. Permite solo esta IP y mantén tus reglas para el resto del tráfico.

Un resultado partial puede conservar cookies válidas y mostrar advertencias como límite de páginas, navegación fallida o bloqueo anti-bot. Corrige la causa y selecciona Volver a escanear.

Consulta el failure_code del escaneo con getCookieSiteScan para saber qué falló:

failure_codeCausaAcción
blocked_destinationEl dominio o un redirect apunta a un destino no público o bloqueado por la protección SSRF.Confirma que el dominio resuelva públicamente por HTTPS y que los redirects permanezcan en el dominio esperado.
scanner_unavailableEl scanner no respondió, devolvió un error 5xx (incluida la indisponibilidad del catálogo) o superó el tiempo de espera. El API reintenta los errores transitorios y registra este código cuando el reintento no prospera.Vuelve a escanear en unos minutos. Si se repite, contacta a soporte.
invalid_scanner_responseEl scanner devolvió una respuesta con formato inesperado.Vuelve a escanear. Si se repite, contacta a soporte.
scanner_failureError permanente no clasificado del escaneo, por ejemplo una solicitud inválida.Vuelve a escanear. Si se repite, contacta a soporte.

Si el sitio necesita autenticación o bloquea automatización, agrega manualmente las cookies conocidas y verifica sus valores con el equipo que administra esos proveedores.