Affiliate odkazy a tracking

Dva formáty affiliate odkazů

Format 1 — query parameter

• URL: https://example.com/?ref=ABC123
• Affiliate kód je v parametru ref (volitelně i affiliate, aff, partner).
• Při kliku plugin nastaví cookie a zaeviduje klik.
• Vhodné pro sdílení libovolných stránek s automatickým trackingem.

Format 2 — custom link slug

• URL: https://example.com/?affinite_link=slug
• Plugin najde záznam v affinite_links podle slugu, zaeviduje klik s vazbou na link_id a přesměruje na target URL.
• Vhodné pro pojmenované kampaně s vlastními cíli, redirect type 301/302 a click count statistikou.

Redirect codes

• 301 (Permanent) — vhodné pro stabilní kampaně, browser cachuje redirect.
• 302 (Temporary) — default, vhodné pro flexibilní kampaně s možnou změnou cíle.
• Plugin validuje proti allowlistu — jiné kódy se ignorují a použije se fallback 302.

Cookie tracking

• Cookie name: affinite_affiliate (obsahuje affiliate_id).
• Cookie name: affinite_click (obsahuje click_id pro attribution).
• Platnost: konfigurovatelná v Settings → General → Cookie Duration (default 30 dní).
• Flags: HttpOnly + Secure (pokud HTTPS).
• Path + Domain: použity z WP konstant COOKIEPATH/COOKIE_DOMAIN.

Open redirect ochrana

Plugin používá wp_safe_redirect() se scoped allowed_redirect_hosts filtrem — povolí jen host uloženého target URL pro daný request. Schéma je validováno proti allowlistu http/https (javascript:, data: a další jsou odmítnuty).

Zachycená data v affinite_clicks

• affiliate_id, link_id, campaign_id (vazby)
• visitor_id — md5 hash z IP + user-agent + timestamp
• ip_address — REMOTE_ADDR (default), proxy headers volitelně
• referrer_url, landing_url, user_agent
• device_type (desktop/mobile/tablet), browser (firefox/chrome/safari/edge), os (windows/mac/linux/android/ios)
• UTM parametry (source/medium/campaign/term/content)
• clicked_at timestamp