Cómo configurar el tracking por postback del anunciante (S2S) en RastroAff

Un postback (tracking servidor a servidor o S2S) es la forma más fiable de registrar conversiones. Cuando hay una venta o un lead, el servidor del anunciante llama a una URL de RastroAff con el identificador del clic que trajo al cliente. No hay cookies ni scripts en el navegador, así que los bloqueadores de anuncios y los ajustes de privacidad no interfieren.

Cómo funciona

1. El visitante hace clic en el enlace de tracking de un afiliado.
2. RastroAff registra el clic y envía al visitante a la URL de destino de la oferta, sustituyendo {click_id} por un identificador único.
3. La web del anunciante guarda ese click_id (por ejemplo, con el pedido o con la cuenta del usuario).
4. Cuando hay una conversión, el servidor del anunciante llama a la URL de postback con el mismo click_id.
5. RastroAff asocia la conversión al clic, calcula el payout del afiliado y le avisa.

1. Pasa el click_id al anunciante

En la URL de destino de la oferta, añade la macro {click_id} donde la espere el anunciante:

https://shop.example/landing?clickid={click_id}

El nombre del parámetro (clickid, aff_sub, transaction_id…) es el que lea el sistema del anunciante. También hay otras macros, como {affiliate_id} y de {sub1} a {sub5}.

2. Da al anunciante la URL de postback

Cada anunciante tiene su propia URL con un token secreto. La encuentras en la página del anunciante (o, si tiene acceso al panel, en su página de Integración):

https://track.rastroaff.com/postback?token=ADVERTISER_TOKEN&click_id={clickid}&txn_id={order_id}&amount={order_total}&status=approved

El anunciante sustituye los valores entre llaves por sus propios marcadores. La dirección empieza por el dominio de tracking de tu red; si usas un dominio propio (por ejemplo track.tuempresa.com), empieza por ese.

Parámetros

Parámetro	Obligatorio	Para qué sirve
token	sí	Identifica al anunciante. Mantenlo en secreto y regenéralo si se filtra.
click_id	sí*	El identificador recibido en la URL de destino.
txn_id	recomendado	El ID del pedido o lead del anunciante. Sin él, cada clic solo puede generar una conversión.
amount	para CPS	Importe de la venta, para calcular payouts en porcentaje.
status	no	approved, pending, rejected o reversed.
reason	no	Explica un rechazo (por ejemplo reason=KYC%20fallido): el afiliado ve el motivo.
goal	no	Un objetivo de la campaña con su propio payout (por ejemplo goal=first_deposit).
coupon	no	Atribuye la conversión por código de cupón en lugar de click_id (entonces txn_id es obligatorio).
country	no	El país del cliente (código de 2 letras). Ayuda a detectar fraude cuando no coincide con el país del clic.

* No es necesario cuando la conversión se atribuye por coupon.

Ingresos recurrentes (SaaS y suscripciones)

Para suscripciones, envía también customer_id: el ID del cliente en el sistema del anunciante (por ejemplo el cus_… de Stripe). Con él, RastroAff sigue los pagos de cada cliente a lo largo del tiempo y muestra el MRR, los clientes activos, el churn y el valor de vida por afiliado en Informes → Ingresos recurrentes.

• Primer pago: envía click_id y customer_id juntos.
• Renovaciones: basta con customer_id. RastroAff atribuye la renovación al afiliado de la primera conversión del cliente, aunque sea meses después.
• Planes anuales o trimestrales: añade interval=year (o quarter). El pago cuenta entonces como 1/12 (o 1/3) de su valor en cada mes que cubre.
• Duplicados: envía el ID de la factura como txn_id. Sin él, RastroAff acepta un pago por cliente al mes.

https://track.example.com/postback?token=TOKEN&customer_id=cus_ABC&amount=49&txn_id=in_123

Cambiar el estado de una conversión

Vuelve a enviar el postback con el mismo click_id y txn_id y el nuevo estado. Así funcionan los reembolsos y los contracargos: status=reversed descuenta el importe del saldo del afiliado y le avisa.

Pruebas

Abre la URL de postback en un navegador con un click_id real de un clic de prueba. La conversión aparece en Conversiones en segundos. Si no, el registro de postbacks muestra cada petición y por qué se rechazó, por ejemplo un click_id desconocido, un token incorrecto o un clic fuera de la ventana de atribución.

Cuando el anunciante no puede enviar un postback

• Píxel: una imagen o un iframe en la página de confirmación. Más sencillo, pero menos fiable: los bloqueadores de anuncios pueden impedirlo, y el click_id tiene que viajar desde la landing page hasta la página de confirmación.
• API: POST /conversions con el token en la cabecera Authorization: Bearer y un cuerpo JSON (click_id, txn_id, status, amount).

Las dos siguen las mismas reglas que el postback. Las URL y los ejemplos listos para copiar están en la página de integración del anunciante.