{"id":321875,"date":"2026-06-04T13:53:18","date_gmt":"2026-06-04T13:53:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/markopolo-tracker\/"},"modified":"2026-06-04T15:07:14","modified_gmt":"2026-06-04T15:07:14","slug":"markopolo-tracker","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/markopolo-tracker\/","author":23474713,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Markopolo Tracker","header_author":"Markopolo","header_description":"Track Wordpress events and send them to Markopolo AI analytics platform.","assets_banners_color":"","last_updated":"2026-06-04 15:07:14","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"cgzirim","date":"2026-06-04 15:07:14"}},"upgrade_notice":{"1.0.0":"<p>Initial release of Markopolo Tracker.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3561077,"resolution":"128x128","location":"assets","locale":"","width":790,"height":790}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Settings page for entering the Tag ID.","2":"Example tracking request in browser DevTools.","3":"Event payload with page metadata.","4":"Form interaction payload with captured form fields."}},"plugin_section":[],"plugin_tags":[232,9067,456,550],"plugin_category":[36,55],"plugin_contributors":[259650],"plugin_business_model":[],"class_list":["post-321875","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-attribution","plugin_tags-marketing","plugin_tags-tracking","plugin_category-analytics","plugin_category-seo-and-marketing","plugin_contributors-cgzirim","plugin_committers-cgzirim"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/markopolo-tracker\/assets\/icon-128x128.png?rev=3561077","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Page and interaction tracking<\/strong>: captures <code>page_view<\/code>, <code>click<\/code>, <code>form_interaction<\/code>, and <code>Search<\/code> events.<\/li>\n<li><strong>Form data capture<\/strong>: can capture name, email, and phone values when they are present in forms.<\/li>\n<li><strong>Session tracking<\/strong>: uses a UUID-based session identifier to group user activity.<\/li>\n<li><strong>First-party identifier<\/strong>: manages a <code>muid<\/code> cookie for visitor identification.<\/li>\n<li><strong>Marketing attribution data<\/strong>: can include common attribution cookies such as Facebook Pixel, TikTok, Google Analytics, and Microsoft UET cookies when present.<\/li>\n<li><strong>Simple configuration<\/strong>: add your Tag ID from a WordPress admin settings page.<\/li>\n<li><strong>Lightweight front-end script<\/strong>: loads only when a valid Tag ID and endpoint are configured.<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Go to <strong>Settings &gt; Markopolo Tracker<\/strong>.<\/li>\n<li>Enable <strong>Enable Tracking<\/strong> in plugin settings (disabled by default).<\/li>\n<li>Enter your <strong>Tag ID<\/strong>.<\/li>\n<li>Save settings.<\/li>\n<li>The plugin loads its front-end script and sends tracked events to the Markopolo endpoint.<\/li>\n<\/ol>\n\n<p>Tracking is off by default. The plugin does not load front-end tracking until <strong>Enable Tracking<\/strong> is explicitly enabled by an admin and a valid Tag ID is provided.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin relies on Markopolo AI services to provide analytics and attribution functionality.<\/p>\n\n<h4>Service A: Event ingestion endpoint<\/h4>\n\n<ul>\n<li><strong>What it is used for<\/strong>: Receiving browser-side analytics events for reporting and attribution.<\/li>\n<li><strong>Endpoint<\/strong>: <code>https:\/\/mtag.markopolo.ai\/mark<\/code><\/li>\n<li><strong>When data is sent<\/strong>: On tracked front-end events (for example page views, clicks, form interactions, and search events) only after explicit admin opt-in via <strong>Enable Tracking<\/strong>, with a valid Tag ID and endpoint configured.<\/li>\n<li><strong>Data sent may include<\/strong>: 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.<\/li>\n<\/ul>\n\n<h4>Service B: Settings webhook endpoint<\/h4>\n\n<ul>\n<li><strong>What it is used for<\/strong>: Notifying Markopolo when plugin settings lifecycle events occur.<\/li>\n<li><strong>Endpoint<\/strong>: <code>https:\/\/api-alpha.markopolo.ai\/v1\/integrations\/wordpress\/webhook<\/code><\/li>\n<li><strong>When data is sent<\/strong>:\n\n<ul>\n<li>Only after an admin has explicitly enabled <strong>Enable Tracking<\/strong>.<\/li>\n<li>When Tag ID is set for the first time.<\/li>\n<li>When Tag ID is updated.<\/li>\n<li>When Tag ID is removed.<\/li>\n<li>During plugin uninstall, only when tracking is enabled and a Tag ID is configured.<\/li>\n<\/ul><\/li>\n<li><strong>Data sent<\/strong>: event name, tag ID, previous tag ID (when applicable), plugin name, site URL, and event timestamp.<\/li>\n<\/ul>\n\n<h4>Service terms and privacy<\/h4>\n\n<ul>\n<li>Terms and legal information: https:\/\/markopolo.ai\/legal<\/li>\n<li>Privacy policy: https:\/\/markopolo.ai\/legal<\/li>\n<\/ul>\n\n<h4>Event Types Tracked<\/h4>\n\n<ul>\n<li><strong>page_view<\/strong>: fired on page load.<\/li>\n<li><strong>click<\/strong>: fired when users interact with common clickable elements.<\/li>\n<li><strong>form_interaction<\/strong>: fired on form change and submit events.<\/li>\n<li><strong>Search<\/strong>: fired when a search term is detected from a search form or search URL.<\/li>\n<\/ul>\n\n<h4>Data Collected<\/h4>\n\n<p>Depending on the page and user interaction, the plugin may collect and send:<\/p>\n\n<ul>\n<li>Page URL, path, title, referrer, language, timezone, viewport, and screen size<\/li>\n<li>Session ID and visitor identifier (<code>muid<\/code>)<\/li>\n<li>Marketing attribution cookies when available<\/li>\n<li>Form values such as name, email, phone, and search terms<\/li>\n<li>Click metadata such as element text, ID, class, and coordinates<\/li>\n<\/ul>\n\n<h4>Privacy &amp; Consent<\/h4>\n\n<p>This plugin tracks customer behavior including:\n* Page views, clicks, searches, and form interactions\n* Email addresses and phone numbers from form interactions\n* Marketing cookies (Facebook Pixel, TikTok, Google Analytics)\n* Session data and user identifiers<\/p>\n\n<p>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.).<\/p>\n\n<p>Important: Site owners are responsible for obtaining any user consent required under applicable laws and regulations before enabling or using tracking features.<\/p>\n\n<p>Plugin-level enablement requires explicit admin opt-in. If <strong>Enable Tracking<\/strong> is disabled, front-end tracking and settings webhooks are disabled. Front-end tracking also requires a valid Tag ID.<\/p>\n\n<h4>Developer Notes<\/h4>\n\n<ul>\n<li>The plugin uses a WordPress admin settings page for configuration.<\/li>\n<li>Settings are sanitized before being saved.<\/li>\n<li>Events are sent asynchronously from the front end.<\/li>\n<li>The plugin includes an uninstall routine that removes its saved settings.<\/li>\n<\/ul>\n\n<h3>Support<\/h3>\n\n<p>For support, contact the Markopolo team through your account or via email support@markopolo.ai.<\/p>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Upload the plugin ZIP in <strong>Plugins &gt; Add New &gt; Upload Plugin<\/strong>.<\/li>\n<li>Or install it from the WordPress plugin directory if available.<\/li>\n<li>Activate <strong>Markopolo Tracker<\/strong>.<\/li>\n<li>Go to <strong>Settings &gt; Markopolo Tracker<\/strong>, enable <strong>Enable Tracking<\/strong>, and enter your Tag ID.<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/markopolo-tracker\/<\/code>.<\/li>\n<li>Activate the plugin in the WordPress admin.<\/li>\n<li>Open <strong>Settings &gt; Markopolo Tracker<\/strong>.<\/li>\n<li>Enable <strong>Enable Tracking<\/strong>, add your Tag ID, and save.<\/li>\n<\/ol>\n\n<h4>After Installation<\/h4>\n\n<ol>\n<li>Visit your site in a browser.<\/li>\n<li>Open the browser network panel to confirm tracking requests are being sent.<\/li>\n<li>Trigger a page view, click, form change, or search event to test the integration.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20require%20a%20tag%20id%3F\"><h3>Does this plugin require a Tag ID?<\/h3><\/dt>\n<dd><p>Yes. The front-end tracking script only loads when <strong>Enable Tracking<\/strong> is enabled and a valid Tag ID is configured.<\/p>\n\n<p>By design, the <strong>Enable Tracking<\/strong> setting is the explicit admin opt-in mechanism.<\/p><\/dd>\n<dt id=\"where%20do%20i%20get%20my%20tag%20id%3F\"><h3>Where do I get my Tag ID?<\/h3><\/dt>\n<dd><p>Your Tag ID is provided by Markopolo when you create an account. It's a unique UUID that identifies your site. Contact Markopolo support if you need help finding it.<\/p><\/dd>\n<dt id=\"where%20are%20events%20sent%3F\"><h3>Where are events sent?<\/h3><\/dt>\n<dd><p>Events are sent to Markopolo endpoints used by the plugin:<\/p>\n\n<ol>\n<li>Browser event endpoint: <code>https:\/\/mtag.markopolo.ai\/mark<\/code><\/li>\n<li>Settings webhook endpoint: <code>https:\/\/api-alpha.markopolo.ai\/v1\/integrations\/wordpress\/webhook<\/code><\/li>\n<\/ol><\/dd>\n<dt id=\"does%20this%20store%20personal%20data%3F\"><h3>Does this store personal data?<\/h3><\/dt>\n<dd><p>It can store and transmit personal data such as name, email, phone, and search terms when those values are present in forms or interactions.<\/p><\/dd>\n<dt id=\"is%20this%20compatible%20with%20all%20themes%3F\"><h3>Is this compatible with all themes?<\/h3><\/dt>\n<dd><p>The tracking script is designed to work with standard WordPress front-end pages and common form elements.<\/p><\/dd>\n<dt id=\"will%20this%20slow%20down%20my%20site%3F\"><h3>Will this slow down my site?<\/h3><\/dt>\n<dd><p>The plugin sends events asynchronously and only loads its tracking script when it is needed.<\/p><\/dd>\n<dt id=\"how%20do%20i%20test%20it%3F\"><h3>How do I test it?<\/h3><\/dt>\n<dd><ol>\n<li>Open your site in a browser.<\/li>\n<li>Open DevTools and go to the Network tab.<\/li>\n<li>Trigger a page view, click, or form interaction.<\/li>\n<li>Look for the outgoing tracking request to the Markopolo endpoint.<\/li>\n<\/ol><\/dd>\n<dt id=\"does%20the%20plugin%20send%20data%20on%20tag%20id%20changes%20or%20uninstall%3F\"><h3>Does the plugin send data on Tag ID changes or uninstall?<\/h3><\/dt>\n<dd><p>Yes, with conditions. The plugin sends webhook events for Tag ID set\/update\/removal and plugin uninstall only after explicit admin opt-in via <strong>Enable Tracking<\/strong>. Uninstall webhooks are only sent when tracking is enabled and a Tag ID is configured.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Page view tracking<\/li>\n<li>Click tracking<\/li>\n<li>Form interaction tracking<\/li>\n<li>Search tracking<\/li>\n<li>Session and visitor identifier support<\/li>\n<li>Settings page for Tag ID configuration<\/li>\n<\/ul>","raw_excerpt":"Track WordPress events and send them to the Markopolo AI analytics platform.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/321875","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=321875"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cgzirim"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=321875"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=321875"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=321875"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=321875"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=321875"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=321875"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}