Analytics & Tracking

ShahiLandin includes built-in analytics to track landing page performance without requiring external tools. Monitor views, conversions, click patterns, and engagement metrics to optimize your campaigns.

Analytics Features

The analytics system provides:

1. Page View Tracking: Automatic visitor counting with bot filtering
2. Conversion Tracking: Monitor form submissions and goal completions
3. Click Tracking: Record interactions with buttons and links
4. Conversion Rate Calculation: Automatic calculation of conversion percentages
5. Historical Data: View trends over time
6. Individual Page Analytics: Detailed metrics for each landing page

Enabling Analytics


Global Settings


7. Navigate to Settings > ShahiLandin
8. Find the Analytics section
9. Toggle Analytics Enabled to ON
10. Configure tracking options:

– Track Views: Count page visitors
– Track Clicks: Record button and link clicks

11. Click Save Changes

Default State: Analytics is enabled by default.

Per-Page Settings


Analytics can be enabled or disabled for individual landing pages:

12. Edit a landing page
13. Find the ShahiLandin Analytics meta box in the sidebar
14. Toggle tracking options for this specific page
15. Update the page

How Analytics Works


View Tracking


Automatic Tracking:

16. A view is recorded each time a visitor loads your landing page
17. The plugin uses server-side tracking for reliability

Bot Filtering:
The system automatically filters common bots and crawlers:

18. Googlebot, Bingbot, Yahoo Slurp
19. Generic crawlers and spiders
20. Search engine indexers

Duplicate Prevention:

21. Uses transient cookies to prevent counting the same visitor multiple times
22. One view per visitor per hour (configurable)
23. Based on IP address and user agent combination

Click Tracking


What Gets Tracked:

24. All links (external and internal)
25. elements
26. Form submission buttons
27. CTA (call-to-action) elements

JavaScript-Based:

28. Requires analytics.js to be loaded
29. Tracks click coordinates and target element
30. Records timestamp and visitor information

REST API Endpoint:

31. Clicks are sent to /wp-json/shahilandin/v1/analytics/track-click
32. Asynchronous to avoid slowing down page interactions

Conversion Tracking


What Counts as a Conversion:

33. Form submissions on the landing page
34. Custom goal completions (defined via code)
35. Button clicks with data-shahilandin-conversion attribute

Manual Conversion Tracking:

Add this attribute to any element to track it as a conversion:

`html
Sign Up Now
`

Programmatic Tracking (for developers):

`javascript
// Track a conversion via JavaScript
ShahiLandinAnalytics.trackConversion(‘newsletter_signup’, {
email: ‘user@example.com’,
source: ‘hero_cta’
});
`

Viewing Analytics Data


Landing Page List


The landing pages admin list displays quick metrics:

36. Go to Landing Pages > All Landing Pages
37. Enable the Views and Conversions columns via Screen Options
38. See at-a-glance metrics for all pages

Individual Page Analytics


View detailed analytics for a specific landing page:

39. Edit the landing page
40. Find the ShahiLandin Analytics meta box
41. View current statistics:

– Total Views: Lifetime visitor count
– Total Conversions: Goal completions
– Conversion Rate: Percentage of visitors who convert
– Last 30 Days: Recent performance trends

Analytics Dashboard Widget


Add a dashboard widget for quick access:

42. Go to the main WordPress Dashboard
43. Click Screen Options at the top
44. Enable ShahiLandin Analytics
45. The widget shows top-performing landing pages by views and conversions

Analytics Data Structure


Data Storage


Analytics data is stored as WordPress post meta:

46. Views: shahilandinviews (integer count)
47. Conversions: shahilandinconversions (integer count)
48. Views Log: shahilandinviews_log (timestamped array)
49. Conversions Log: shahilandinconversions_log (timestamped array)

Historical Data


The plugin maintains detailed logs:

Views Log Format:
`json
[
{
“timestamp”: “2025-11-28T14:32:10Z”,
“ip”: “192.168.1.1”,
“user_agent”: “Mozilla/5.0…”,
“referrer”: “https://google.com”
}
]
`

Conversions Log Format:
`json
[
{
“timestamp”: “2025-11-28T14:35:22Z”,
“goal”: “signup”,
“data”: {“email”: “user@example.com”},
“ip”: “192.168.1.1”
}
]
`

Advanced Analytics Features


Conversion Rate Calculation


The plugin automatically calculates conversion rate:

Formula: (Total Conversions / Total Views) × 100

Example:

50. 500 views + 25 conversions = 5% conversion rate

Date Range Filtering


Query analytics data for specific periods:

`php
// Get analytics for a date range
$analytics = ShahiLandin\Frontend\Analytics::getanalyticsdata(
$post_id,
‘2025-11-01’, // Start date
‘2025-11-30’ // End date
);
`

Export Analytics Data


Export analytics to CSV:

51. Go to Landing Pages > Analytics Export
52. Select date range
53. Choose pages to include
54. Click Download CSV

CSV Includes:

55. Page title and URL
56. Total views and conversions
57. Conversion rate
58. Daily breakdown

Integration with External Analytics


Google Analytics 4


Configure GA4 integration:

59. Go to Settings > ShahiLandin > Analytics
60. Enter your GA4 Measurement ID
61. Enter your GA4 API Secret
62. Save settings

Features:

63. Sends events to GA4 for centralized reporting
64. Custom event names: shahilandinview, shahilandinconversion
65. User properties include landing page ID and title

Mixpanel


Enable Mixpanel tracking:

66. Go to Settings > ShahiLandin > Analytics
67. Enter your Mixpanel Token
68. Save settings

Events Sent:

69. Landing Page Viewed
70. Landing Page Converted
71. Custom properties for segmentation

Facebook Pixel


Add Facebook Pixel to landing pages:

72. Edit a landing page
73. Find the ShahiLandin Head Assets meta box
74. Add Facebook Pixel code to Scripts:

`html

`

Note: Requires administrator privileges and “Allow Scripts” enabled during HTML import.

Privacy & GDPR Compliance


Data Collection


By default, ShahiLandin collects:

75. IP addresses (for duplicate detection)
76. User agent strings (for bot filtering)
77. Referrer URLs
78. Timestamps

Privacy Controls


Disable IP Collection:

Add this to your theme’s functions.php:

`php
addfilter(‘shahilandinanalyticscollectip’, ‘_returnfalse’);
`

Anonymize IP Addresses:

`php
addfilter(‘shahilandinanalyticsanonymizeip’, ‘_returntrue’);
`

Data Retention:

Configure how long to keep analytics data:

79. Go to Settings > ShahiLandin > Analytics
80. Set Data Retention Period (30, 60, 90 days, or Forever)
81. Old data is automatically purged via cron job

Cookie Consent


ShahiLandin respects consent banners:

Integration with Cookie Plugins:

The analytics script checks for consent cookies:

`javascript
// Analytics only runs if consent is granted
if (typeof cookieconsent !== ‘undefined’ && cookieconsent.hasConsented()) {
ShahiLandinAnalytics.init();
}
`

Compatible with:

82. Cookie Notice for GDPR
83. Complianz GDPR/CCPA
84. GDPR Cookie Consent
85. Other standard consent plugins

Performance Considerations


Caching


Analytics tracking bypasses page caches:

86. Uses AJAX for view and click tracking
87. Works with WP Rocket, W3 Total Cache, and other caching plugins
88. No impact on cached page performance

Database Optimization


Keep analytics data optimized:

89. Prune Old Data: Set a retention period to limit database growth
90. Archive Historical Data: Export and delete old analytics periodically
91. Index Meta Keys: ShahiLandin automatically creates database indexes for fast queries

Asynchronous Loading


The analytics JavaScript loads asynchronously:

`html

`

This prevents blocking page rendering.

Troubleshooting Analytics


Views Not Tracking


Check if analytics is enabled:

92. Go to Settings > ShahiLandin
93. Verify Analytics Enabled is ON

Check for caching issues:

94. Clear your site cache
95. Try viewing in an incognito window

Check for bot filtering:

96. Analytics filters bots by default
97. Test with a standard browser, not developer tools

Conversions Not Recording


Verify conversion elements:

98. Ensure buttons have data-shahilandin-conversion attribute
99. Check that analytics.js is loaded on the page

Check JavaScript errors:

100. Open browser DevTools console
101. Look for errors related to ShahiLandin

Test manually:
`javascript
// Run this in browser console
ShahiLandinAnalytics.trackConversion(‘test’);
`

Inaccurate Conversion Rates


Duplicate views:

102. Transient caching prevents duplicates for 1 hour
103. If testing repeatedly, clear cookies between tests

Bot traffic:

104. Verify bot filtering is working
105. Check user agent logs for suspicious patterns

Analytics Settings Reference


Global Settings


| Setting | Default | Description |
|———|———|————-|
| Analytics Enabled | true | Master switch for analytics system |
| Track Views | true | Count page views |
| Track Clicks | true | Record button and link clicks |
| Data Retention | Forever | How long to keep analytics data |
| Anonymize IPs | false | Hash IP addresses for privacy |

External Integration Settings


| Setting | Default | Description |
|———|———|————-|
| Mixpanel Token | Empty | Mixpanel project token |
| GA4 Measurement ID | Empty | Google Analytics 4 measurement ID |
| GA4 API Secret | Empty | GA4 Measurement Protocol secret |
| Slack Webhook | Empty | URL for operational alerts |

REST API Endpoints


106. Track View: POST /wp-json/shahilandin/v1/analytics/track-view
107. Track Click: POST /wp-json/shahilandin/v1/analytics/track-click
108. Track Conversion: POST /wp-json/shahilandin/v1/analytics/track-conversion
109. Get Analytics: GET /wp-json/shahilandin/v1/analytics/{post_id}

Tips for Better Analytics


110. Set Clear Goals: Define what counts as a conversion before launching
111. Test Tracking: Always test analytics in staging before going live
112. Review Regularly: Check analytics weekly to spot trends
113. Compare Periods: Use date range filters to compare performance
114. Export Data: Regularly back up analytics to CSV for reporting
115. Combine with External Tools: Use ShahiLandin + GA4 for comprehensive insights

—

For A/B testing analytics, see the Experiments & A/B Testing article.