Tracking Script Installation Verification
Check if your Convert tracking script is installed correctly using visual alerts in the Active Websites section—no browser extensions needed.
IN THIS ARTICLE YOU WILL:
🔍 Overview
The Active Websites section in Convert allows automatic verification of whether the Convert tracking script is installed on each listed website. This helps users confirm proper implementation without relying on manual checks or external tools.
When you add a URL, the system attempts to access the page and detect the presence of the tracking code. A visual indicator will appear next to each URL showing whether the script was found, missing, or if the URL is not valid.
⚙️ How the Verification Works
When a website URL is entered:
- Convert loads the page using a headless browser.
- It checks for the presence of the Convert tracking code.
- A status icon appears to indicate the result.
- Additional information is provided via hover tooltips.
This ensures visibility into whether tracking is active and functioning.
🟢 Status Indicators and What They Mean
Each URL row shows one of the following visual cues:
✅ Green Checkmark
- Meaning: The Convert tracking script is successfully detected on the website.
- Tooltip: “The Convert tracking script is installed and working correctly on this website.”
⚠️ Orange Warning
- Meaning: The script could not be found on the page.
- Tooltip: “No Convert tracking script detected on this website. Install the script to track data.”
❌ Red Error Message
- Meaning: The entered URL is invalid or in an unsupported format.
- Displayed Text: “The entered URL is not valid.”
Example: Wildcard entries like https://*.domain.com are not valid for verification purposes.
🧭 How to Use It
- Go to your Project Configuration in Convert.
- Select the Active Websites section.
- Enter a fully-qualified URL (e.g., https://www.example.com).
- Observe the icon to the right of the URL.
- ✅ Green means script found.
- ⚠️ Orange means script not found.
- ❌ Red means the URL is invalid.
You can also click the refresh icon next to any URL to re-run the verification check.
🛑 Important Notes
- Only fully-qualified page URLs are supported for script verification.
- Wildcard domains (e.g., *.example.com) are allowed as inputs but cannot be verified. These will show an orange warning with no script validation.
- Sites that block headless browsers or restrict cloud IP access may not return a successful detection, even if the script is installed correctly.
URLs behind authentication walls or login screens cannot be verified.
🧰 Troubleshooting
If you're seeing the orange warning:
- Confirm the tracking code is installed in the <head> section of your page.
- Refer to this guide for correct installation steps: How to Install the Main Tag
If you're seeing a red error:
- Double-check your URL syntax.
Avoid using unsupported formats like https://*.