Introduction
Les cookies tiers perdent en efficacité — pour les commerçants, cela signifie : le suivi et l'attribution doivent fonctionner indépendamment des cookies du navigateur. Affilentra offre, en tant que solution auto‑hébergée, les composants techniques nécessaires pour rediriger les liens de suivi côté serveur, enregistrer les conversions serveur‑à‑serveur et, en cas de changement d'appareil, utiliser un repli par empreinte conforme à la protection des données. Ce guide vous accompagne étape par étape dans la configuration et l'implémentation.
Vue d'ensemble : architecture et principes clés
L'objectif est un suivi sans cookies robuste, composé de trois niveaux :
- Redirections côté serveur : les clics transitent par votre serveur, où des Click‑ID sont générées et stockées avant la redirection vers la destination.
- Postbacks serveur‑à‑serveur : les conversions sont signalées directement depuis le système de commande de votre boutique vers Affilentra ; les cookies du navigateur ne sont pas nécessaires.
- Repli par empreinte : lorsqu'aucune Click‑ID n'est disponible ou que les cookies ont été perdus, un rapprochement par signature d'appareil hachée et respectueuse de la vie privée est utilisé pour attribuer les conversions.
- Définir un domaine ou une sous‑domaine de suivi (p. ex. track.ihredomain.de) et configurer le DNS (A/CNAME) pour pointer vers le serveur Affilentra.
- Configurer SSL/TLS pour le domaine de suivi (letsencrypt/andere), car les postbacks et redirections doivent fonctionner via HTTPS.
- Créer des jetons API pour les postbacks et les stocker en lieu sûr ; ces jetons servent à la vérification de la signature lors des conversions.
- Préparer un environnement de développement pour les transactions de test.
Avec Affilentra auto‑hébergé, vous conservez le contrôle sur le domaine, le traitement des données et le modèle de licence.
Préparation : prérequis et configuration
Avant de commencer, assurez‑vous que l'instance Affilentra auto‑hébergée est installée (licence PRO ou NETWORK) et que vous disposez d'un accès administrateur. Autres étapes préparatoires :
Étape 1 — Configurer les redirections côté serveur
Objectif : chaque clic d'affilié est journalisé côté serveur et doté d'une Click‑ID avant que l'utilisateur ne soit redirigé vers la page de la boutique.
- Définir le format du lien de tracking : affiliate.example.com/clk?aid={partner}&pid={produkt}&dst={zielurl}
- Générer l’ID de clic : À la réception d’un clic, votre serveur crée une ID de clic unique (p. ex. UUID) et la stocke avec un horodatage, l’User‑Agent haché, éventuellement un tronçon d’IP, les paramètres d’origine et, en option, un hash d’empreinte.
- Effectuer la redirection : Après l’enregistrement, le serveur renvoie une redirection 302 vers la cible (URL cible non modifiée ou avec un paramètre supplémentaire click_id={id} selon l’intégration du shop). Important : la redirection doit impérativement se faire côté serveur, afin d’éviter le besoin d’un cookie tiers.
- Stratégie de cookie : Déposez en complément un cookie en première partie (SameSite=Lax, Secure) sur votre domaine de tracking contenant l’ID de clic ; cela est utile si le shop se trouve sur le même domaine principal.
Remarque : Affilentra peut servir de cible pour la collecte et l’enregistrement des clics ; dans votre installation auto‑hébergée, activez l’enregistrement des clics entrants et l’attribution d’ID de clic dans la configuration admin.
Étape 2 — Enregistrer les conversions sans cookies tiers (Server‑to‑Server)
La méthode la plus fiable dans un contexte sans cookies est un postback côté serveur du shop vers Affilentra.
- Définir l’endpoint de postback : Votre shop envoie, après la finalisation d’une commande, une requête HTTP(S) à l’API Affilentra avec les paramètres : click_id (si disponible), amount, conversion_status, timestamp et une signature HMAC sur les données utiles avec votre API‑Token.
- Validation côté Affilentra : La plateforme vérifie la signature, l’existence de l’ID de clic et la fenêtre temporelle (p. ex. Click‑TTL) et inscrit la conversion en base. Si click_id fait défaut, un repli par empreinte est utilisé (voir étape 3).
- Gestion des erreurs : Le côté shop doit implémenter des mécanismes de retry pour les postbacks échoués et fournir des logs de basculement. Affilentra renvoie dans la réponse des codes d’état pour les traitements réussis et échoués.
Important : N’utilisez que votre API‑Token et configurez une liste blanche d’IP ou des limites de débit dans Affilentra pour prévenir les abus.
Étape 3 — Repli par empreinte pour l’attribution lors d’un changement d’appareil
Lorsqu’aucune ID de clic n’est disponible (p. ex. l’utilisateur change d’appareil ou les cookies ont été supprimés), une comparaison d’empreinte respectueuse de la vie privée permet une attribution secondaire.
- Ce qu’il faut collecter : combinaison d’attributs non personnels tels que le fingerprint du navigateur (parties du User‑Agent hachées, résolution d’écran, langue, fuseau horaire), éventuellement une IP partiellement tronquée (p. ex. seulement /24), et une date/un timestamp. Ne pas stocker de champs PII directs comme l’IP complète, l’e‑mail ou les noms.
- Hachage et sel : avant stockage, hasher tous les attributs avec un sel côté serveur et un algorithme de hachage robuste. Faire pivoter le sel régulièrement et le configurer dans Affilentra.
- Stratégie de matching : lors d’une conversion, Affilentra tente d’abord le matching exact sur click_id ; s’il est absent, on recherche des hashes d’empreinte correspondants dans une fenêtre temporelle configurable (p. ex. recommandé : 7–30 jours). Le matching doit être probabiliste et implémenté avec des seuils (score de similarité) ; en cas de plusieurs candidats, un algorithme de priorisation s’applique (dernier clic, correspondance la plus élevée).
- Transparence et possibilité de refus : informer les utilisateurs dans la politique de confidentialité de l’utilisation du repli par empreinte et proposer des options d’opt‑out.
Exemple pratique : déroulement d’une conversion
1) Clic sur le lien d’affiliation → redirection côté serveur vers la boutique, click_id est enregistré et défini sous forme de cookie First‑Party.
2) Le client achète → la boutique envoie un postback avec click_id et signature à Affilentra.
3) Affilentra vérifie la signature, associe le click_id et comptabilise la conversion. Si le click_id fait défaut, un matching par empreinte est déclenché et une attribution est réalisée selon les règles définies.
Tests, monitoring et facturation
Effectuez des scénarios de test :
- Clic → finalisation de commande sur le même appareil (Click‑ID présent).
- Clic → changement d’appareil → finalisation de commande (seul le matching par empreinte est possible).
- Postbacks erronés/tardifs et erreurs de signature.
Journalisez les logs de clics et de conversions en les séparant par rôle (opérateur logiciel, commerçant, partenaire). Utilisez les rapports Affilentra pour rapprocher les paiements et le calcul des commissions ; configurez des alertes en cas d’anomalies.
Sécurité, protection des données et exploitation
- Tokens et secrets : conserver les tokens API en sécurité, les faire pivoter régulièrement et restreindre les accès aux systèmes de production.
- Protection des données : stocker les empreintes uniquement hachées, configurer des durées de conservation limitées et vérifier la base juridique (p. ex. intérêt légitime). Consulter un conseil juridique si nécessaire.
- Configuration des cookies : cookies First‑Party avec SameSite=Lax/Secure et durée adaptée ; éviter la dépendance aux cookies tiers.
Recommandations pratiques pour les commerçants
- Utilisez votre propre domaine de suivi pour maximiser le contexte en first‑party.
- Privilégiez les postbacks serveur‑à‑serveur comme canal principal pour les conversions ; le fingerprint uniquement en tant que solution de secours.
- Documentez tous les formats de postback et les procédures de signature dans votre guide développeur, afin que les intégrations pour les partenaires soient reproductibles.
- Effectuez des tests réguliers et des rapprochements entre les commandes du shop et les rapports Affilentra.
Conclusion et prochaine étape
Avec des redirections côté serveur, des postbacks serveur‑à‑serveur et un fingerprint conforme à la protection des données en fallback, les commerçants peuvent mettre en œuvre techniquement un suivi sans cookies avec Affilentra en self‑hosted tout en conservant le contrôle des données et de l'attribution. La configuration décrite réduit la dépendance aux cookies de tiers et offre une base transparente pour le calcul des commissions et la facturation.
Choisir un démarrage : Informez‑vous et lancez l'implémentation sur https://affilentra.de
Prochaine étape
Essayer Affilentra vous‑même
Plateforme unifiée qui rassemble de manière transparente la mise à disposition des produits, le tracking, la validation des conversions, le calcul des commissions et les paiements selon des rôles clairement séparés ; option d'installation self‑hosted avec licence perpétuelle sans participation au chiffre d'affaires ; les commerçants gardent le contrôle des produits, des conditions et des supports publicitaires ; les partenaires reçoivent des liens de tracking personnels et un historique de paiements traçable.