Tracking Issues
Comprehensive guide to diagnosing and resolving affiliate tracking problems.This troubleshooting guide helps you diagnose and fix tracking issues in Affelios. For implementation details, see How Attribution Works (operators) and How Tracking Links Work (affiliates).
Understanding Tracking
Tracking Fundamentals
-
How Tracking Works
- Click registration process and ClickKey generation
- Cookie placement and storage mechanisms
- Conversion attribution methods and timing
- Data flow from click to commission processing
For detailed implementation guidance, see How Attribution Works for operators or How Tracking Links Work for affiliates. -
Tracking Components
- Affiliate tracking links - Generated from trackers and contain ClickKeys
- Conversion tracking pixels - Fire on purchase completion
- JavaScript tracking codes - Handle ClickKey capture and storage
- Server-to-server postbacks - Send transaction data to Affelios
Understanding tracker-based link generation is crucial for troubleshooting. See How Tracking Links Work for the complete process. -
Attribution Models
- First-click attribution - Credit goes to the first affiliate link clicked
- Last-click attribution - Credit goes to the most recent affiliate link
- Custom attribution rules - Program-specific attribution logic
For detailed attribution configuration and commission plan setup, see How Attribution Works.
Common Tracking Challenges
-
Technical Limitations
- Browser privacy settings
- Ad blocker interference
- Cross-device tracking
- Mobile app attribution
-
Implementation Issues
- Incorrect code placement
- Missing tracking parameters
- Timing synchronization problems
- Environment configuration errors
Click Tracking Issues
Missing Clicks
-
Link Structure Problems
- Symptoms: No clicks registered despite traffic
- Causes: Malformed tracking URLs, missing parameters, incorrect tracker configuration
- Solutions: Validate link structure, verify tracker setup, create new tracker if needed
- Prevention: Use proper tracker setup, validate before deployment
For proper link generation and structure, see How Tracking Links Work. For ClickKey parameter implementation, see How Attribution Works. -
JavaScript Errors
- Symptoms: Intermittent click tracking failures
- Causes: JavaScript conflicts, loading sequence issues
- Solutions: Debug JavaScript console, optimize loading order
- Prevention: Test across browsers, use asynchronous loading
-
Redirect Issues
- Symptoms: Clicks not reaching destination
- Causes: Redirect chain problems, caching issues
- Solutions: Minimize redirect chains, clear cache
- Prevention: Direct linking when possible, monitor redirect paths
Inaccurate Click Counts
-
Double Counting
- Symptoms: Inflated click numbers
- Causes: Multiple tracking implementations, refresh issues
- Solutions: Deduplicate tracking codes, implement click validation
- Prevention: Centralized tracking implementation, unique session handling
-
Bot Traffic
- Symptoms: High clicks with low conversions
- Causes: Automated bot clicking, click farms
- Solutions: Implement bot detection, filter suspicious traffic
- Prevention: Real-time validation, behavioral analysis
-
Cross-Domain Issues
- Symptoms: Lost tracking across domains
- Causes: Cookie domain restrictions, referrer policy changes
- Solutions: Implement cross-domain tracking, use server-side solutions
- Prevention: Unified tracking domain, proper cookie configuration
Conversion Tracking Issues
Missing Conversions
-
Pixel Implementation Problems
- Symptoms: Conversions not recorded
- Causes: Missing conversion pixels, incorrect placement, ClickKey not properly stored
- Solutions: Verify pixel implementation, test firing conditions, check ClickKey storage
- Prevention: Thorough testing, implementation validation
For proper ClickKey storage implementation, see How Attribution Works. For testing procedures, see How Attribution Works. -
Attribution Window Issues
- Symptoms: Conversions attributed incorrectly or not at all
- Causes: Expired cookies, incorrect attribution windows, ClickKey storage failures
- Solutions: Adjust attribution settings, verify cookie duration, implement multiple storage methods
- Prevention: Appropriate window configuration, clear communication, robust storage implementation
The attribution flow from ClickKey capture to commission processing is detailed in How Attribution Works. -
Cross-Device Attribution
- Symptoms: Mobile clicks not attributed to desktop conversions
- Causes: Cookie isolation between devices
- Solutions: Implement user ID tracking, use deterministic matching
- Prevention: Email-based attribution, login-based tracking
Duplicate Conversions
-
Multiple Firing Events
- Symptoms: Same conversion recorded multiple times
- Causes: Pixel firing on page refresh, multiple pixel implementations, missing transaction IDs
- Solutions: Implement conversion deduplication, session-based tracking, use unique transaction IDs
- Prevention: Unique conversion identifiers, proper pixel placement, transaction ID implementation
Transaction ID Best Practice: Integrations should pass a unique transaction ID from the operator’s internal systems to ensure idempotency. This prevents duplicate conversions when the same transaction is reported multiple times due to network issues, retries, or system failures.For implementation details, see How Attribution Works. -
Testing Environment Pollution
- Symptoms: Test conversions in production data
- Causes: Development testing on production systems, missing transaction ID validation
- Solutions: Filter test transactions, separate environments, validate transaction IDs
- Prevention: Dedicated testing environments, proper data segregation, transaction ID validation
Mobile Tracking Challenges
Important Mobile Tracking Limitations: Due to recent privacy changes by Apple (iOS 14.5+ ATT framework) and Android (Privacy Sandbox), web-to-app attribution has become significantly more difficult. Affelios currently supports mobile tracking primarily for in-house analytics, such as tracking customer registrations by platform, rather than full cross-platform attribution.Technical Requirements: Implementing mobile tracking requires technical knowledge and direct integration within the mobile apps themselves, including SDK implementation and proper attribution handling within the app code.
App-to-Web Attribution
-
Deep Link Issues
- Symptoms: Lost attribution from app to website
- Causes: Deep link configuration problems, app store attribution, platform privacy restrictions
- Solutions: Proper deep link setup, universal link implementation
- Prevention: Comprehensive testing, platform-specific optimization
Platform Privacy Impact: Apple’s App Tracking Transparency (ATT) and Android’s Privacy Sandbox have significantly limited cross-platform tracking capabilities. Traditional web-to-app attribution methods are no longer reliable. -
Mobile Browser Limitations
- Symptoms: Inconsistent tracking on mobile browsers
- Causes: Safari ITP, Chrome SameSite restrictions, iOS 14.5+ ATT framework
- Solutions: Server-side tracking, first-party data collection
- Prevention: Mobile-first tracking strategy, regular testing
Current Affelios Mobile Support: Mobile tracking in Affelios is currently optimized for in-house analytics, such as monitoring customer registration patterns across different platforms, rather than full cross-platform attribution. -
Cross-App Tracking
- Symptoms: Attribution lost between mobile apps
- Causes: App sandboxing, privacy restrictions, platform privacy frameworks
- Solutions: SDK implementation, unified ID solutions (limited effectiveness)
- Prevention: Platform-native attribution, compliance with guidelines
Privacy Framework Impact: Both Apple’s ATT and Android’s Privacy Sandbox have created significant barriers to cross-app tracking, making traditional attribution methods unreliable for mobile-to-web conversions.Implementation Complexity: Cross-app tracking requires significant technical expertise and direct integration within each mobile application, including custom SDK development, attribution logic implementation, and compliance with platform-specific privacy requirements.
Privacy and Compliance Impact
Cookie Restrictions
-
Third-Party Cookie Blocking
- Symptoms: Reduced tracking accuracy
- Causes: Browser privacy updates, user privacy settings
- Solutions: First-party cookie implementation, server-side tracking
- Prevention: Privacy-compliant tracking methods, user consent management
-
GDPR and Privacy Laws
- Symptoms: Tracking consent issues
- Causes: Legal compliance requirements, user opt-outs
- Solutions: Consent management platforms, privacy-compliant tracking
- Prevention: Legal review, privacy-by-design implementation
-
Ad Blocker Impact
- Symptoms: Tracking scripts blocked
- Causes: Ad blocker software, privacy-focused browsers
- Solutions: Server-side tracking, native integration methods
- Prevention: Non-intrusive tracking methods, user education
Diagnostic Tools and Techniques
Browser-Based Debugging
-
Developer Console
- Network tab analysis for tracking calls and ClickKey transmission
- Console error identification
- Cookie and storage inspection (check ClickKey storage)
- JavaScript debugging tools
For comprehensive testing procedures including ClickKey validation, see How Attribution Works. -
Browser Extensions
- Tracking pixel validators
- Cookie inspection tools (verify ClickKey cookies)
- Network request analyzers
- Attribution testing tools
-
Testing Procedures
- Incognito/private browsing tests
- Cross-browser validation
- Mobile device testing
- Different network condition tests
- ClickKey capture and storage validation
For detailed tracker testing procedures, see How Tracking Links Work.
Server-Side Diagnostics
-
Log Analysis
- Server log examination
- Request pattern analysis
- Error rate monitoring
- Performance metrics review
-
API Testing
- Webhook delivery verification
- Postback URL testing
- API response validation
- Data synchronization checks
-
Database Queries
- Raw data examination
- Attribution chain verification
- Duplicate detection queries
- Performance impact analysis
Resolution Strategies
Quick Fixes
-
Common Solutions
- Clear browser cache and cookies
- Create new tracker or verify existing tracker setup
- Update tracking code placement
- Verify account settings
- Check ClickKey parameter configuration
For step-by-step tracker creation and link generation, see How Tracking Links Work. -
Testing Protocols
- End-to-end tracking tests
- Cross-device verification
- Multi-browser validation
- Performance impact assessment
- ClickKey capture and storage validation
Comprehensive testing procedures are outlined in How Attribution Works and How Tracking Links Work.
Advanced Solutions
-
Technical Implementations
- Server-side tracking setup
- First-party data collection
- Advanced attribution modeling
- Custom tracking solutions
- ClickKey storage optimization
For detailed technical implementation guidance, see How Attribution Works and How Attribution Works. -
Process Improvements
- Automated testing implementation
- Monitoring and alerting systems
- Regular audit procedures
- Documentation and training
- Tracker performance optimization
Learn about tracker-based optimization strategies in How Tracking Links Work.
Prevention and Best Practices
Implementation Best Practices
-
Code Standards
- Consistent implementation patterns
- Error handling procedures
- Performance optimization
- Security considerations
-
Testing Protocols
- Pre-deployment testing
- Continuous monitoring
- Regular validation procedures
- Performance benchmarking
Monitoring and Maintenance
-
Proactive Monitoring
- Real-time tracking validation
- Automated alert systems
- Performance trend analysis
- Issue prediction models
-
Regular Maintenance
- Code updates and patches
- Configuration reviews
- Performance optimization
- Compliance verification
- Tracker performance audits
Related Documentation
Implementation Guides
For Operators (Program Managers):
- How Attribution Works - Complete technical implementation guide
- ClickKey Parameter Implementation - URL parameter setup
- Backend ClickKey Storage - Data storage strategies
- Testing and Validation - Implementation testing procedures
- How Tracking Links Work - Complete tracker and link guide
- Creating Your First Tracker - Tracker setup process
- Understanding Link Structure - Link components and variations
- Tracker Testing Checklist - Pre-deployment testing
- Tracker Performance Analysis - Optimization strategies
- Commission Plan Configuration - Attribution logic setup
- Performance Optimization - Scalable implementation
Quick Reference
Common Issues and Solutions:Missing Clicks:
- Verify tracker configuration - How Tracking Links Work
- Check link structure - Understanding Link Structure
- Validate ClickKey parameters - ClickKey Parameter Implementation
- Verify ClickKey storage - Backend ClickKey Storage
- Test attribution flow - Transaction Reporting to Affelios
- Check commission configuration - Commission Plan Configuration
- Use comprehensive testing procedures - Testing and Validation
- Follow tracker testing checklist - Tracker Testing Checklist
- Monitor tracker performance - Tracker Performance Analysis