Kliknutí se netrackují

Symptomy

  • Affiliate vidí 0 kliků v dashboardu i přesto, že sdílel link.
  • {prefix}affinite_clicks tabulka je prázdná nebo neroste.
  • Konverze se nepřiřazují k affiliate (žádný _affinite_affiliate_id meta na orderu).

Diagnostika krok-za-krokem

1. Verifikujte URL formát

Affiliate link MUSÍ obsahovat ?ref=CODE nebo ?affinite_link=slug. Klikněte na link v incognito okně a zkontrolujte URL bar po načtení stránky:

  • URL by měla obsahovat ref nebo affinite_link parameter.
  • Pokud chybí, link byl pravděpodobně zkrácen (např. social media post).

2. Check cookie v browseru

  • V DevTools → Application → Cookies, najděte cookie affinite_affiliate.
  • Hodnota by měla být affiliate_id (integer).
  • Pokud chybí: browser blokuje cookies, nebo affiliate code neexistuje/není active.

3. Check affiliate status

wp db query "SELECT affiliate_code, status FROM {prefix}affinite_affiliates WHERE affiliate_code='ABC123'"

Status musí být active. Pending/suspended/rejected → plugin klik neeviduje.

4. Page cache

Od verze 1.2.0 je plugin page-cache compatible (žádné PHP session). Pokud ale stránka, kterou affiliate odkazuje, používá agresivní cache (Varnish), template_redirect hook se nemusí spustit.

  • Test: vypněte cache na 1 hodinu a zkuste znovu.
  • Pokud problém zmizí, přidejte do cache rules: bypass cache when URL has ?ref=*

5. JS console errors

V DevTools → Console hledejte:

  • jQuery error (plugin frontend.js používá jQuery).
  • 404 na frontend.js nebo frontend.css — assets se neenqueueovaly.
  • CORS error pokud děláte cross-domain tracking.

6. WP_DEBUG log

// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Po reprodukci kliku check wp-content/debug.log pro PHP warnings z TrackingManager.

Časté příčiny

  • Cookie blokovaná — browser/extension blokuje 3rd party cookies (i pro same-domain v některých konfiguracích).
  • Affiliate code neexistuje — typo v URL.
  • Affiliate status ≠ active — pending/suspended/rejected.
  • Aggresivní page cache — Varnish před WP.
  • Asset enqueue conditional — od WU-015 se assets enqueueují jen na affiliate stránkách. Pokud sdílíte odkaz na nestandartní stránku, frontend.js se nenahraje — ale tracking je server-side, takže to neovlivňuje basic tracking.