Cómo conectar el postback de la fuente de tráfico de Keitaro a Adgora

Requisitos antes de comenzar

Antes de intentar cómo conectar la fuente de tráfico de Keitaro con Adgora, asegúrate de que ambas cuentas estén activas y de que puedas editar la fuente de tráfico en Keitaro. Suena simple, pero aquí es donde muchas configuraciones se detienen: un usuario tiene acceso de administrador en Adgora, pero solo acceso de visualización en Keitaro, por lo que el campo de postback permanece bloqueado. Necesitas la cuenta exacta de Adgora a la que deseas enviar eventos, y necesitas la entrada de la fuente de tráfico en Keitaro que realmente recibe clics.

Primero verifica tres cosas. Una, la fuente de tráfico de Keitaro debe existir ya. Dos, debes saber qué oferta o campaña generará el evento de conversión. Tres, necesitas los identificadores que Adgora espera en su configuración de cuenta. Si falta alguno de esos, detente ahí y corrige el acceso antes de pegar una sola URL.

En la práctica, la configuración más limpia es abrir ambas herramientas en pestañas separadas y comparar el nombre de la fuente, el campo de postback y el campo de identificador de clics uno al lado del otro. Un pequeño error tipográfico, un gran problema. Una fuente de tráfico llamada “Meta US” en Keitaro y “meta_us” en Adgora puede funcionar, pero solo si los parámetros reales coinciden, no la etiqueta que usas para tu propia conveniencia.

Si deseas un repaso más amplio sobre los términos de informes antes de enviar la solicitud, el glosario de tecnología publicitaria puede ayudar con las palabras básicas que siguen apareciendo en las pantallas de seguimiento. También vale la pena revisar el resto de las guías de publicidad en criptomonedas, monetización & Ad-Tech si estás construyendo un stack de seguimiento más completo, porque la configuración de postback rara vez vive sola.

Encuentra el endpoint de postback de Adgora y los parámetros requeridos

El primer paso técnico es copiar el endpoint de postback de Adgora desde el área de cuenta de Adgora donde se configuran las conversiones. No adivines la URL. No reutilices un postback de otra cuenta. Un solo carácter en la ruta del endpoint puede convertir una conversión válida en un fallo silencioso, y los fallos silenciosos son los peores porque parecen “sin tráfico” en lugar de “mala configuración.”

Adgora generalmente esperará un endpoint base más varios parámetros que identifiquen el evento. En una configuración de postback de fuente de tráfico, esos parámetros a menudo incluyen un ID de clic, un identificador de fuente y una referencia de conversión. Keitaro debe enviar lo que Adgora utiliza para conectar el evento de vuelta a la fila de fuente correcta. Si la fila de fuente es incorrecta, la conversión aterriza en el lugar equivocado o no llega en absoluto.

Copia el endpoint exactamente como se muestra en Adgora, luego anota qué macros lista Adgora para la solicitud. Algunos equipos mantienen una nota de texto con el endpoint, el método HTTP, los nombres de los parámetros requeridos y cualquier valor opcional como pago o estado. Esa nota ahorra tiempo más tarde, especialmente cuando una segunda fuente de tráfico necesita el mismo patrón.

Si tu cuenta de Adgora se utiliza para campañas de criptomonedas, la lógica de configuración es la misma, ya sea que ejecutes un flujo de trabajo de red publicitaria de criptomonedas para editores o algo más. El postback aún necesita los identificadores correctos. No sucede nada mágico porque la campaña esté relacionada con criptomonedas.

Construye la URL de postback en Keitaro

Abre la configuración de la fuente de tráfico en Keitaro y encuentra el campo de postback o callback de conversión para esa fuente. Pega el endpoint de Adgora allí, no en el cuadro de postback de la campaña. Esa distinción es importante. El postback a nivel de fuente envía datos desde la configuración de la fuente de tráfico en sí, que es lo que Adgora necesita para informes basados en la fuente; el seguimiento a nivel de campaña es una capa diferente y puede crear confusión si los mezclas.

Ahora mapea los tokens de Keitaro a los parámetros de Adgora. Por ejemplo, si Adgora espera un ID de clic, Keitaro debe pasar el token que contiene ese valor de clic. Si Adgora espera un nombre de fuente o un ID de fuente, Keitaro debe enviar el token vinculado al registro de la fuente de tráfico, no el nombre de la campaña. Mantén el mapeo literal. Mantenlo aburrido.

Un hábito cuidadoso ahorra horas: escribe la URL final en un editor de texto plano antes de guardarla en Keitaro. Luego compara cada parámetro uno por uno. Un ampersand faltante, un espacio copiado o un token envuelto en las llaves incorrectas pueden romper la solicitud. Esto es especialmente molesto cuando la URL parece estar bien a simple vista.

Algunos equipos prueban esto primero con una fuente de bajo riesgo, como una pequeña campaña de prueba, antes de pasar a compras más grandes. Eso es sensato. Si también estás trabajando con nichos verticales, como campañas de instalación de aplicaciones móviles o ofertas de forex y trading, la misma lógica de postback sigue aplicándose, incluso si la página de la oferta se ve completamente diferente.

Coincide correctamente los IDs de clic y los identificadores de fuente

Esta es la parte donde las integraciones suelen fallar. Keitaro puede recibir muchos IDs, pero Adgora solo reconoce el evento si el ID de clic o el identificador de fuente exacto regresa en el formato que espera. Si falta el ID, está truncado o se envía bajo el nombre de parámetro incorrecto, Adgora no puede vincular la conversión al clic original.

Usa un patrón de nomenclatura desde el principio. Si tu fuente es “fb_us_01” en Keitaro, mantén la misma lógica en las notas de Adgora, tu hoja de seguimiento y cualquier documentación interna. Un nombre desajustado no siempre rompe la solicitud, pero sí dificulta la solución de problemas humanos. Tres etiquetas diferentes para una fuente pueden desperdiciar una tarde.

Cuando la lista de parámetros de Adgora incluye un campo de ID de clic, mapea esto al token de Keitaro que almacena el identificador de clic del registro de clic de la fuente. Cuando incluye un identificador de fuente de tráfico, pasa el token de fuente, no el token de campaña. El identificador de fuente y el identificador de clic no son lo mismo, y confundirlos puede hacer que una conversión parezca válida mientras apunta a la fuente incorrecta.

Para equipos que comparan flujos basados en CPA, la misma disciplina importa también en los modelos de precios. Si aún estás resolviendo la lógica de informes, el artículo sobre CPC vs CPM vs CPA es un compañero útil, porque el postback solo te dice lo que sucedió; no explica por qué elegiste ese modelo en primer lugar.

Envía una conversión de prueba y confirma la solicitud

Ejecuta una conversión de prueba después de que la URL esté guardada. Una. No cinco. Activa el evento de manera controlada, luego verifica ambos sistemas. En Keitaro, abre el registro de origen o campaña y busca la solicitud saliente, el código HTTP y la URL final que se envió. En Adgora, busca el registro de evento correspondiente y la marca de tiempo. Esas dos marcas de tiempo deberían estar cerca, incluso si no son idénticas al segundo.

Si Keitaro muestra una respuesta 200 pero Adgora no muestra nada, la solicitud llegó a algo, solo que no al controlador de eventos previsto. Si Keitaro muestra un código 4xx, es probable que el endpoint, el método o los nombres de los parámetros estén equivocados. Si la solicitud nunca aparece en el registro, la colocación del token en Keitaro probablemente esté mal, o el postback de origen nunca se guardó.

Usa un solo clic de prueba con una nota única en tu libro de registro. Por ejemplo, “prueba manual el martes, 14:20.” Eso te da una línea limpia para buscar más tarde. Una prueba desordenada con múltiples clics y sin notas parece ocupada, pero es difícil de depurar.

La frase cómo conectar el postback de la fuente de tráfico de Keitaro a Adgora solo se vuelve clara cuando puedes emparejar un clic de origen, una solicitud saliente y un evento dentro de Adgora. Si los tres coinciden, la configuración es real. Si falta uno, aún no continúes.

Corrige los errores de postback más comunes

La colocación incorrecta de macros es el error más común. Un token destinado a datos de campaña se pega en un campo de origen, o un token de ID de clic se coloca donde debería ir un ID de origen. La solicitud aún se activa, por lo que es fácil pasar por alto el error. La URL existe, la conversión no.

La codificación de URL causa la siguiente capa de problemas. Si un parámetro contiene caracteres especiales y el valor no está codificado de la manera que Adgora espera, la solicitud puede llegar con partes rotas. Esto se muestra más a menudo en nombres de origen, notas personalizadas o valores de redirección. Un signo más puede convertirse en un espacio. Una barra puede dividir el campo. Caracteres diminutos, gran dolor de cabeza.

La configuración incorrecta del método también causa fallos. Si Adgora espera GET y Keitaro envía POST, o viceversa, el endpoint puede rechazar la solicitud o ignorarla. Verifica el método en ambas herramientas antes de cambiar cualquier otra cosa. Cambiar tres campos a la vez hace imposible saber cuál solucionó el problema.

Los parámetros duplicados crean otro desorden silencioso. Dos valores en el mismo campo pueden hacer que un sistema lea el primero y otro sistema lea el último. Mantén un parámetro por propósito. Si necesitas probar un valor de respaldo, hazlo en una versión separada, no en la URL en vivo.

A veces el problema no es la URL en absoluto. La fuente de tráfico en Keitaro puede estar nombrada de una manera, mientras que la entrada de origen en Adgora espera otra cuenta o otro ID de red. Esa discrepancia puede hacer que cada solicitud parezca “válida” pero termine en el lugar equivocado. Verifica la conexión de la cuenta antes de rehacer el postback en sí.

Ve en vivo y monitorea los primeros eventos reales

Después de que la prueba pase, cambia del tráfico de prueba al tráfico real sin cambiar el resto del embudo. Eso significa que dejas la oferta, la página de destino y la lógica de enrutamiento como están mientras el postback de origen sigue activándose. Una modificación a la vez es la regla aquí. Si alteras el embudo y el postback al mismo tiempo, no sabrás qué parte causó una caída en el informe.

Observa de cerca los primeros eventos reales. Las primeras 10 conversiones son las más informativas, porque muestran si el postback de origen sigue activándose bajo tráfico normal en lugar de un clic manual. Verifica los registros de eventos en Adgora contra los registros de origen en Keitaro. Buscas consistencia, no solo una línea exitosa.

Presta atención al nombre de origen, los valores de los parámetros y el tiempo. Si un conjunto de anuncios genera conversiones pero otro no, el problema puede estar en la configuración de origen en lugar del postback en sí. Una transferencia en vivo limpia significa que la misma URL, los mismos tokens y el mismo patrón de identificador continúan funcionando a medida que cambia el volumen de tráfico.

Si la mezcla de tu campaña incluye otros verticales, el hábito de informes se mantiene igual. Ya sea que estés enviando conversiones para ofertas de citas, construyendo publicidad de criptomonedas, o comparando una nueva fuente contra tráfico antiguo, mantén los primeros eventos en vivo bajo revisión hasta que los registros y documentos coincidan. Luego sigue observando el postback de origen, porque el primer fallo silencioso a menudo aparece después del primer día limpio, no durante él.