El seguimiento mediante postback permite a HilltopAds enviar notificaciones de eventos directamente a tu sistema de seguimiento. Así puedes relacionar las impresiones, los clics y las conversiones con tus propios registros y consultar los importes de los ingresos cuando esta opción esté configurada.
¿Qué es un postback para publishers y cómo se utiliza en HilltopAds?
Un postback es una solicitud de servidor a servidor que HilltopAds envía a tu endpoint de seguimiento cada vez que se produce un evento que cumple los criterios establecidos para su notificación.
Según la configuración, un postback puede informarte de:
Una impresión contabilizada de tráfico popunder o un clic contabilizado en un anuncio de display.
Una conversión.
Los ingresos correspondientes a un evento, si incluyes el marcador de posición correspondiente.
Cuando recibes un postback de una impresión o un clic, significa que ese evento se ha contabilizado. Los datos de ingresos muestran lo que has ganado por impresiones CPM o conversiones CPA.
Nota: Los postbacks no notifican impresiones perdidas ni filtradas. Las notificaciones que recibes dependen de los eventos que selecciones y del porcentaje de notificación que acuerdes con tu account manager.
Cómo configurar el seguimiento mediante postback
Tu account manager de HilltopAds configurará la integración por ti. Antes de empezar, prepara tu endpoint de postback y decide qué eventos quieres seguir.
1. Envía tu URL de postback a tu account manager
Comparte el endpoint en el que tu sistema de seguimiento recibe las notificaciones de eventos. Por ejemplo:
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidEn este ejemplo:
click_uuides el parámetro que utiliza tu sistema de seguimiento para recibir el identificador.{{clickId}}se sustituye por el identificador único enviado a través del enlace de monetización de HilltopAds.{{payout}}se sustituye por el importe de los ingresos asociados al evento notificado.uides el ID de tu cuenta de publisher. Puedes encontrarlo en tu panel de control.
Tu endpoint puede utilizar otros nombres de parámetros. Envía a tu account manager la URL exacta que necesita tu sistema de seguimiento para que pueda comprobar la correspondencia entre los parámetros y sus valores.
Si tu endpoint necesita valores adicionales, como un ID de usuario, acuerda con tu account manager cómo asignarlos antes de configurar la integración.
2. Elige qué eventos quieres recibir
HilltopAds ofrece las siguientes opciones de notificación:
Impresiones o clics
Se envía un postback cuando se contabiliza una impresión de popunder o un clic en un anuncio de display.
El postback confirma que el evento se ha contabilizado.
Ejemplo:
https://website.com/postback?click_uuid={{clickId}}Solo conversiones
Se envía un postback cuando se produce una conversión. Esta opción es útil para los publishers que trabajan con un enlace directo.
Ejemplo:
https://website.com/postback?click_uuid={{clickId}}Todos los eventos con ingresos
Solo se envían postbacks de los eventos que generan ingresos para ti.
Por ejemplo, si una impresión de una campaña CPA no genera ingresos, no activará un postback. Si más adelante se produce una conversión que genera ingresos, recibirás un postback de ese evento.
Ejemplo:
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}Nota: Puedes utilizar el marcador de posición {{payout}} con cualquier opción de notificación. La opción «Todos los eventos con ingresos» solo envía notificaciones de los eventos que generan ingresos.
Todos los eventos
Se envían postbacks tanto de las impresiones o los clics contabilizados como de las conversiones.
Si una impresión o un clic genera posteriormente una conversión, recibirás dos postbacks con el mismo clickId: uno correspondiente a la impresión o al clic y otro a la conversión.
Ejemplo:
https://website.com/postback?click_uuid={{clickId}}Comprueba que tu sistema de seguimiento puede procesar más de una notificación para el mismo identificador.
3. Acuerda el porcentaje de notificación
Consulta con tu account manager qué porcentaje de los eventos que cumplen los criterios de notificación debe enviarse a tu endpoint.
Puedes configurar el envío de un porcentaje de los eventos, como el 10 % o el 100 %. El valor predeterminado suele ser del 10 % para mantener una carga baja en el sistema.
La selección de eventos y el porcentaje de notificación son ajustes independientes. Elegir «Todos los eventos» no significa que vayas a recibir el 100 % de las notificaciones. Si el muestreo está activado, tu sistema de seguimiento solo recibirá la proporción acordada.
Ten en cuenta este porcentaje al comparar los registros de postback con tus estadísticas de HilltopAds.
4. Añade parámetros de seguimiento a tu enlace de monetización
Una vez configurado el postback, tu account manager te proporcionará un enlace de monetización de HilltopAds y te explicará qué valores de seguimiento debes utilizar.
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
Los parámetros de seguimiento incluyen:
clickId: Tu ID único de impresión o clic, que se utiliza para relacionar las notificaciones de postback con tus registros de seguimiento.sId: El ID de la zona publicitaria.
Sustituye los valores de ejemplo o los marcadores de posición del enlace de monetización por los valores correctos o las macros dinámicas de tu sistema, siguiendo las instrucciones de tu account manager.
Tu enlace de monetización y tu URL de postback tienen funciones diferentes:
El enlace de monetización envía tráfico a HilltopAds.
La URL de postback recibe notificaciones de eventos de HilltopAds.
Utiliza siempre el enlace de monetización que te proporcione tu account manager. No utilices tu endpoint de postback como destino del tráfico.
5. Comprueba la integración
Prueba la configuración con tu account manager antes de aplicarla a todo tu tráfico. Asegúrate de que:
Tu endpoint recibe las notificaciones de los eventos seleccionados.
Los identificadores recibidos coinciden con tus registros de seguimiento.
Se reciben los importes de los ingresos cuando esta opción está configurada.
Tu sistema de seguimiento puede procesar más de una notificación para el mismo
clickIdal utilizar la opción «Todos los eventos».El porcentaje de notificación coincide con los ajustes acordados.
Si necesitas ayuda para configurar el postback de tu cuenta de publisher o resolver algún problema, ponte en contacto con tu account manager de HilltopAds.