Adblock Detection Logs

Overview

The Adblock Detection Logs module provides detailed monitoring and analytics of ad-blocking software usage across your application. Track when and where users are blocking ads, analyze patterns, export data for further analysis, and maintain system performance by archiving old logs.

Accessing Adblock Logs

Navigation path: Dashboard > Advertising > Adblock Logs

Required permission: manage_ads

Key Features

• Real-Time Detection: Automatic logging when ad blockers are detected
• Detailed Statistics: Overview of total detections, today's detections, unique IPs, and most affected pages
• Advanced Filtering: Filter by date range, IP address, and page URL
• CSV Export: Export filtered logs for external analysis
• Log Archiving: Automatically clean up old logs to maintain performance
• Mobile-Friendly: Responsive design for viewing logs on any device

Main Interface

Statistics Dashboard

Four key metrics are displayed at the top:

Total Detections

• Total number of ad blocker detections recorded
• Cumulative count across all time
• Helps understand overall ad blocker usage

Today's Detections

• Number of detections in the current day
• Resets at midnight
• Useful for monitoring daily trends

Unique IPs

• Number of unique IP addresses detected
• Helps distinguish between unique users and repeat visits
• Indicates actual user count vs. total detections

Most Affected Page

• Page URL with the highest number of detections
• Identifies which content attracts users with ad blockers
• Helps prioritize optimization efforts

Logs Table

Desktop View Columns:

• IP Address: User's IP address with visual icon
• Page URL: Full URL where detection occurred
• User Agent: Browser and device information
• Detected At: Date and time of detection

Mobile View:

• Compact card layout
• All information displayed vertically
• Optimized for small screens

Filters

Available Filters:

• Start Date: Beginning of date range
• End Date: End of date range
• IP Address: Specific IP to search for
• Page URL: Specific page URL to filter
• Per Page: Number of results per page (25, 50, 100, 200)

Common Tasks

Viewing Recent Detections

1. Navigate to Dashboard > Advertising > Adblock Logs
2. The most recent detections appear at the top
3. Review the statistics cards for quick insights
4. Scroll through the table to see individual detections
5. Use pagination to view older entries

Filtering by Date Range

1. Go to Dashboard > Advertising > Adblock Logs
2. Enter a Start Date in the filter section
3. Enter an End Date in the filter section
4. Click Apply Filters
5. View detections within the specified date range
6. Click Clear to reset filters

Searching for Specific IP Address

1. Navigate to Dashboard > Advertising > Adblock Logs
2. Enter the IP address in the IP Address filter field
3. Click Apply Filters
4. View all detections from that specific IP
5. Useful for investigating specific users or patterns

Finding Detections on Specific Page

1. Go to Dashboard > Advertising > Adblock Logs
2. Enter the page URL (or partial URL) in the Page URL filter
3. Click Apply Filters
4. View all detections on that page
5. Helps identify which pages are most affected

Exporting Logs to CSV

1. Navigate to Dashboard > Advertising > Adblock Logs
2. Optionally apply filters to narrow down data
3. Click Export to CSV button
4. A CSV file downloads with the filtered data
5. Open in Excel, Google Sheets, or other tools for analysis
6. CSV includes: IP address, page URL, user agent, detection timestamp

Archiving Old Logs

1. Go to Dashboard > Advertising > Adblock Logs
2. Click Archive Old Logs button
3. A modal dialog appears
4. Enter the number of days to keep (default: 90)
5. Click Archive Logs
6. Confirm the action
7. Logs older than specified days are permanently deleted
8. Helps maintain database performance

Analyzing Detection Patterns

1. Navigate to Dashboard > Advertising > Adblock Logs
2. Review the Most Affected Page statistic
3. Export logs for a specific time period
4. Analyze in spreadsheet software:
   • Group by page URL to find most affected pages
   • Group by date to identify trends over time
   • Group by IP to find repeat visitors
   • Analyze user agents to understand device/browser patterns

Log Entry Details

IP Address

• Format: IPv4 or IPv6
• Purpose: Identifies the user's network location
• Privacy: Consider privacy regulations when storing IP addresses
• Use Cases: Track repeat visitors, identify patterns, investigate abuse

Page URL

• Format: Full URL path
• Purpose: Shows where ad blocker was detected
• Examples: /blog/post-title, /products/category, /
• Use Cases: Identify most affected content, optimize specific pages

User Agent

• Format: Browser user agent string
• Purpose: Identifies browser, device, and operating system
• Information Includes:
  • Browser name and version
  • Operating system
  • Device type (desktop, mobile, tablet)
• Use Cases: Understand which platforms use ad blockers most

Detected At

• Format: Timestamp (date and time)
• Purpose: Records when detection occurred
• Display: Formatted as "MMM DD, YYYY HH:MM AM/PM"
• Use Cases: Analyze trends over time, identify peak usage periods

Statistics and Analytics

Understanding the Metrics

Total Detections vs. Unique IPs:

• High ratio (e.g., 1000 detections / 100 IPs = 10:1) indicates repeat visitors
• Low ratio (e.g., 1000 detections / 900 IPs = 1.1:1) indicates mostly unique visitors
• Helps understand user behavior patterns

Today's Detections:

• Compare to historical averages to spot anomalies
• Sudden spikes may indicate viral content or bot activity
• Gradual increases may indicate growing ad blocker adoption

Most Affected Page:

• High-traffic pages naturally have more detections
• Calculate detection rate: (detections / total visits) × 100
• Pages with high detection rates may need optimization

Calculating Ad Blocker Adoption Rate

1. Export adblock logs for a time period
2. Count unique IP addresses with detections
3. Compare to total unique visitors (from analytics)
4. Formula: (Unique IPs with adblock / Total unique visitors) × 100
5. Industry average is typically 25-40%

Permissions

The following permission is required to access adblock logs:

• manage_ads: Full access to view logs, export data, and archive old entries

Users without this permission will see an "Access Denied" message.

Tips and Best Practices

Data Collection

• Enable adblock detection in Advertising Settings
• Monitor logs regularly to understand trends
• Export data periodically for long-term analysis
• Archive old logs to maintain performance

Privacy Considerations

• Be aware of privacy regulations (GDPR, CCPA, etc.)
• Consider anonymizing IP addresses after a certain period
• Include adblock detection in your privacy policy
• Don't use detection data for punitive measures

Analysis Best Practices

• Look for patterns over time, not individual detections
• Compare detection rates across different content types
• Identify which pages are most affected
• Understand your audience's ad blocker usage

Performance Maintenance

• Archive logs older than 90 days regularly
• Monitor database size and performance
• Consider automated archiving schedules
• Export important data before archiving

Response Strategies

• Don't be aggressive with anti-adblock measures
• Use polite messaging to explain ad importance
• Offer alternatives (subscriptions, donations)
• Focus on improving ad quality and relevance

Troubleshooting

No Detections Being Logged

Problem: Adblock detection is enabled but no logs appear

Solutions:

1. Verify Enable Adblock Detection is checked in Advertising Settings
2. Test with an actual ad blocker installed (uBlock Origin, AdBlock Plus)
3. Check browser console for JavaScript errors
4. Ensure the detection script is loading properly
5. Verify database permissions for logging
6. Check that the adblock_logs table exists in database
7. Test on different browsers and devices

Excessive Detections from Single IP

Problem: One IP address has thousands of detections

Solutions:

1. May indicate a bot or automated scraper
2. Check user agent for bot signatures
3. Consider implementing rate limiting
4. Review IP address for known bot networks
5. May need to block or throttle the IP
6. Could be a proxy or VPN with multiple users

Export Not Working

Problem: CSV export button doesn't download file

Solutions:

1. Check browser popup blocker settings
2. Verify you have manage_ads permission
3. Try with fewer records (apply filters first)
4. Check browser console for errors
5. Ensure sufficient server memory for export
6. Try a different browser

Archive Function Not Deleting Logs

Problem: Old logs remain after archiving

Solutions:

1. Verify you confirmed the archive action
2. Check that you have manage_ads permission
3. Ensure database permissions allow deletions
4. Check server logs for errors
5. Try archiving smaller date ranges
6. Verify the archive function is working (check database)

Statistics Not Updating

Problem: Statistics cards show outdated numbers

Solutions:

1. Refresh the page to update statistics
2. Clear application cache
3. Check that new detections are being logged
4. Verify database queries are executing correctly
5. Check for caching issues on the server

Related Modules

• Advertising Settings: Enable and configure adblock detection
• Ads Management: Manage advertisements that may be blocked
• Ad Placements: Control where ads appear on your site

Data Retention and Privacy

Recommended Retention Periods

• Active Analysis: Keep 30-90 days for active monitoring
• Historical Trends: Keep 6-12 months for trend analysis
• Long-Term Storage: Export and archive data older than 1 year
• Compliance: Follow local regulations for data retention

Privacy Best Practices

1. Anonymization: Consider anonymizing IP addresses after 30 days
2. Disclosure: Mention adblock detection in privacy policy
3. Purpose Limitation: Only use data for stated purposes
4. Data Minimization: Only collect necessary information
5. User Rights: Provide way for users to request data deletion

GDPR Compliance

If operating in EU:

• Inform users about adblock detection in privacy policy
• Consider IP addresses as personal data
• Provide data access and deletion mechanisms
• Document legitimate interest for processing
• Implement appropriate security measures