How to install the Zoho PageSense snippet code in a website | Help Guide.

Manually install the snippet on your website

To start tracking visitor behavior and run experiments on your website, you must install the Zoho PageSense snippet.
The snippet is a small piece of JavaScript code that enables PageSense to collect visitor data, run experiments, and deliver personalized experiences on your website.
NotesNote : This is a one-time setup. Once installed, the same snippet will automatically work for all experiments within the selected website/project.
Before You Begin
Make sure you have:
  • Access to your website’s HTML source code
  • Permission to edit the <head> section of your website
  • The correct PageSense website/project selected
Each website/project in PageSense has a unique snippet, so ensure you are using the correct one.

Access the Snippet

  1. Log in to your Zoho PageSense account
  2. Navigate to Settings
The Snippet section under Website settings in Zoho PageSense allows you to install and manage the PageSense tracking code on your website. Installing this snippet is the first and most important step to begin collecting visitor behavior data and running optimization experiments on your site.



Once the snippet is added to your website, PageSense starts tracking visitor interactions such as clicks, scrolls, page visits, conversions, and other behavioral metrics. This data is used across PageSense features including A/B testing, Split URL testing, Personalization, Heatmaps, Funnels, Form Analytics, and Goals.
Installing the snippet correctly ensures that PageSense can track visitors consistently and provide accurate analytics and experimentation results

Choose the Right Snippet Type

PageSense provides three types of snippets. Choosing the right one is important for performance and experiment accuracy.
Synchronous Code
Asynchronous Code
Smart Code (Recommended)
Synchronous Code
Synchronous code loads scripts in sequence from the <head> section.



  • Ensures controlled execution order
  • More stable for certain environments
  • Slightly impacts page load speed
 Best for:
Cases where strict script execution order is required
Example: If your website depends on sequential script loading, synchronous code ensures PageSense runs in the correct order.

Asynchronous Code
Asynchronous code loads alongside other scripts on the page.



  • Faster loading alongside other resources
  • Does not block page rendering
  • May cause flickering in experiments
Best for:
Basic tracking use cases (not recommended for experiments)
Example: Suitable if you only want to track visitor data without running A/B tests or personalization.

Smart Code (Recommended)
Smart Code is the most advanced and recommended snippet type.



  • Automatically optimizes script loading
  • Reduces page flickering during experiments
  • Improves page rendering performance
  • Ensures smoother A/B testing and personalization
Best for:
A/B Testing, Split URL Testing, Personalization, and overall performance optimization
Example: When running a personalization campaign, Smart Code ensures users directly see the personalized version without a visible flicker from the original page.


Idea
Use Smart Code for the best balance of performance, accuracy, and user experience.

Warning
Paste the PageSense snippet code right below the <head> tag of your website. This will allow the code to run immediately without any delay, as and when any changes are made in your site.
Here's how the PageSense snippet code might look like on your web page script.
Notes
Note:
Notes

  • Please note that when embedding the snippet, it’s crucial not to modify or minify the code to ensure proper functionality.

  • Multiple tests can be performed with the same snippet installed on your web page. However, the snippet will be unique for each project in PageSense.

  • If you want to run an experiment from a different PageSense user account, the existing snippet needs to be removed from your website pages, and replaced with the new code generated from the current PageSense account because the snippet for each project is unique. 

Verify Snippet Installation

After adding the snippet, verify if it is correctly installed:
  1. Go to the Verify Installation section
  2. Enter your website URL
  3. Click Verify
Verification Result
  • Success Message (Green Tick): Snippet installed correctly and tracking is active.
Note - In some cases, verification may not appear if the page takes too long to load, but tracking may still work in the backend.
        
  • Error Message: Indicates an issue with installation



Info
If you see an error message in red, it could be due to any of the following reasons:

  • You've pasted a different snippet on your webpage's HTML code.

  • There are typographical mistakes in the code.

  • Your web page takes longer than 10seconds to load than usual.

  • You're trying to add the snippet multiple times to your webpage's HTML.

Troubleshooting Verification Issues
If verification fails, check the following:
  • Incorrect or incomplete snippet added
  • Typographical errors in the code
  • Snippet added multiple times
  • Page load time exceeding 10 seconds
The verification message will not show up in your browser window, if and when your web page loads for more than 10 seconds. However, in such instances, the PageSense snippet status will be successful at the back-end and be ready to track visitors' data on your website. You can verify the presence of the snippet by following the below steps:

Alternative Verification Method

If the verification tool does not confirm installation:
  1. Copy the Project Key from Settings
  2. Open your website
  3. Right-click → Inspect
  4. Go to the Network tab
  5. Paste the Project Key in the filter
  6. Refresh the page


If the script appears, the snippet is successfully installed.
Once the snippet is installed, PageSense begins tracking visitor data using cookies.
It is recommended to:
  • Enable a cookie consent banner
  • Inform users about tracking and personalization 


This helps ensure compliance with privacy regulations.

Additional Installation Options

Google Tag Manager (GTM)
You can install the snippet using GTM instead of editing your website code.
Example: Add the PageSense snippet as a custom HTML tag in GTM and trigger it on all pages.











We’ve designed this documentation to guide you every step of the way. If you need further assistance or have any questions, don’t hesitate to contact us at support@zohopagesense.com - we’re always here to help!