KuikCodeDocs
Reglas inteligentes y geolocalización

Reglas inteligentes, geolocalización y geocercas

Un código impreso, muchos destinos. Dirige un escaneo según la hora, la fecha, el día, el país, el idioma, el sistema operativo, la distancia a un lugar o las veces que se ha escaneado el código.

Reglas inteligentes es un tipo de destino. En lugar de un solo link, el código lleva una lista de reglas que se revisan de arriba abajo en cada escaneo; la primera regla cuyas condiciones coinciden decide a dónde llega el visitante, y una URL de respaldo recibe todo lo demás. El código impreso nunca cambia mientras editas las reglas.

Las reglas inteligentes se incluyen desde el plan PRO. Puedes elegir la tarjeta y armar tus reglas en cualquier plan; el paso que pide PRO es guardar el KuikCode. Si ahí eliges Obtener PRO, tu trabajo se conserva en este navegador, así que después del pago el editor se abre tal como lo dejaste. Descartar reglas inteligentes, en cambio, las quita para que puedas elegir otro destino.

En un plan sin reglas inteligentes, el editor empieza con dos ejemplos, iPhone and iPad (Example) y Android (Example), y cada uno envía un tipo de celular a su tienda de apps. Ponle un link a uno y pasa a ser tu regla, sin la etiqueta de ejemplo; la papelera quita los que no necesites.

Cómo configurarlas

Un destino Reglas inteligentes: la URL de respaldo y una primera regla para Estados Unidos
Un destino Reglas inteligentes: la URL de respaldo y una primera regla para Estados Unidos
  1. En el editor de KuikCode, elige Reglas inteligentes como destino.
  2. Completa Respaldo, URL predeterminada. Aquí llegan los visitantes cuando ninguna regla coincide. Un código no se puede guardar sin ella.
  3. Haz clic en Agregar regla nueva. Ponle un nombre (el ícono del lápiz), agrega una o más condiciones y, en Redirigir a, escribe la URL para ese público.
  4. Repite para cada público. El orden importa: gana la primera regla que coincide. La papelera de una regla la quita al instante, con Deshacer en el mensaje que aparece.

Condiciones

CondiciónOperadoresValores
Horaantes de, después de, entreUna hora del día, en la zona horaria de quien escanea
Fechaantes de, después de, el díaUna fecha del calendario
DíaesCualquier combinación de días de la semana
PaísesUn país
Idioma del dispositivoesEl idioma configurado en el celular
SO del dispositivoesiOS, Android, Windows, macOS, Linux, Otro
UbicaciónesUn punto en el mapa más un radio en metros
Escaneos totalesmayor que, menor que, igual aCuántas veces se ha escaneado este código hasta ahora
Escaneos únicosmayor que, menor que, igual aCuántos dispositivos distintos lo han escaneado

Las condiciones de una regla se encadenan con Y / O, y se leen de izquierda a derecha en el orden en que las agregas. Por eso A y B o C significa (A y B) o C.

Hora local, no la del servidor

Las condiciones de hora, fecha y día usan la zona horaria del lugar donde ocurre el escaneo, así que "después de las 17:00" es la tarde de quien escanea, esté donde esté.

Cómo se resuelve un escaneo

El servicio que atiende el escaneo recibe el país, la región, las coordenadas y la zona horaria de la conexión, el idioma del celular a partir del encabezado de idioma del navegador, y el sistema operativo a partir del user agent. Las condiciones de ubicación miden la distancia en línea recta desde esas coordenadas hasta tu punto; si la red no da coordenadas, la condición es falsa. Los contadores de escaneos cuentan los escaneos registrados antes del actual, así que "Escaneos totales menor que 100" coincide exactamente con los primeros 100 escaneos. Los escaneos que llegan en el mismo instante pueden ver el mismo conteo, así que en un momento de mucho movimiento pueden pasar uno o dos de más.

Las reglas sin URL se saltan. Lo que decidió el escaneo se guarda con él: la analítica muestra el nombre de la regla junto al destino al que llevó, y fallback cuando nada coincidió.

Ejemplos

  • Horario de atención: la regla "Abierto" con Hora entre 09:00 y 18:00 y Día es lunes a sábado lleva a la página de pedidos; el respaldo lleva a la página con el horario.
  • Descarga de la app: la regla "iPhone" con SO del dispositivo es iOS lleva al App Store, la regla "Android" lleva a Google Play, y el respaldo, al sitio web.
  • Día del lanzamiento: la regla "Antes del lanzamiento" con Fecha antes de 2026-10-01 lleva al adelanto; el respaldo, a la página del producto.
  • Página local: la regla "Nuestra ciudad" con Ubicación es tu dirección en un radio de 5000 m lleva a las ofertas locales; el respaldo, al buscador de tiendas.
  • Los primeros 500: la regla "Madrugadores" con Escaneos totales menor que 500 lleva a la promoción; el respaldo, a la oferta normal.

Geolocalización

Geolocalización es la opción más sencilla, para cuando lo único que importa es dónde está quien escanea. Es una tarjeta de destino propia, con dos partes:

  • URL predeterminada: a donde llegan todos, salvo que una regla coincida.
  • Reglas por región: cada regla indica un País, opcionalmente un Estado de Estados Unidos, y la URL para los visitantes de ahí. Agrega una por mercado.

Úsala para un solo código en un empaque que se vende en varios países, para que cada uno abra el idioma o la tienda que corresponde. Cuando la redirección necesite algo más que el país y el estado, cambia la tarjeta a Reglas inteligentes, que incluye la misma condición de país.

La geolocalización se incluye junto con las reglas inteligentes desde el plan PRO, y funciona igual: puedes configurarla en cualquier plan, y al guardar se pide PRO.

Geocercas

Una geocerca limita un código a un lugar. En Reglas inteligentes, agrega una condición Ubicación: Agregar ubicación abre un mapa; busca una dirección o escribe las coordenadas, y define el Radio (en metros) alrededor del pin. Los escaneos dentro del círculo coinciden con la regla; los de afuera pasan a la siguiente regla o al respaldo.

  • Oferta en la ciudad: la regla "En la ciudad" con Ubicación es tu dirección en un radio de 5000 m lleva al cupón; el respaldo lleva a una página que dice que la oferta es para clientes locales.
  • Ciudad del evento: Ubicación es el lugar del evento en un radio de 10 000 m abre el programa en vivo; fuera de ese radio, la página de boletos.
  • Varias sucursales: una regla por lugar, cada una con su propia URL, ordenadas por prioridad.

La posición viene de la conexión de red, no del GPS: es confiable para el país, suele acertar con la ciudad y puede desviarse unos kilómetros con datos móviles. Deja un radio amplio, de unos kilómetros, y cuenta con algunos fallos cerca del borde. Para limitar una oferta a una sola tienda, mejor imprime el código solo ahí o protégelo con un código de acceso. Si la red no da coordenadas, la condición es falsa. La analítica registra qué regla decidió cada escaneo, así que puedes ver cuántos cayeron dentro.

Tipos de destino relacionados

  • Geolocalización, más arriba, solo para país y estado.
  • Un destino Sitio web simple es todo lo que necesitas cuando todos deben llegar al mismo lugar.

En esta página