Enrutar por país

Imagina que el mismo empaque se envía a Alemania, a Austria y al resto del mundo. Un escaneo alemán debería aterrizar en la tienda alemana; los demás pertenecen a la página internacional. Imprimir un código QR distinto por mercado multiplica tus tiradas - y una caja mal etiquetada envía a la audiencia equivocada a la página equivocada durante toda la vida de esa caja.

Un enlace de Kilo disuelve el problema, porque el código nunca codifica tu destino - codifica el enlace, y el enlace decide. Las reglas geo se evalúan en el edge, dentro de la misma redirección de unos 50 milisegundos que reenvía al visitante, así que nadie espera mientras se toma la decisión. Y como las reglas viven en el enlace y no en el papel, puedes añadir mercados, fusionarlos o reapuntar cualquiera años después de imprimir. Imprime una vez; reapunta para siempre.

Toda la configuración es un enlace y una regla por mercado. En el panel:

• Crea el enlace con tu página internacional como destino. Ese destino por defecto es la red de seguridad - todo visitante que no encaje en ninguna regla aterriza ahí, así que haz que sea una página que funcione para cualquiera.
• Abre las reglas de enrutamiento del enlace y elige Añadir regla.
• Añade una regla geo por mercado: elige el país - o varios países que compartan destino - y fija la URL que deben recibir esos visitantes. Una regla geo también puede coincidir con una región o una ciudad cuando un país entero es demasiado grueso.

Las reglas se evalúan en un orden fijo - gana la primera coincidencia, geo antes que dispositivo y A/B, con el destino por defecto recogiendo a los demás - y una edición surte efecto en el siguiente escaneo. La mecánica, incluido cómo se apilan las reglas, está en la guía de reglas de enrutamiento. Una nota honesta antes de construir: las reglas de segmentación son una función de pago, aplicada en la API igual que en el panel.

Kilo es API-first - el panel que acabas de usar es un cliente de la misma API HTTP. El montaje del cartel impreso son dos llamadas con una clave de escritura. Primero, genera el enlace con el destino mundial por defecto:

curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "default_target": "https://example.com/global", "name": "Trade-fair poster" }'

La respuesta lleva el slug permanente del enlace. Después adjunta una regla geo por mercado - los países son códigos ISO-2, y la creación devuelve 201 con la regla almacenada:

curl https://qr2r.com/api/links/aA3k9/rules \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "geo", "condition": { "countries": ["DE", "AT"] }, "target_url": "https://example.com/de" }'

Repite la segunda llamada por cada mercado, y usa PUT /api/links/aA3k9 cuando un destino se mude - el código impreso nunca cambia. El recorrido completo por los endpoints, incluidos listar, reordenar y borrar reglas, está en analítica y reglas por la API. Igual que el panel, la API aplica la puerta de plan: una regla geo en un plan sin reglas de segmentación se rechaza con 402, nunca se acepta en silencio.

Abre la analítica del enlace y lee el desglose de países contra tus reglas. Si el cartel cuelga en Viena pero un tercio de los escaneos no viene ni de Alemania ni de Austria, o la historia del emplazamiento es mayor de lo que pensabas o el tráfico no es lo que parece - ambas cosas conviene saberlas antes de la siguiente tirada.

Para un código impreso hay una herramienta más afilada: fija la ubicación del enlace - el país o la región donde el código vive físicamente - y el panel geo añade una línea dentro-del-área / fuera-del-área, contada solo sobre tráfico clasificado como humano. Responde la pregunta del encaje de ubicación de un vistazo: ¿los escaneos vienen de donde de verdad está el papel?