Saltar al contenido principal

Configura y publica un sitio

Configura y publica un sitio

Completa este flujo antes de instalar el loader. Así la primera visita recibe una configuración publicada y un inventario revisado.

Antes de crear el sitio

Todas las solicitudes del scanner salen desde una IP fija:

23.21.207.147

Si tu sitio usa un WAF, CDN o protección anti-bot (por ejemplo Cloudflare, Akamai o AWS WAF), agrega esta IP a tu lista de permitidos antes de crear el sitio, porque al crearlo se encola el primer escaneo. Si tu proveedor pide notación CIDR, como AWS WAF, usa 23.21.207.147/32.

1. Crea el sitio​

  1. Abre Consentimientos > Cookies > Sitios
  2. Selecciona Nuevo sitio
  3. Ingresa un nombre reconocible
  4. Ingresa el dominio registrable, sin protocolo ni ruta. Usa example.com, no https://www.example.com/tienda
  5. Crea el sitio

El sitio comienza inactivo, habilita el scanner y encola un primer escaneo.

Dominios que acepta el sitio​

Soyio valida el dominio con la Public Suffix List y guarda el dominio registrable. El sitio cubre ese dominio y todos sus subdominios.

  • Normaliza mayúsculas, www. y subdominios: WWW.Shop.Example.COM queda como example.com
  • Rechaza protocolo, puerto y ruta: usa example.com, no https://example.com:8080/tienda
  • Rechaza IP, localhost y dominios que no están en la lista, como los terminados en .test o .example
  • Rechaza sufijos públicos sin un dominio propio, como com o co.uk
  • Acepta un solo sitio por dominio registrable en tu empresa

Si creas el sitio con createCookieSite, un dominio rechazado o repetido responde 422.

Para probar el banner en tu máquina, no registres localhost. Usa sandbox con tu dominio real y sigue prueba el banner en local.

2. Revisa el escaneo​

Abre la pestaña Detección. El estado cambia entre queued, running y uno de estos resultados:

  • succeeded: completó el recorrido sin advertencias
  • partial: encontró resultados, pero alguna página, límite o protección redujo la cobertura
  • failed: no pudo completar el escaneo

Revisa las páginas cubiertas, las advertencias y los cambios del inventario. Usa Volver a escanear después de corregir el sitio o instalar nuevos proveedores.

El escaneo descubre cookies. No publica ni activa scripts.

Consulta el escaneo por API​

Si integras desde tu backend, sigue el escaneo con la API:

  1. Encola un escaneo con createCookieSiteScan. Devuelve 202 con cookie_scan.id. Mientras exista un escaneo queued o running, un segundo POST devuelve el mismo cscan_ sin crear otro.
  2. Consulta el estado con getCookieSiteScan mientras el status sea queued o running. Usa retroceso progresivo que crezca hasta minutos.
  3. Detente cuando el status sea succeeded, partial o failed.
  4. Revisa el historial completo con indexCookieSiteScans. Filtra por estado o disparador con el parámetro where, por ejemplo {"status":{"in":["queued","running"]}}.

Un escaneo puede tardar varios minutos y, si reintenta errores transitorios, superar la hora. Programa el polling con paciencia y evita bucles sin espera.

3. Clasifica el inventario​

Revisa cada cookie activa en Detección:

  1. Asigna una categoría: essential, functional, analytics, marketing o personalize
  2. Asigna un grupo de proveedores o déjala como first-party
  3. Agrega una descripción y duración declarada
  4. Confirma la sugerencia del scanner, incluso si no cambiaste sus valores

Usa Administrar proveedores para crear, renombrar o describir grupos. Si eliminas un grupo, las cookies permanecen en el inventario y quedan sin asignar.

Agrega manualmente cualquier cookie que el scanner no pueda observar. Incluye nombre, dominio, ruta, categoría, proveedor, descripción y duración.

4. Ajusta el banner​

Usa estas pestañas:

  • Apariencia: formato, posición, tema, color, botones, ícono y acceso a preferencias
  • Contenido: textos en español e inglés, etiquetas de botones y enlaces
  • Configuración: vigencia del consentimiento, token del sitio e instrucciones de instalación
  • Vista previa: banner y preferencias en distintos tamaños

Guarda los cambios antes de activar el sitio.

Define la vigencia del consentimiento​

La vigencia es el tiempo que Soyio recuerda la decisión de un visitante. Cuando vence, el banner vuelve a aparecer. Elige entre 3, 6, 12, 13 o 24 meses.

  • Para toda la empresa: en Configuración > Consentimiento > Consentimiento de cookies, elige la vigencia por defecto. Si no la cambias, es de 12 meses
  • Para un sitio: en la pestaña Configuración del editor, elige una vigencia en Vigencia del consentimiento. Si seleccionas Usar la vigencia de la empresa, el banner usa la vigencia por defecto

Cada decisión guarda su fecha de vencimiento al registrarse. Si cambias la vigencia, el cambio aplica solo a las decisiones nuevas. Las anteriores conservan su vencimiento original.

Si el sitio está activo, cambiar su vigencia publica una revisión nueva al guardar y los visitantes reciben el banner otra vez. Cambiar la vigencia de la empresa no publica revisiones.

Para configurarla por API, usa cookie_consent_duration_months en actualizar configuración de consentimiento y consent_duration_months en actualizar configuración del banner. Envía null en el banner para volver a la vigencia de la empresa. El cambio en el banner crea un borrador. Publícalo con publicar configuración del banner.

5. Publica y activa​

Activa el selector Activo en el encabezado del editor. Soyio publica el borrador guardado, captura el inventario y los proveedores de esa revisión, y luego habilita el runtime.

Cuando el sitio ya está activo, Guardar cambios publica una revisión nueva. Los visitantes con una decisión de una revisión anterior reciben el banner otra vez.

Desactiva el sitio si necesitas detener el runtime. Soyio conserva inventario, configuraciones y decisiones históricas.

6. Instala y verifica​

Abre Configuración, copia el token csite_... y sigue la guía para tu plataforma:

Después completa la lista de bloqueo y verificación.

7. Revisa resultados​

Abre Cookies > Resumen después de recibir decisiones. Revisa:

  • Total de decisiones
  • Tasas de aceptación, rechazo y personalización
  • Aceptación por categoría
  • Tendencia por fecha
  • Resultados por sitio

Abre un sitio para revisar sus decisiones auditables. Cada acción completada incluye identificadores de Agreement y Evidence.