In this guide, you’ll learn how to use the built-in diagnostics tool to verify your installation and detect any missing scripts or configuration issues.
🔍 What to do
🔍 What to do
Use the Diagnostics Tool to scan a webpage and verify that the tracking pixel and scripts have been correctly installed and are detectable.
🌟 Why it matters
🌟 Why it matters
A correct installation is essential for Search Atlas to collect accurate data, power analytics, and activate campaign features. The diagnostics tool helps you catch missing or misconfigured scripts before going live.
🛠️ How to do it
🛠️ How to do it
Open the Diagnostics Tool
You can access it from three places:In the Installation Guide, under the Check Installation section
From the Auto Overview Page, using the Run Diagnostics button
In the Auto Sidebar, by selecting Diagnostics Tool
Enter the URL of the page you want to check
Open the webpage where the tracking pixel was installed
Copy the full URL (e.g.,
https://www.example.com/pricing)Paste it into the field labeled
Enter a URL
Click “Run Diagnostics”
The tool will begin scanning the page for the pixel and scripts
Wait 20–30 seconds for the scan to complete
Review the results
The tool will show one of the following:✅ Pixel detected and installed correctly
⚠️ Partial installation (some elements missing)
❌ No installation detected
If issues are found, the tool will outline what’s missing or misconfigured
(Optional) View your last scan
Use the View Last Report option to revisit your most recent diagnostic
This is useful when checking fixes or comparing across pages
⚠️ Common mistakes to avoid
⚠️ Common mistakes to avoid
❌ Testing a page where the pixel hasn’t been installed yet
❌ Pasting a staging or non-production URL instead of a live page
❌ Skipping the diagnostics scan before launching campaigns
❌ Misinterpreting “partial install” as full success
❌ Re-running scans unnecessarily without changes
❌ Assuming one scan covers all pages or subdomains
🧠 Interpretation Tips
🧠 Interpretation Tips
💡 Complementary Tips for Using the Diagnostics Tool
🏠 Start with the Homepage
🏠 Start with the Homepage
After the homepage, scan high-value pages like /checkout, /pricing, or landing pages. This ensures tracking continuity across the funnel.
🔄 Check for Caching Delays
🔄 Check for Caching Delays
If the scan doesn’t detect the pixel but you’ve recently added it, try the following:
Open the page in Incognito Mode
Clear your browser cache
Wait a few minutes if your site uses a CDN or caching plugin
🧩 Understand Partial Installs
🧩 Understand Partial Installs
A partial installation usually means:
The pixel script is present but missing parameters or event triggers
The base script is loaded, but dynamic optimization attributes are missing
Use this as a signal to re-check your installation and setup logic.
🌐 Cross-check Subdomains
🌐 Cross-check Subdomains
If you're running Search Atlas across multiple subdomains (e.g., www.example.com and app.example.com), scan each one separately. Each may require its own pixel setup or adjusted script path.
📄 Re-use the Last Report Smartly
📄 Re-use the Last Report Smartly
Don’t re-run a scan unless something changed. Use the View Last Report feature to validate work-in-progress or confirm a stable install.
🗂️ Save Reports for QA
🗂️ Save Reports for QA
Working with developers or stakeholders? Screenshot or copy the scan output. It provides a clear status snapshot and speeds up debugging and collaboration.
💡 Pro Tip
💡 Pro Tip
Use the diagnostics tool every time you add Search Atlas to a new site, page, or subdomain. It only takes 30 seconds and can save hours of debugging.
✅ Once done
You’ll know whether the tracking pixel is live and working as expected. If the tool flags issues, follow the instructions provided or consult the Help Center for fixes.
📚 Useful Official Resources