Markopolo Tracker

Description

Markopolo Tracker is a lightweight tracking plugin that captures key WordPress site events and sends them to the Markopolo AI analytics platform for reporting and attribution.

Key Features

• Page and interaction tracking: captures page_view, click, form_interaction, and Search events.
• Form data capture: can capture name, email, and phone values when they are present in forms.
• Session tracking: uses a UUID-based session identifier to group user activity.
• First-party identifier: manages a muid cookie for visitor identification.
• Marketing attribution data: can include common attribution cookies such as Facebook Pixel, TikTok, Google Analytics, and Microsoft UET cookies when present.
• Simple configuration: add your Tag ID from a WordPress admin settings page.
• Lightweight front-end script: loads only when a valid Tag ID and endpoint are configured.

How It Works

1. Install and activate the plugin.
2. Go to Settings > Markopolo Tracker.
3. Enable Enable Tracking in plugin settings (disabled by default).
4. Enter your Tag ID.
5. Save settings.
6. The plugin loads its front-end script and sends tracked events to the Markopolo endpoint.

Tracking is off by default. The plugin does not load front-end tracking until Enable Tracking is explicitly enabled by an admin and a valid Tag ID is provided.

External Services

This plugin relies on Markopolo AI services to provide analytics and attribution functionality.

Service A: Event ingestion endpoint

• What it is used for: Receiving browser-side analytics events for reporting and attribution.
• Endpoint: https://mtag.markopolo.ai/mark
• When data is sent: On tracked front-end events (for example page views, clicks, form interactions, and search events) only after explicit admin opt-in via Enable Tracking, with a valid Tag ID and endpoint configured.
• Data sent may include: tag ID, page URL/path/title, referrer, language, timezone, viewport/screen data, session and visitor identifiers, attribution cookies when available, click metadata, and form-related values such as name/email/phone/search terms when detected.

Service B: Settings webhook endpoint

• What it is used for: Notifying Markopolo when plugin settings lifecycle events occur.
• Endpoint: https://api-alpha.markopolo.ai/v1/integrations/wordpress/webhook
• When data is sent:
  • Only after an admin has explicitly enabled Enable Tracking.
  • When Tag ID is set for the first time.
  • When Tag ID is updated.
  • When Tag ID is removed.
  • During plugin uninstall, only when tracking is enabled and a Tag ID is configured.
• Data sent: event name, tag ID, previous tag ID (when applicable), plugin name, site URL, and event timestamp.

Service terms and privacy

• Terms and legal information: https://markopolo.ai/legal
• Privacy policy: https://markopolo.ai/legal

Event Types Tracked

• page_view: fired on page load.
• click: fired when users interact with common clickable elements.
• form_interaction: fired on form change and submit events.
• Search: fired when a search term is detected from a search form or search URL.

Data Collected

Depending on the page and user interaction, the plugin may collect and send:

• Page URL, path, title, referrer, language, timezone, viewport, and screen size
• Session ID and visitor identifier (muid)
• Marketing attribution cookies when available
• Form values such as name, email, phone, and search terms
• Click metadata such as element text, ID, class, and coordinates

Privacy & Consent

This plugin tracks customer behavior including:
* Page views, clicks, searches, and form interactions
* Email addresses and phone numbers from form interactions
* Marketing cookies (Facebook Pixel, TikTok, Google Analytics)
* Session data and user identifiers

All data is sent to the Markopolo AI platform for analytics purposes. Ensure your privacy policy covers this data collection and complies with applicable privacy regulations (GDPR, CCPA, etc.).

Important: Site owners are responsible for obtaining any user consent required under applicable laws and regulations before enabling or using tracking features.

Plugin-level enablement requires explicit admin opt-in. If Enable Tracking is disabled, front-end tracking and settings webhooks are disabled. Front-end tracking also requires a valid Tag ID.

Developer Notes

• The plugin uses a WordPress admin settings page for configuration.
• Settings are sanitized before being saved.
• Events are sent asynchronously from the front end.
• The plugin includes an uninstall routine that removes its saved settings.

Support

For support, contact the Markopolo team through your account or via email support@markopolo.ai.