INTERMEDIO

Docs

Enlaces de campaña y sub-IDs

Una campaña rara vez vive en un solo sitio - corre por un newsletter, un par de socios, quizá un folleto impreso. Esta guía cablea esos emplazamientos para que cada origen responda por sí mismo: cuántos clics, cuántos de ellos humanos y cuándo debe parar la campaña.

Una campaña, muchos emplazamientos

La pregunta incómoda en cualquier compra de tráfico no es “cuántos clics conseguimos” - es “cuáles de esos clics eran personas, y quién envió el resto”. Un total único no puede responderla: el newsletter, los socios y el folleto desembocan en el mismo número, y el peor origen se esconde detrás del mejor.

Kilo la responde con tres piezas que trabajan juntas. Una campaña agrupa los enlaces y lleva los controles compartidos - una ventana de tiempo, un objetivo de escaneos, un único lugar donde terminarlo todo. Los sub-IDs etiquetan cada emplazamiento para que informe por separado. Y la clasificación de calidad de clics etiqueta cada clic según ocurre - centro de datos, VPN o proxy, humano probable - para que la división de cada origen se sostenga por sí sola.

Crea la campaña

En el panel, abre Campañas y elige Nueva campaña. Tres decisiones hacen casi todo el trabajo:

  • La ventana. Un inicio y un fin opcionales. Fuera de ella, los enlaces dejan de reenviar a sus destinos normales y toman el final que hayas elegido.
  • El objetivo de escaneos. Fija un número y elige qué significa: seguir como meta solo muestra el progreso - los enlaces siguen funcionando al superarla - mientras que parar en el objetivo cierra la campaña automáticamente cuando las aperturas humanas alcanzan el número, comprobado cada pocos minutos.
  • El final. Cuando la campaña termina, los enlaces pueden retomar sus propios destinos, enviar a los visitantes a una URL de fin de campaña - o a una página de marca de “finalizada” si no la has puesto - o devolver un 410 permanente.

Dos detalles son deliberados. El tope cuenta solo aperturas humanas - la misma cifra que muestra el titular de la analítica - así que el tráfico de bots nunca puede cerrarte la campaña antes de tiempo. Y una URL de fin de campaña puesta en la campaña gana sobre el fallback propio de cada enlace, de modo que un solo campo reapunta el final entero. También puedes cerrar o reabrir una campaña a mano en cualquier momento. El objetivo de escaneos como meta es gratis en todos los planes; la aplicación del tope, la URL de fin de campaña y el cierre manual forman parte de los controles de campaña de pago.

Etiqueta cada emplazamiento con un sub-ID

Los sub-IDs no necesitan configuración alguna. Toma el enlace de la campaña y dale a cada emplazamiento su propia variante etiquetada - el mismo enlace con un parámetro de consulta extra:

One link, three placements
https://qr2r.com/aA3k9?sub_id=newsletter
https://qr2r.com/aA3k9?sub_id=partner-42
https://qr2r.com/aA3k9?s1=flyer-april

Kilo captura la etiqueta en el momento de la redirección, y la analítica gana una fila por valor. Los nombres de parámetro son los que las plataformas de anuncios ya emiten - subid, sub_id, s1 a s5, aff_sub a aff_sub5 - así que el tráfico que llega de una red de afiliados suele venir etiquetado antes de que hayas hecho nada. Se conserva una etiqueta por clic, los valores se limitan a 80 caracteres y los clics sin etiquetar siguen contando en todo lo demás - solo que no reciben fila de origen.

O dirígelo por la API

El mismo montaje son dos llamadas con una clave de escritura. Crea la campaña - las marcas de tiempo son milisegundos epoch:

POST /api/groups
curl https://qr2r.com/api/groups \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring launch",
    "ends_at": 1735689600000,
    "target_scans": 10000,
    "enforce_target_scans": true,
    "campaign_fallback_url": "https://example.com/spring-recap"
  }'

Después genera el enlace de cada emplazamiento dentro de ella. En un plan con filtrado de tráfico, también puedes activar el bloqueo del enlace al crearlo:

POST /api/links
curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_target": "https://example.com/spring",
    "name": "Spring - newsletter",
    "group_id": 51,
    "traffic_filter_enabled": true
  }'

Las puertas coinciden exactamente con las del panel: enforce_target_scans y campaign_fallback_url necesitan los controles de campaña de pago, y traffic_filter_enabled necesita un plan que incluya el filtrado de tráfico - una petición por encima de tu plan se rechaza con 402 plan_required, nunca se degrada en silencio. Fijar target_scans solo, como meta, es gratis en todos los planes.

Lee la división y actúa

Cuando el tráfico llega, abre la analítica del enlace - o de la campaña entera. El panel de Calidad de clics muestra la división centro de datos / VPN-o-proxy / humano-probable, y debajo la tabla de orígenes de tráfico por sub-ID da a cada emplazamiento su propia fila: clics y calidad, lado a lado. Un vistazo te dice que el newsletter es casi todo personas mientras que partner-42 es dos tercios centro de datos.

Después, actúa. Pausa el mal emplazamiento, lleva su fila a la conversación de la factura, mueve el gasto hacia los orígenes que envían humanos. Si un origen insiste en enviar máquinas, puedes activar Filtrar tráfico de bots y centros de datos en ese enlace - desactivado por defecto, opcional por enlace, en los planes que lo incluyen. Con ello activo, las redes de centro de datos conocidas y los bots declarados reciben una página de “verifica que eres humano” en vez de tu destino, y las visitas bloqueadas se siguen contando, para que veas exactamente qué rechazó.

Límites honestos

El bloqueo cubre lo que se puede probar: redes de centro de datos y bots declarados. El tráfico de VPN y proxy se etiqueta pero nunca se bloquea - buena parte son personas corrientes cuidando su privacidad - y un bot que imite lo bastante bien a un navegador normal puede evadir la clasificación. La guía de calidad de clics cubre qué significan las etiquetas y dónde están sus bordes.

Ese es el ciclo: agrupa los enlaces, etiqueta los emplazamientos, lee la división de cada origen y deja que la campaña se cierre sola en el objetivo. Cada número sale de la misma analítica agregada que el resto de Kilo - construida sin guardar jamás una IP en bruto.

Abre tus campañas
SiguienteEnrutar por paísImprime un código y envía cada mercado a su propia página - en el panel o con dos llamadas a la API.Lee la guía