The Cometly base code pixel automatically tracks the source of webpage visitors and automatically captures information from form opt-ins (first name, last name, email, and phone number). To begin, place the Cometly Pixel on every website or domain you want to track, including your main domain, subdomains, and any additional domains.
This pixel must be placed in the <head> section of every website that you want to track. This includes your main domain (e.g., cometly.com) and subdomains (go.cometly.com, blog.cometly.com, academy.cometly.com, etc.).
If you are a SaaS company, please visit our SaaS Pixel Implementation Guide.
Install Cometly Pixel
Visit the Space Setup page and click Install & Verify Cometly Pixel.
In Step 1, Install Cometly tracking script on your site, click Copy Code to copy the Cometly Pixel and add to in the <head> section of your website(s).
Test & Verify Pixel Installation
In Step 2, under Add and verify domains, you will add your domains where you have the Cometly Pixel installed on and verify the pixel has been installed.
Enter your domain. Learn how to ensure you are using the correct domain URL:
Open your website in a browser.
Check if your domain includes "www." when the page loads.
Click Add Domain
After your domains have been added, click < > Test Script
You will see a pop up open that says "The verification process will open your website in a pop-up window to begin the process. Please do not close the pop-up window until the test is finished. We'll update you with the results as soon as the verification process is finished, this normally only takes a few seconds."
It is optional to test a specific page URL. This is typically used for SaaS companies that are only adding the Cometly Pixel to the login and registration page only. You may enter a specific URL to only test that specific page URL.
Click Confirm to test your domain to ensure the Cometly Pixel is installed.
In the Added domains section, you will either see Verified or Failed.
Verified indicates your domain has the Cometly Pixel installed correctly.
Failed indicates your domain does not have the Cometly Pixel installed correctly.
Verifying App Domains (For SaaS)
When verifying a domain that’s an app domain (like app.cometly.com), the system expects you to specify the path of the page you land on after logging in.
If you’re already logged in and the verification link takes you directly to https://app.cometly.com/dashboard, but you only enter app.cometly.com in the verification flow without the path, the system can’t match the redirect — so the verification fails.
How to Fix It
In the domain verification input box, you need to enter the path you land on after login.
Example:
You’re verifying
app.cometly.comAfter clicking the verification link, it redirects you to
https://app.cometly.com/dashboardIn the verification box, enter:
dashboard(just the path, not the full URL)Then click Confirm
This tells the system exactly where you landed, allowing it to complete the verification.
Troubleshooting Failed Domain Verification
You can refer to the troubleshooting section below or visit our Cometly Pixel Troubleshooting Guides for additional assistance.
Automatic Cross Domain Tracking
(Required For SaaS Companies)
Example: If traffic flows from cometly.com to app.cometly.com, cross-domain tracking ensures users are properly tracked across both domains.
Ensure seamless tracking for users navigating across your main domain, subdomains, or other domains by enabling Automatic Cross-Domain Tracking. This feature ensures proper handling of cross-domain traffic, allowing all user activities to be accurately tracked, regardless of the domain they interact with. Once enabled, your verified domains will automatically leverage the comet_token for precise and reliable tracking.
To enable, simply toggle on Automatic Cross Domain Tracking.
You have two options for setting up Cross-Domain Tracking with Cometly:
Automatic setup (Recommended)
(Additional Resource) Use the Cometly Pixel Helper (Google Chrome Plugin)
The Cometly Pixel Helper is a Chrome Browser extension that will help you ensure that you have correctly installed Cometly on your website.
The plugin will assist you with 2 things:
Check for errors in your base code pixel installation.
Identify the Cometly events loading on your page and verify the Cometly base code is automatically capturing data on your opt in forms.
➡️ Learn how to install the Cometly Pixel Helper Troubleshooting Common Pixel Installation Issues When installing and verifying the Cometly pixel, you may encounter common issues that prevent proper tracking. Below are solutions to frequently encountered problems. Common Issues and Their Solutions
1. The Installation and Verification Page Loads Blank
If the page for installing and verifying the Cometly pixel appears blank, it's typically a browser-related issue. Follow these steps to resolve it:
Clear your browser cache and cookies.
For Chrome users, you can refer to this video guide to learn how to clear cache and cookies for app.cometly.com. Make sure to refresh the page after performing these actions to confirm the issue is resolved.
2. Incorrect Pixel Script on Your Website
If the pixel script on your website is incorrect, tracking and integration won't function properly. To fix this:
Replace the incorrect pixel script on your website with the correct one from your Space Setup page.
Ensure the script is placed in the <head> section of your website's code, following Cometly's installation guidelines. Example of a correct pixel script format:
<script src="https://t.cometlytrack.com/e?uid=[your-unique-identifier]"></script>
Addressing pixel-related issues in Cometly typically involves resolving browser caching errors or ensuring the pixel script is correctly installed. By following these steps, you can ensure your tracking works as intended. If issues persist after trying these solutions, please contact Cometly support for further assistance.