Einleitung
Third‑party‑Cookies verlieren an Wirkung — für Händler bedeutet das: Tracking und Attribution müssen unabhängig vom Browser‑Cookie funktionieren. Affilentra bietet als self‑hosted Lösung die technischen Bausteine, um Trackinglinks serverseitig umzuleiten, Conversions server‑to‑server zu erfassen und bei Gerätewechseln einen datenschutzkonformen Fingerprint‑Fallback einzusetzen. Diese Anleitung führt Sie Schritt für Schritt durch die Konfiguration und Implementierung.
Übersicht: Architektur und Kernprinzipien
Das Ziel ist ein robustes, cookieless Tracking, das aus drei Ebenen besteht:
- Server‑Side Redirects: Klicks laufen über Ihren Server, dort werden Click‑IDs erzeugt und gespeichert, bevor auf das Ziel weitergeleitet wird.
- Server‑to‑Server‑Postbacks: Conversions werden direkt vom Bestellsystem Ihres Shops an Affilentra gemeldet; Browser‑Cookies sind dabei nicht erforderlich.
- Fingerprint‑Fallback: Wenn keine Click‑ID vorhanden oder Cookies verloren sind, wird ein gehashter, datenschutzbewusster Gerätesignatur‑Abgleich genutzt, um Attributionen zuzuordnen.
- Tracking‑Domain oder Subdomain festlegen (z. B. track.ihredomain.de) und per DNS (A/CNAME) auf den Affilentra‑Server zeigen.
- Ssl/TLS für die Tracking‑Domain einrichten (letsencrypt/andere), da Postbacks und Redirects über HTTPS laufen müssen.
- API‑Token für Postbacks erstellen und sicher speichern; diese Tokens werden zur Signaturprüfung bei Conversions verwendet.
- Entwicklungsumgebung für Testtransaktionen bereitstellen.
Bei self‑hosted Affilentra behalten Sie Kontrolle über Domain, Datenverarbeitung und Lizenzmodell.
Vorbereitung: Voraussetzungen und Konfiguration
Bevor Sie beginnen, stellen Sie sicher, dass die self‑hosted Affilentra‑Instanz installiert ist (PRO oder NETWORK Lizenz), und Sie Admin‑Zugriff haben. Weitere Vorbereitungsschritte:
Schritt 1 — Server‑Side Redirects einrichten
Ziel: Jeder Affiliate‑Klick wird serverseitig protokolliert und mit einer Click‑ID versehen, bevor der Nutzer auf die Shop‑Seite weitergeleitet wird.
- Trackinglink‑Format festlegen: affiliate.example.com/clk?aid={partner}&pid={produkt}&dst={zielurl}
- Click‑ID erzeugen: Beim Eintreffen eines Klicks erzeugt Ihr Server eine eindeutige Click‑ID (z. B. UUID) und speichert diese mit Timestamp, gehashtem User‑Agent, ggf. IP‑Trunk, Herkunftsparametern und optionalem Fingerprint‑Hash.
- Redirect durchführen: Nach dem Loggen macht der Server eine 302‑Weiterleitung zum Ziel (Ziel‑URL unmodifiziert oder mit zusätzlichem Parameter click_id={id} je nach Shop‑Integration). Wichtig: Weiterleitung unbedingt serverseitig, damit kein Drittanbieter‑Cookie benötigt wird.
- Cookie‑Strategie: Setzen Sie zusätzlich ein First‑Party‑Cookie (SameSite=Lax, Secure) auf Ihrer Tracking‑Domain mit der Click‑ID; dies ist hilfreich wenn der Shop auf derselben Hauptdomain liegt.
Hinweis: Affilentra kann als Ziel für die Klick‑Erfassung und Speicherung dienen; in Ihrer self‑hosted Installation aktivieren Sie die Aufzeichnung eingehender Klicks und die Vergabe von Click‑IDs in der Admin‑Konfiguration.
Schritt 2 — Conversions ohne Drittanbieter‑Cookies erfassen (Server‑to‑Server)
Die zuverlässigste Methode im cookieless Kontext ist ein serverseitiger Postback vom Shop an Affilentra.
- Postback‑Endpoint definieren: Ihr Shop sendet nach Abschluss einer Bestellung eine HTTP(S)‑Anfrage an das Affilentra‑API mit den Parametern: click_id (wenn vorhanden), amount, conversion_status, timestamp und einer HMAC‑Signatur über die Nutzdaten mit Ihrem API‑Token.
- Validierung auf Affilentra: Die Plattform prüft Signatur, existierende Click‑ID und Zeitfenster (z. B. Click‑TTL) und schreibt die Conversion in die Datenbank. Wenn click_id fehlt, wird auf Fingerprint‑Fallback gezogen (siehe Schritt 3).
- Error‑Handling: Shopseite soll bei fehlerhaften Postbacks Retry‑Mechanismen haben und Failover‑Logs bereitstellen. Affilentra liefert im Response Statuscodes für erfolgreiche und fehlgeschlagene Verarbeitungen.
Wichtig: Nutzen Sie ausschließlich Ihr API‑Token und richten Sie IP‑Whitelist oder Rate‑Limits in Affilentra ein, um Missbrauch zu verhindern.
Schritt 3 — Fingerprint‑Fallback zur Attribution bei Gerätewechsel
Wenn keine Click‑ID vorliegt (z. B. Nutzer wechselt Gerät oder Cookies wurden gelöscht), ermöglicht ein datenschutzbewusster Fingerprint‑Abgleich eine sekundäre Attribution.
- Was erfassen: Kombination aus nicht‑personenbezogenen Merkmalen wie Browser‑Fingerprint (gehashte User‑Agent‑Teile, Bildschirmauflösung, Sprache, Timezone), ggf. teilgetrunkene IP (z. B. nur /24), und ein Datum/Timestamp. Keine direkten PII‑Felder wie vollständige IP, E‑Mail oder Namen speichern.
- Hashing und Salt: Vor Speicherung alle Attribute mit einem serverseitigen Salt und einem starken Hashing‑Verfahren hashen. Salt regelmäßig rotieren und in Affilentra konfigurieren.
- Matching‑Strategie: Bei einer Conversion versucht Affilentra zuerst das exakte click_id‑Matching; fehlt das, wird innerhalb eines konfigurierbaren Zeitfensters (z. B. empfohlen: 7–30 Tage) nach passenden Fingerprint‑Hashes gesucht. Matching sollte probabilistisch und mit Schwellenwerten (Similarity‑Score) umgesetzt werden; bei mehreren Kandidaten greift ein Priorisierungsalgorithmus (zuletzt geklickt, höchste Übereinstimmung).
- Transparenz und Opt‑out: Informieren Sie Nutzer in der Datenschutzerklärung über den Einsatz von Fingerprint‑Fallbacks und bieten Sie Opt‑out‑Möglichkeiten.
Praktisches Beispiel: Ablauf einer Conversion
1) Klick auf Affiliatelink → Server‑Side Redirect zu Shop, Click‑ID wird gespeichert und als First‑Party‑Cookie gesetzt.
2) Kunde kauft → Shop sendet Postback mit click_id und Signatur an Affilentra.
3) Affilentra verifiziert Signatur, matcht click_id und verbucht Conversion. Falls click_id fehlt, wird Fingerprint‑Matching ausgelöst und eine Attribution nach definierten Regeln vorgenommen.
Testen, Monitoring und Abrechnung
Führen Sie Testszenarien durch:
- Klick → Bestellabschluss auf demselben Gerät (Click‑ID vorhanden).
- Klick → Gerätewechsel → Bestellabschluss (nur Fingerprint‑Matching möglich).
- Fehlerhafte/verspätete Postbacks und Signaturfehler.
Protokollieren Sie Klick‑ und Conversion‑Logs getrennt nach Rolle (Softwarebetreiber, Händler, Partner). Verwenden Sie Affilentra‑Reports zur Abgleichung von Zahlungen und Provisionsberechnungen; konfigurieren Sie Alarming bei Auffälligkeiten.
Sicherheit, Datenschutz und Betrieb
- Tokens und Secrets: API‑Tokens sicher verwahren, regelmäßig rotieren und Zugriffe auf Produktionssysteme beschränken.
- Datenschutz: Fingerprints nur gehasht speichern, begrenzte Aufbewahrungsfristen konfigurieren und die Rechtsgrundlage (z. B. berechtigtes Interesse) prüfen. Holen Sie bei Bedarf Rechtsrat ein.
- Cookie‑Konfiguration: First‑party‑Cookies mit SameSite=Lax/Secure und angemessener Laufzeit; keine Abhängigkeit von Drittanbieter‑Cookies.
Praxisorientierte Empfehlungen für Händler
- Nutzen Sie Ihre eigene Tracking‑Domain, um First‑Party‑Kontext zu maximieren.
- Setzen Sie auf server‑to‑server Postbacks als Primärkanal für Conversions; Fingerprint nur als Fallback.
- Dokumentieren Sie alle Postback‑Formate und Signaturverfahren in Ihrem Developer‑Guide, damit Integrationen für Partner reproduzierbar sind.
- Führen Sie regelmäßige Tests und Abgleiche zwischen Shop‑Orders und Affilentra‑Reports durch.
Fazit und nächster Schritt
Mit server‑side Redirects, server‑to‑server‑Postbacks und einem datenschutzkonformen Fingerprint‑Fallback können Händler cookieless Tracking mit Affilentra self‑hosted technisch umsetzen und gleichzeitig Kontrolle über Daten und Attribution behalten. Die beschriebene Konfiguration reduziert die Abhängigkeit von Drittanbieter‑Cookies und bietet eine transparente Grundlage für Provisionsberechnung und Abrechnung.
Einstieg wählen: Informieren Sie sich und starten Sie die Implementierung auf https://affilentra.de
Nächster Schritt
Affilentra selbst ausprobieren
Einheitliche Plattform, die Produktbereitstellung, Tracking, Conversion-Validierung, Provisionsberechnung und Auszahlung entlang klar getrennter Rollen transparent zusammenführt; Option zur self-hosted Installation mit Dauerlizenz ohne Umsatzbeteiligung; Händler behalten Kontrolle über Produkte, Konditionen und Werbemittel; Partner erhalten persönliche Trackinglinks und nachvollziehbare Auszahlungshistorie.