Configuración de Postback S2S: Guía de 5 Minutos para Afiliados

Qué es un postback S2S

Un postback server-to-server (S2S) es una petición HTTP simple que tu red de afiliados envía a tu tracker cuando ocurre una conversión. No se ejecuta JavaScript en el navegador del visitante, así que los bloqueadores de anuncios, las normas de cookies y la velocidad de la página no lo afectan. Por eso es la forma estándar de contar conversiones en el marketing de afiliación.

Cómo viaja el click ID

1. Un visitante hace clic en tu anuncio y llega a tu enlace de tracking. El tracker registra el clic y le asigna un click ID único.
2. El tracker redirige al visitante hacia la oferta y pasa el click ID junto con él, por ejemplo como ?sub_id=….
3. La red almacena ese valor junto con el visitante. Cuando el visitante convierte, la red llama a tu URL de postback con el mismo valor.
4. El tracker asocia el click ID con el clic original y suma la conversión y el pago a la campaña, stream, landing y oferta que la generaron.

Configurarlo en XPNSR Tracker

1. Pasa el click ID a la oferta

Puedes configurar el parámetro de reenvío de Click ID de la campaña (por ejemplo clickid) para que el tracker lo añada a cada URL de oferta, o poner la macro tú mismo en la URL de la oferta:

https://offer.example/landing?sub_id={click_id}&country={country_code}

Usa el nombre de parámetro que espera tu red: sub_id, aff_sub, s2, etc. Los 331 presets de redes de afiliados del tracker ya los conocen.

2. Dale a la red tu URL de postback

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Reemplaza los valores entre llaves con las macros propias de tu red. En el panel de la red, este campo suele llamarse Postback, S2S o Server callback.

Protegiendo el postback

Cualquiera que conozca la URL podría enviar conversiones falsas. Cada campaña tiene un secreto de postback: añade &token=YOUR_SECRET a la URL (o envíalo como cabecera X-Postback-Token) y activa Requerir token. También puedes restringir los postbacks a las direcciones IP de la red. Los postbacks duplicados para la misma conversión se ignoran.

Pruebas y solución de problemas

1. Abre tu enlace de seguimiento tú mismo y completa una conversión de prueba, o usa el postback de prueba de la red.
2. Abre Clicks Log en el tracker y busca tu clic: la conversión aparece en él en segundos.

• No llega nada: revisa la URL en la red por errores tipográficos y que los nombres de las macros coincidan exactamente con la documentación de la red.
• Llega pero no coincide: el click ID no se pasó a la oferta. Abre la URL de la oferta desde un clic de prueba y búscalo.
• Importes incorrectos: envía el payout como un número simple, sin signo de moneda; usa currency para payouts que no sean en USD.
• Errores 401: falta el token o es incorrecto mientras Require token está activado.