server-to-server tracking integration
Article

Server-to-Server tracking (S2S)

El Server-to-Server (S2S) es un método de seguimiento de clics y conversiones que funciona de forma distinta al C2S: no necesita el tag JavaScript de Affilae. Se basa en un identificador único de clic, el clickID, que usted almacena por su parte y después envía a Affilae en el momento de la conversión.

Este clickID es único y circula como una variable a lo largo de todo el embudo de conversión. Es el que permite identificar al socio que se debe remunerar.

Requisito previo: el Formato de URL de su programa debe estar configurado en Server-to-Server (S2S). Este ajuste hace que los enlaces de tracking funcionen por redirección y que la conversión se valide en el servidor. La implantación de una CMP sigue siendo obligatoria.

Configurar su programa en Server-to-Server

  1. En la barra lateral, haga clic en Programas y, a continuación, en el nombre de su programa.
  2. Haga clic en Configuración.
  3. Abra la sección Configuración general.
  4. En el campo Formato de URL, elija Server-to-Server (S2S).
Affilae
GESTIONAR UN PROGRAMA
Mi programa
Configuración
Mis afiliados
Elementos de publicidad
Clics
Conversiones
El menú «Configuración» dentro del menú del programa, en la interfaz del anunciante.

Por qué utilizar el S2S

  • El seguimiento no depende de un script cargado en su sitio: resiste mejor a los bloqueadores de anuncios.
  • Affilae registra el clic en el momento de la redirección, sin depender de un script cargado en su sitio.
  • Usted mantiene el control del clickID, ya que es usted quien lo almacena.
  • El seguimiento funciona en móvil, donde las cookies suelen estar bloqueadas.
  • Es el enfoque ideal para la atribución móvil con una solución como Branch o Appsflyer.

Cómo funciona, del clic a la conversión

El clic

  1. El usuario hace clic en un enlace de afiliado.
  2. Affilae genera un clickID único, por ejemplo 603ed1800000000000000000.
  3. El clickID se añade automáticamente a su landing page: https://votresite.com/?aecid=603ed1800000000000000000
Atención: el clickID no se añade cuando el clic no se registra, por ejemplo si la asociación no está aceptada o si se alcanza un capping «Detener el tracking». Un clic procedente de un país fuera del Geo Targeting recibe un clickID, pero no podrá generar ninguna conversión.

El almacenamiento

Debe almacenar este clickID en una cookie segura, instalada en el navegador del usuario al cargarse la landing page. Esta cookie debe llevar los atributos HttpOnly y Secure.

La conversión

Por parte del anunciante, a continuación usted envía esta información a Affilae. Hay dos opciones posibles.

1. La URL de postback. Configure su activación para que se active después de que el cliente valide la conversión, e indique en la variable cids el clickID o los clickID recopilados, separados por un guion.

https://lb.affilae.com/?key=5d6e34da18022f2871ee0c93-5d6e34ab18022f2871ee0c61&id={{UNIQUE_ID}}&amount={{AMOUNT}}&payment={{PAYMENT}}&customer={{CUSTOMER_ID}}&cv={{SUB_ID}}&voucher={{VOUCHER_CODE}}&currency=EUR&cids={{CLICK_IDS}}

El parámetro cv es una referencia libre de su elección, que se transmite con la conversión. No debe confundirse con los SubID que los afiliados añaden a sus enlaces.

2. La API. La referencia completa está disponible en rest.affilae.com/reference.

En cuanto la recibe, Affilae vincula la conversión al clic que lleva ese clickID. Un clickID desconocido, procedente de otro programa o más antiguo que la Duración del tracking (en días) de la regla no permite esta vinculación. Un mismo pedido solo se registra una vez por regla: un segundo envío con el mismo identificador de pedido se ignora. Dos pedidos distintos realizados después del mismo clic cuentan ambos.

Las cabeceras que se deben transmitir

CABECERA CONTENIDO ESPERADO
x-ae-d-ip La dirección IP v4 o v6 del cliente, por ejemplo 185.179.113.132.
x-ae-d-ua El user agent del cliente, por ejemplo Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36. Opcional, pero muy recomendable.
Referer La URL de referencia, por ejemplo https://www.site.fr.
Esquema del recorrido S2S, del clic al almacenamiento del clickID y después a la conversión
El recorrido de un clickID, desde la generación del clic hasta el registro de la conversión.

Lista de comprobación de la implementación

  1. Programa configurado en S2S en Affilae.
  2. Recepción del parámetro aecid en su landing page.
  3. Cookie que conserva el clickID o los clickID, con los atributos HttpOnly y Secure.
  4. Lectura de la cookie para transmitir los clickID en el momento de una conversión, por postback o por API.
  5. Pruebas.

Puntos de atención

Consejo: pruebe varios recorridos de usuario antes de abrir su programa y compruebe cada vez que la conversión aparece correctamente en Affilae. Un clickID mal transmitido no provoca ningún error visible: simplemente faltan conversiones.
Cree siempre sus enlaces de seguimiento con Affilae: el Generador de enlaces, la extensión de Chrome o la API para las herramientas que generan enlaces automáticamente. Esto se aplica sea cual sea el modo de tracking del programa: C2S, S2S o partner de atribución móvil (AppsFlyer…). No modifique un enlace generado: para cambiar la página de destino o añadir un SubID, genere un nuevo enlace. Un enlace retocado a mano o montado fuera de Affilae puede no registrar sus clics y sus ventas.
  • El clickID siempre tiene 24 caracteres, por ejemplo 603ed1800000000000000000.
  • Las cookies deben ser HttpOnly y Secure.
  • Haga pruebas con varios recorridos de usuario.
  • Compruebe que las conversiones aparecen correctamente en Affilae.

Artículos relacionados

Preguntas
frecuentes

Ver más preguntas

El S2S no se basa en el tag JavaScript de Affilae. El seguimiento se realiza mediante un identificador único de clic, el clickID, que usted almacena en su servidor y después envía a Affilae en el momento de la conversión. Por lo tanto, el S2S no depende de un script cargado en su sitio: resiste mejor a los bloqueadores de anuncios y sigue funcionando en un móvil que bloquea las cookies.

En la barra lateral, haga clic en Programas, abra su programa y, a continuación, Configuración y la sección Configuración general. En el campo Formato de URL, elija Server-to-Server (S2S). Este ajuste hace que los enlaces de tracking funcionen por redirección.

Un clickID siempre tiene 24 caracteres, por ejemplo 603ed1800000000000000000. Llega a su landing page en el parámetro aecid de la URL.

El clickID no se añade cuando el clic no se registra, por ejemplo si la asociación no está aceptada o si se alcanza un capping «Detener el tracking». Un clic procedente de un país fuera del Geo Targeting recibe un clickID, pero no podrá generar ninguna conversión.

En una cookie instalada en el navegador del usuario al cargarse la landing page. Esta cookie debe llevar los atributos HttpOnly y Secure. En el momento de la conversión, usted vuelve a leer la cookie para transmitir el clickID o los clickID.

Las dos opciones son válidas. La URL de postback se activa después de que el cliente valide la conversión, con los clickID en la variable cids separados por un guion. La API ofrece más control; su referencia está publicada en rest.affilae.com/reference.

El segundo envío se ignora: Affilae solo registra una conversión por identificador de pedido y por regla. Dos pedidos distintos realizados después del mismo clic cuentan ambos, cada uno con su propio identificador.

No. El S2S no depende de las cookies del navegador, pero la implantación de una CMP sigue siendo obligatoria.