Keitaro es uno de los trackers más extendidos entre los equipos de media buying: ahí están montadas las campañas, los flujos, las ofertas y los informes, y nadie quiere migrar. La buena noticia es que no hace falta. ArtisanClo se coloca junto a Keitaro y se encarga de una sola tarea: decidir si delante tienes a una persona real o a un bot y registrar el motivo de esa decisión. Todo lo demás se queda en tu tracker. Keitaro se instala en tu propio servidor; en qué se diferencia eso de la opción en la nube lo analizamos en tracker en la nube o en servidor propio.
Para qué integrar Keitaro con un cloaker
Un tracker y un cloaker resuelven tareas distintas. El tracker cuenta: de dónde vino el clic, a dónde fue, cuánto costó y cuánto ganó. El cloaker decide: a quién mostrar la oferta y a quién una White Page neutral. La diferencia en detalle está en cloaker y tracker: diferencias.
Si ya trabajas en Keitaro, no necesitas un segundo sistema contable, sino una respuesta fiable a «¿lo dejo pasar o no?» dentro de tu esquema habitual. De ahí salen dos variantes de integración.
| Esquema 1: filtro en Keitaro | Esquema 2: cloaker en la landing + Keitaro | |
|---|---|---|
| Quién ve primero la visita | Keitaro | Tu landing con la etiqueta o el archivo PHP |
| Dónde está la comprobación | Filtro de flujo en la campaña de Keitaro | En la página de la landing |
| A dónde va la visita | Lo deciden los flujos de Keitaro | Lo decide el flujo de ArtisanClo; la oferta es un enlace a Keitaro |
| Comprobación del navegador (JavaScript, tiempo en página) | No | Sí |
| Qué hay que hacer | Subir el archivo del filtro al servidor de Keitaro | Poner la etiqueta JS o el archivo PHP y configurar el postback |
| Cuándo elegirlo | El tráfico ya pasa por los enlaces de Keitaro | Necesitas la comprobación completa y conversiones en las estadísticas del cloaker |
Esquema 1: cloaking con Keitaro, ArtisanClo como filtro de flujo
Aquí el enlace publicitario lleva a la campaña de Keitaro, como siempre. Antes de entregar la oferta al visitante, Keitaro le pregunta a ArtisanClo si deja pasar esa visita. Si la respuesta es «sí», actúa el flujo de la oferta. Si es «no», la visita cae más abajo, al flujo con la White Page.
Configuración paso a paso
- Crea un flujo en ArtisanClo. Es una campaña: fuente, reglas de filtrado, geo y protección.
- Abre el menú del flujo → Conectar → Filtro para Keitaro y descarga el archivo del filtro de ese flujo.
- Coloca el archivo en el servidor de Keitaro, en la carpeta
/var/www/keitaro/var/filters(en versiones antiguas,application/filters), y recarga la página de Keitaro. - En la campaña de Keitaro, abre el flujo de la oferta y añade el filtro con el nombre del archivo en modo «Sí».
- Debajo, coloca el flujo con tu White Page: ahí irán todos los que el filtro no deje pasar.
Ten en cuenta que las URL de la oferta y de la White Page indicadas en el flujo de ArtisanClo no se usan en este esquema. A dónde va la persona y a dónde el bot lo deciden tus flujos de Keitaro. ArtisanClo solo responde a «¿lo dejo pasar?». En la práctica, Keitaro funciona aquí como un sistema TDS: reparte el tráfico, y el filtro solo le da la respuesta.
Limitaciones del filtro
Keitaro consulta el filtro antes de responder al visitante. En ese momento es imposible mostrarle al navegador una página de comprobación, así que:
- la comprobación de JavaScript, el tiempo mínimo en página y la interacción real no se aplican;
- la decisión se toma por la red y los rasgos de la solicitud: dirección IP, proveedor, centro de datos, VPN y proxy, cabeceras, parámetro del clic, reglas de geo, dispositivos y horario;
- si el servicio no responde en 3 segundos, la visita va a la White Page.
Para muchas fuentes es suficiente: el tráfico de servidor, los centros de datos y las redes de proxy se delatan ya a nivel de red. Los bots que lanzan un navegador real y se hacen pasar por personas no siempre se ven por la red; a esos los atrapa la comprobación del navegador del esquema 2.
Modo sombra y modo «Tracker»
El filtro de Keitaro admite el modo sombra: no corta a nadie, solo marca en el registro a quién habría bloqueado. Es útil cuando sospechas que estás perdiendo personas reales o quieres ver cómo se comportaría un endurecimiento de las reglas sin arriesgar tráfico. No lo dejes mucho tiempo: mientras está activo, la oferta es accesible para todos.
El modo de flujo «Tracker» también funciona con el filtro de Keitaro: todos van a la oferta y los bots solo se marcan en los informes. Sirve cuando quieres conocer la proporción de bots en el tráfico pagado pero todavía no estás listo para filtrar.
Consejo. Justo después de conectar, abre el registro de clics de ArtisanClo y revisa los motivos de las primeras visitas. Si a todas las corta el mismo motivo, lo más probable es que una regla de audiencia (por ejemplo, el geo) no esté ajustada a tu tráfico.
Esquema 2: cloaker en la landing y Keitaro como tracker externo
En el segundo esquema, quien recibe primero la visita es tu sitio. En él está la etiqueta JS o el archivo PHP de ArtisanClo; el sitio sigue siendo tuyo, en tu hosting y tu dominio. El cloaker revisa al visitante por completo, incluido el navegador, y decide: White Page u oferta. Y la «oferta» aquí es un enlace a tu campaña de Keitaro, a partir del cual todo funciona como de costumbre.
Cómo conectar el cloaker al sitio está descrito en detalle en conectar un cloaker: etiqueta JS o archivo PHP.
Cómo devolver las conversiones de Keitaro al cloaker
En el modo «Cloaking», el cloaker por sí solo no ve conversiones: sabe a quién dejó pasar, pero no quién compró. Para que en sus estadísticas aparezcan CR e ingresos hay que cerrar el círculo:
- En el flujo de ArtisanClo, abre el paso 3. Tracker → bloque Tracker externo y elige Keitaro de la lista. El botón «?» de al lado muestra una nota y un enlace a la documentación del tracker.
- Copia el parámetro para el enlace de anuncio, del tipo
external_id={click_id}. El botón Agregar al enlace lo añade a todas las ofertas del flujo. El campo se pone verde si el parámetro ya está en el enlace de la oferta y rojo si no. - En Keitaro, recibe ese parámetro en una de las etiquetas de la campaña para que el tracker guarde el número de clic de ArtisanClo.
- Abre en ArtisanClo la ventana con la dirección de postback y pégala en la configuración de postbacks de la campaña de Keitaro, sustituyendo la etiqueta guardada y el estado de la conversión.
- Envía una conversión de prueba y revisa la línea de estado.
El enlace de la oferta en el flujo quedará más o menos así:
https://trk.tu-dominio.com/AbCdEf?external_id={click_id}
En lugar de {click_id}, ArtisanClo pondrá el número del clic concreto. Keitaro lo guardará y, cuando la red de afiliados le envíe una conversión al tracker, Keitaro la reenviará, y la conversión se vinculará al clic original en el cloaker. El esquema «Cómo da la vuelta el click_id» del panel muestra ese recorrido de forma visual. Si el tema del click id es nuevo para ti, echa un vistazo a Click ID y Sub ID.
Qué significa la línea de estado
| Mensaje | Qué hacer |
|---|---|
| «Las conversiones ya están llegando: el receptor es común a todos los flujos» | Nada: el círculo está cerrado |
| «Los postbacks nos llegan, pero ninguno ha coincidido todavía con un clic» | Keitaro envía el parámetro equivocado: comprueba que en el postback va el valor de external_id y no el ID de clic propio del tracker |
| «Falta un paso, común a todos los flujos: apunta el postback de tu tracker a nuestra dirección» | El postback de Keitaro aún no ha llegado nunca |
Además, revisa la sección Recepción de conversiones → Registro: ahí están los últimos mensajes entrantes con su resultado: «lead registrado», «clic no encontrado», «sin click_id». Por el resultado se ve enseguida en qué paso se rompe la cadena.
Qué esquema elegir
- Las campañas ya están montadas en Keitaro y no quieres rehacer landings: esquema 1. Se integra en el flujo existente y no toca las páginas.
- Necesitas comprobación del navegador y CR con ingresos en las estadísticas del cloaker: esquema 2. Etiqueta o archivo PHP en la landing más el postback desde Keitaro.
- Una fuente con mucho tráfico de servidor (nativa, push, pop): el esquema 1 suele bastar, porque ese tráfico se ve por la red. Más sobre plataformas en la sección de fuentes de tráfico.
- Solo quieres contar bots sin filtrar: esquema 1 con el modo «Tracker» o el modo sombra.
Puedes combinar ambos esquemas en distintas campañas: una campaña, un flujo, cada uno con su forma de conexión.
Cómo probar la integración antes de lanzar tráfico
Antes de activar el presupuesto, recorre la integración a mano. Lleva diez minutos y te ahorra un día de investigación.
- Tu propio clic. Abre el enlace publicitario desde el móvil con datos móviles. En el registro de clics de ArtisanClo debe aparecer la visita con el motivo de la decisión, y en Keitaro, el clic en el flujo correcto. Si no quieres que tus clics de prueba se comprueben, añade tu dirección a la lista blanca de IP del flujo con el botón Añadir mi IP.
- Un clic desde un centro de datos. Abre el mismo enlace con una VPN o desde un servidor. La visita debe ir al flujo de la White Page y en el registro recibir un motivo como «VPN o proxy bloqueado» o «Red de alto riesgo».
- Etiquetas. Asegúrate de que las etiquetas de campaña (
utm_campaign,sub1y otras) llegan a Keitaro sin pérdidas: abre la ficha del clic en el registro de ArtisanClo y compárala con lo que guardó el tracker. - Conversión. En el esquema 2, envía una conversión de prueba desde Keitaro y comprueba que la línea de estado cambió a «Las conversiones ya están llegando».
Solo después de esto pasa el flujo al estado «Activo» y lanza la publicidad.
Errores frecuentes al integrar Keitaro y cloaker
- El flujo de la White Page está por encima del de la oferta. Entonces la visita nunca llega al filtro. El orden es: primero el flujo de la oferta con el filtro en «Sí», y debajo, la White Page.
- El filtro está en modo «No». La lógica se invierte: a la oferta van los que el cloaker descartó.
- El archivo del filtro es de otro flujo de ArtisanClo. El archivo está ligado a un flujo concreto; cada campaña tiene el suyo.
- Postback con el ID de clic de Keitaro en lugar de
external_id. Las conversiones llegan, pero «no coinciden con ningún clic». - Comparar cifras de fechas distintas. El registro de conversiones las filtra por defecto por fecha de llegada, y los informes asignan los ingresos a la fecha del clic. Cambia el registro a «Fecha del clic» y las cifras del cloaker cuadrarán con Keitaro. Cómo conciliar ingresos por estados lo explicamos en estados de conversión.
Qué ves al final
Tras la integración, en ArtisanClo cada visita tiene su motivo de decisión: «Permitido», «VPN o proxy bloqueado», «Servicio de verificación de anuncios o spy», «Fuera del horario de la campaña» y decenas más. En Keitaro se quedan el dinero, las ofertas y los informes de siempre. Si algo sale mal (menos conversiones de lo normal, cae el paso), el análisis empieza por el registro de clics y el diagnóstico del flujo, que explicamos en por qué un clic fue a la White Page.
Los detalles de la integración están en la página ArtisanClo y Keitaro.
En resumen
Keitaro y el cloaker no compiten, se complementan. El esquema con filtro de flujo se integra en las campañas existentes en pocos minutos y decide por la red y los rasgos de la solicitud. El esquema con etiqueta o archivo PHP en la landing ofrece la comprobación completa del navegador, y el postback desde Keitaro devuelve al cloaker las conversiones y los ingresos. Elige según dónde tengas ya las campañas y qué tan profunda necesita ser la comprobación de tu tráfico.
