Symptomy
- Affiliate vidí 0 kliků v dashboardu i přesto, že sdílel link.
{prefix}affinite_clickstabulka je prázdná nebo neroste.- Konverze se nepřiřazují k affiliate (žádný
_affinite_affiliate_idmeta 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
refneboaffinite_linkparameter. - 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.jsnebofrontend.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.
