Website Integration

12. Dec, 2020

Add Pirsch to Your Website

Once you have created an account, you can add Pirsch to your website.

open the dashboard and click on Add Domain in the menu
enter the hostname of your website (like example.com) and chose a subdomain you would like to use for the Pirsch dashboard
click on Add Domain
copy the JavaScript snippet on the right and add it to your websites <head> section

And you’re done! Your website will now send page hits to Pirsch. Note that only hits for the hostname you have entered will be accepted. A page hit for sub.example.com won’t be accepted for example.com. They are considered entirely different pages and you need to add a new website for all subdomains you would like to monitor. The only exception for this is www in front of your top-level domain. www.example.com for example will be accepted for example.com and the other way around.

Test the Integration

To test the script, navigate to your website and open the network tab of the developer tools in your browser (usally F12 or Ctrl/Control + Shift + I). Search for “hit” and make sure you get a 200 response code in the status column.

Developer Tools

In case you don’t, check your identification code and the domain you have configured. Should you still not see the request going through, please contact our support.

Reset the Identification Code

Your website is identified by the hostname the request is made from and an identification code. The identification code must be placed inside the JavaScript snippet. Should you ever need to recreate the code, navigate to the Settings page for your website and click on Generate a New Identification Code. This will invalidate your active code and create a new one you need to place the old one with.

1
2
3


<script type="text/javascript" src="https://api.pirsch.io/pirsch.js" 
    id="pirschjs" 
    data-code="YOUR_IDENTIFICATION_CODE"></script>