Markopolo AI

Markopolo AI 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

• Install and activate the plugin.

• Go to Settings > Markopolo AIr.

• Enable Enable Tracking in plugin settings.

• Enter your Tag ID.

• Save settings.

• 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 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 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 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. ).

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 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

ai.