Introduction
Google Tag Manager (GTM) is a powerful tag management system (TMS) that allows for easy and quick updates of code fragments (tags) on your website or mobile application.
Why Choose GTM?
GTM offers several advantages:
Easily add and modify tags for conversion tracking, site analytics, and remarketing.
Flexible tracking across various websites and apps.
Intuitive design for straightforward tag management.
Steps to Integrate Marker.io with GTM
Ensure you have an active GTM account by following the latest guidelines: Set up and install Tag Manager.
Log into your Google Tag Manager account and select the container associated with the site where you'd like to install Marker.io.
Select New Tag
Give your tag a name, and within Tag configuration, select Custom HTML.
Copy your widget code from app.marker.io into the custom HTML.
Under Triggering, select All Pages.
Save, submit, and publish your Tag.
Google Tag Manager Troubleshooting
Using GTM can sometimes introduce challenges. Here’s a detailed guide to help troubleshoot and resolve issues that may arise during your Marker.io integration.
1. Basic Checks
Verify the Marker.io Script
Double-check that the correct Marker.io widget code has been pasted into the Custom HTML section in GTM.Check GTM Installation
Ensure the GTM container code is correctly installed across all pages on your website, usually within the<head>section and as close to the opening tag as possible.
2. Use GTM Preview Mode
Preview mode is an essential tool for testing and troubleshooting tags before they go live.
Enable Preview Mode:
Click Preview in the GTM interface.Navigate to Your Site:
This will open a debug pane at the bottom of your site where you can see which tags are firing and any associated errors.Check Tag Firing Status:
In the GTM debug pane, ensure that the Marker.io tag is firing on the correct pages. If it’s not firing, there may be an issue with the tag setup or trigger configuration.
3. Tag Configuration Issues
Confirm Trigger Accuracy
If the Marker.io tag is set to fire on all pages, ensure this is specified under Triggering. If you have specific page triggers, verify that they’re correctly configured and match the intended page URLs or conditions.Check for Conflicting Tags
Conflicts with other tags, especially those loading JavaScript, can sometimes prevent the Marker.io script from executing. Try disabling other tags one by one in Preview mode to isolate any conflicting tag.
4. Trigger Settings Troubleshooting
If you’re using specific triggers, make sure they’re neither too restrictive nor incorrectly configured:
Trigger Scope:
Ensure the scope of your triggers is appropriate. For example, if you intend for Marker.io to load on a specific page or section, verify that the conditions match precisely.Examine Custom Events and Variables:
If you’re using custom events or variables as triggers, make sure they’re set up and fired correctly within GTM.
5. Clear Cache & Browser Testing
Caching issues or browser settings can sometimes prevent new tags from firing correctly:
Clear Browser Cache:
Clear your browser’s cache or use an Incognito/Private window to bypass caching and cookies.Test Across Browsers:
Browser extensions, settings, or even specific versions can interfere with GTM tags. Testing across multiple browsers (Chrome, Firefox, Safari) can help identify browser-specific issues.
6. Identify JavaScript Errors
JavaScript errors can prevent the Marker.io script from loading properly:
Use Developer Tools:
Right-click on the webpage, select Inspect, and go to the Console tab.
Look for any errors in red. Errors here may provide clues about incompatible scripts or issues with the Marker.io code.
7. Verify Script Source and Version
Ensure the Latest Script Version:
Using an outdated version of the Marker.io script could cause issues. Check for updates or announcements from Marker.io to make sure your widget code is up-to-date.
8. Platform-Specific Considerations
Some CMS platforms (e.g., WordPress, Shopify) may have specific settings that could interfere with GTM or custom JavaScript. Check the GTM or Marker.io documentation for any platform-specific guidance, or consult forums if you’re unsure.
9. Review GTM Settings for Blocking Rules
Check Blocking Triggers or Exceptions:
In GTM, blocking triggers or exceptions can prevent tags from firing. Go through each rule and verify that none are unintentionally blocking the Marker.io tag.Examine Tag Firing Sequence:
Occasionally, the order in which tags fire can impact functionality. If the Marker.io script depends on other tags, ensure they load in the correct sequence by setting priority rules.
10. Seek Additional Support
If you’ve exhausted these troubleshooting steps and still encounter issues:
GTM Community and Support:
Google’s Tag Manager Help Community is also a valuable resource for troubleshooting specific GTM issues.Marker.io Support:
Contact Marker.io support through the chat option on the bottom right of any Marker.io page.