Introducción
Las cookies de terceros están perdiendo eficacia — para los comerciantes eso significa: el seguimiento y la atribución deben funcionar independientemente de la cookie del navegador. Affilentra ofrece como solución autohospedada los bloques técnicos necesarios para redirigir enlaces de seguimiento de forma server-side, registrar conversiones server‑to‑server y, en caso de cambio de dispositivo, utilizar un fallback por fingerprint conforme a la protección de datos. Esta guía le acompaña paso a paso en la configuración e implementación.
Resumen: Arquitectura y principios clave
El objetivo es un seguimiento robusto sin cookies, que consta de tres capas:
- Redirecciones Server‑Side: los clics pasan por su servidor, donde se generan y almacenan Click‑IDs antes de redirigir al destino.
- Postbacks Server‑to‑Server: las conversiones se notifican directamente desde el sistema de pedidos de su tienda a Affilentra; las cookies del navegador no son necesarias.
- Fallback por Fingerprint: cuando no hay Click‑ID o se han perdido las cookies, se emplea una comparación de firma de dispositivo hashed y respetuosa con la privacidad para asignar atribuciones.
- Establecer el dominio o subdominio de seguimiento (por ejemplo, track.ihredomain.de) y apuntarlo por DNS (A/CNAME) al servidor de Affilentra.
- Configurar SSL/TLS para el dominio de seguimiento (letsencrypt/otros), ya que los postbacks y las redirecciones deben realizarse vía HTTPS.
- Crear tokens API para postbacks y almacenarlos de forma segura; estos tokens se utilizarán para la verificación de firmas en las conversiones.
- Disponer de un entorno de desarrollo para transacciones de prueba.
Con Affilentra autohospedado mantiene el control sobre el dominio, el procesamiento de datos y el modelo de licencia.
Preparación: Requisitos y configuración
Antes de comenzar, asegúrese de que la instancia de Affilentra autohospedada está instalada (PRO o NETWORK), y que dispone de acceso de administrador. Pasos adicionales de preparación:
Paso 1 — Configurar redirecciones server-side
Objetivo: cada clic de afiliado se registra en el servidor y se le asigna una Click‑ID antes de redirigir al usuario a la página de la tienda.
- Establecer el formato del enlace de tracking: affiliate.example.com/clk?aid={partner}&pid={produkt}&dst={zielurl}
- Generar la Click‑ID: Al llegar un clic, su servidor genera una Click‑ID única (p. ej. UUID) y la almacena con timestamp, User‑Agent hasheado, si procede IP‑trunk, parámetros de origen y opcionalmente hash de fingerprint.
- Realizar el redirect: Tras el registro, el servidor efectúa una redirección 302 al destino (URL de destino sin modificar o con el parámetro adicional click_id={id} según la integración del comercio). Importante: la redirección debe hacerse server‑side para no necesitar cookies de terceros.
- Estrategia de cookies: Además, establezca una cookie de primera parte (SameSite=Lax, Secure) en su dominio de tracking con la Click‑ID; esto es útil si la tienda está en el mismo dominio principal.
Nota: Affilentra puede servir como destino para la captura y el almacenamiento de clics; en su instalación self‑hosted active el registro de clics entrantes y la asignación de Click‑IDs en la configuración de administración.
Paso 2 — Registrar conversiones sin cookies de terceros (Server‑to‑Server)
El método más fiable en contexto cookieless es un postback server‑side desde la tienda hacia Affilentra.
- Definir el endpoint de postback: Su tienda envía tras completar un pedido una petición HTTP(S) al API de Affilentra con los parámetros: click_id (si existe), amount, conversion_status, timestamp y una firma HMAC sobre los datos útiles con su API‑Token.
- Validación en Affilentra: La plataforma verifica la firma, la existencia de la Click‑ID y la ventana temporal (p. ej. Click‑TTL) y escribe la conversión en la base de datos. Si falta click_id, se recurre al fallback por fingerprint (véase Paso 3).
- Manejo de errores: La parte de la tienda debe implementar mecanismos de reintento para postbacks fallidos y proporcionar logs de failover. Affilentra devuelve en la respuesta códigos de estado para procesamientos exitosos y fallidos.
Importante: Use exclusivamente su API‑Token y configure whitelist de IPs o límites de tasa en Affilentra para evitar usos indebidos.
Paso 3 — Fallback por fingerprint para atribución en cambios de dispositivo
Si no hay Click‑ID (p. ej. el usuario cambia de dispositivo o se han borrado las cookies), una comparación de fingerprint respetuosa con la privacidad permite una atribución secundaria.
- Qué registrar: Combinación de atributos no personales como fingerprint del navegador (partes del User‑Agent hasheadas, resolución de pantalla, idioma, zona horaria), en su caso IP parcialmente enmascarada (p. ej. solo /24), y una fecha/timestamp. No almacenar campos PII directos como IP completa, correo electrónico o nombres.
- Hashing y salt: Antes de almacenar, hashear todos los atributos con un salt a nivel de servidor y un procedimiento de hashing fuerte. Rotar el salt periódicamente y configurarlo en Affilentra.
- Estrategia de matching: En una conversión Affilentra primero intenta el matching exacto por click_id; si falta, buscará hashes de fingerprint coincidentes dentro de una ventana temporal configurable (p. ej. recomendado: 7–30 días). El matching debe implementarse de forma probabilística y con umbrales (similarity‑score); con varios candidatos aplicar un algoritmo de priorización (último clic, mayor coincidencia).
- Transparencia y opción de exclusión: Informar a los usuarios en la política de privacidad sobre el uso de fallback por fingerprint y ofrecer posibilidades de optar por no participar (opt‑out).
Ejemplo práctico: flujo de una conversión
1) Clic en enlace de afiliado → Redirección server‑side al comercio, se guarda la click‑ID y se establece como cookie de primera parte.
2) Cliente compra → El comercio envía un postback con click_id y firma a Affilentra.
3) Affilentra verifica la firma, hace match del click_id y registra la conversión. Si falta click_id, se activa el fingerprint‑matching y se atribuye según las reglas definidas.
Pruebas, monitorización y facturación
Realice escenarios de prueba:
- Clic → Finalización de pedido en el mismo dispositivo (click‑ID presente).
- Clic → Cambio de dispositivo → Finalización de pedido (solo posible matching por fingerprint).
- Postbacks erróneos/tardíos y errores de firma.
Registrar logs de clics y conversiones separados por rol (operador de software, comerciante, partner). Utilizar los informes de Affilentra para conciliar pagos y cálculos de comisiones; configurar alarmas ante anomalías.
Seguridad, protección de datos y operación
- Tokens y secretos: Guardar los tokens de API de forma segura, rotarlos regularmente y restringir accesos a sistemas de producción.
- Protección de datos: Almacenar solo fingerprints hasheados, configurar plazos de retención limitados y verificar la base legal (p. ej. interés legítimo). Consultar asesoría legal si procede.
- Configuración de cookies: Cookies de primera parte con SameSite=Lax/Secure y duración adecuada; no depender de cookies de terceros.
Recomendaciones prácticas para comerciantes
- Utilice su propio dominio de tracking para maximizar el contexto de primera parte.
- Emplee postbacks server‑to‑server como canal primario para conversiones; el fingerprint solo como respaldo.
- Documente todos los formatos de postback y los procedimientos de firma en su Developer‑Guide, para que las integraciones con socios sean reproducibles.
- Realice pruebas periódicas y conciliaciones entre pedidos de la tienda e informes de Affilentra.
Conclusión y siguiente paso
Con redirecciones server‑side, postbacks server‑to‑server y un fallback por fingerprint conforme a la protección de datos, los comerciantes pueden implementar técnicamente el seguimiento sin cookies con Affilentra self‑hosted y, al mismo tiempo, mantener el control sobre los datos y la atribución. La configuración descrita reduce la dependencia de las cookies de terceros y ofrece una base transparente para el cálculo de comisiones y la facturación.
Elegir inicio: Infórmese y comience la implementación en https://affilentra.de
Siguiente paso
Probar Affilentra
Plataforma unificada que reúne de forma transparente la puesta a disposición de productos, el tracking, la validación de conversiones, el cálculo de comisiones y el pago, con roles claramente separados; opción de instalación self‑hosted con licencia perpetua sin participación en los ingresos; los comerciantes mantienen el control sobre productos, condiciones y materiales promocionales; los socios reciben enlaces de tracking personales e historial de pagos verificable.