Tracking Troubleshooting

No Clicks Are Being Recorded

1. Verify the tracking script is loaded: Open your browser's developer console (F12) and type window.asa2TC. It should return an object containing an endpoint URL and a providers array. If it returns undefined, the tracking script is not loaded — check that the plugin is active and at least one provider is enabled.

2. Check for ad-blocker interference: Temporarily disable all ad blockers and browser tracking protection, then try clicking an affiliate link again.

3. Verify template compatibility: Right-click an affiliate link on your page and choose Inspect. The <a> tag should have a data-asa2-tracking attribute, and its parent container should have data-asa2-tpl and data-asa2-asin attributes. If these are missing, use the Template Checker in the plugin admin.

4. Enable Debug Logging: Go to Settings → General and enable Debug Logging. Then click an affiliate link and check the ASA2 Advanced Log for incoming click entries. This confirms whether clicks are reaching the server.

Dashboard Shows No Data

• Data aggregation delay: Today's clicks only appear in the dashboard after aggregation runs. This happens automatically overnight via WP-Cron. To see today's data immediately, go to Settings → Maintenance and click Run Aggregation.
• Check the pending clicks indicator: If the dashboard shows a banner like "X click(s) recorded today", clicks are being collected but have not been aggregated yet.
• WP-Cron not running: If data never appears, your WP-Cron may not be firing. This is common on low-traffic sites. Consider setting up a real cron job or use the manual aggregation button.

GA4 Shows No Data in Explore Reports

• Processing delay: Explore reports can take up to 24 hours to process new event data. Use Reports → Realtime to verify that events are arriving.
• Custom dimensions not registered: If you see the asa2_affiliate_click event in Realtime but your custom dimensions (ASIN, Template, etc.) are empty in Explore reports, you need to register them first. See Setting Up Custom Dimensions in GA4. Custom dimensions do not work retroactively — only data collected after registration is available.
• Measurement ID incorrect: Double-check that your Measurement ID matches the format G-XXXXXXXXXX and corresponds to the correct GA4 data stream.

Matomo Events Not Appearing

• Ad-blocker interference: Check if your browser or an ad-blocker extension is blocking requests to your Matomo instance. Look for blocked requests in your browser's Network tab (F12).
• Matomo URL and Site ID: Verify the URL and Site ID are correct. The URL should not have a trailing slash.
• Matomo for WordPress plugin: If using automatic detection, make sure the Matomo for WordPress plugin is active and tracking is enabled in its settings.
• Cookieless mode: If you enabled cookieless tracking, note that visitor identification is less accurate. This does not affect event tracking itself, but unique visitor counts may differ.

Clicks Are Tracked but Element Type Shows "unknown"

This means the affiliate link is missing the data-linktype attribute (for managed templates) or the asa2_track_attr() template function (for custom templates). The click is still recorded, but the plugin cannot determine which element was clicked. Use the Template Checker to identify which templates need updates.

Analytics Shows No Device or Browser Data

Device and browser detection was added in a later version. Only clicks recorded after the update contain this data. Older click records will show empty device/browser fields and will not appear in the Devices and Browsers charts.