Postback: avisar a tu sistema de cada venta

Para qué sirve

Cuando un lead tuyo queda aceptado, la red llama a una dirección de tu tracker con tu click ID y lo que te paga por ese lead. Así tu sistema cuenta la conversión sin esperar a los informes.

Quién puede usarlo

Lo configuras tú, en el portal de afiliados. Tu red también puede ponerlo en tu ficha de afiliado (Ficha del afiliado): las dos pantallas guardan la misma dirección, y vale la última que se guarde.

Paso a paso

1. En el portal, abajo del menú lateral, pulsa tu nombre, con Mi Perfil debajo.
2. En el bloque Global Postback (S2S), escribe tu dirección en URL de Postback Global, con las marcas {click_id} y {payout} donde tu tracker las espere:

https://tracker.ejemplo.test/postback?cid={click_id}&payout={payout}

3. Pulsa Guardar Cambios. Sale ¡Guardado con éxito!.
4. En cada lead que envíes, manda tu click ID en subid_lead (API de leads: enviar un lead (referencia)).

Al guardar no se comprueba la dirección: revísala bien. Para quitar el postback, deja el campo vacío y guarda.

Cómo llega

Una petición GET a tu dirección, con {click_id} cambiado por el subid_lead del lead y {payout} por el pago de tu asignación a esa campaña, con punto decimal. Los dos van codificados para URL. Con el ejemplo de arriba:

GET https://tracker.ejemplo.test/postback?cid=clic-000123&payout=9.00

• Sólo hay esas dos marcas. Si tu dirección no las lleva, se llama tal cual.
• Es un GET simple, sin cuerpo.
• Se siguen las redirecciones de tu tracker.

Cuándo se dispara

Sólo cuando el lead queda aceptado, y sólo si tienes una dirección guardada y el lead trae subid_lead. Ningún rechazo, duplicado ni fallo de entrega dispara el postback.

La llamada sale dentro de la misma petición del lead, antes de que recibas la respuesta de la API: la respuesta espera a tu tracker, hasta 3 segundos.

Lo que conviene saber

• Tu tracker tiene 3 segundos para contestar con un código de éxito. Si tarda más o responde con un error (4xx o 5xx), la llamada no se repite: si tu tracker no la llegó a registrar, esa conversión no le llega.
• No ves si el postback salió bien o mal: el portal no lo enseña.
• Una sola dirección para todas tus campañas. Tu tracker distingue cada venta por el click ID.
• Sin subid_lead no hay postback, aunque la dirección esté puesta. El click ID admite hasta 50 caracteres: uno más largo hace fallar el envío del lead.
• No hay aviso de anulación: si la red anula después una venta, el tracker no se entera.
• No hay más marcas: ni identificador del lead, ni campaña, ni estado.

Errores frecuentes

Relacionado

• API de leads: enviar un lead (referencia)
• Tu perfil: datos de cobro, contraseña y postback
• Ficha del afiliado