Configuration Options

Customize the tracking pixel behavior using data attributes on the script tag.

Available Attributes

Attribute	Required	Default	Description
data-tid	Yes	-	Your unique tracking ID from the dashboard
data-spa	No	false	Enable Single Page Application navigation tracking
data-debug	No	false	Enable console debug logs for troubleshooting
data-dnt	No	false	Respect the browser's Do Not Track setting

data-tid (Required)

Your unique tracking ID that identifies your website. You can find this in your dashboard after adding your website.

<script 
  src="https://www.aisearchindex.com/pixel.js" 
  data-tid="t_abc123xyz789"
  async
></script>
<noscript><img src="https://www.aisearchindex.com/api/pixel?tid=t_abc123xyz789" width="1" height="1" style="position:absolute;left:-9999px;visibility:hidden" alt="" /></noscript>

data-spa

Enable this for Single Page Applications (React, Vue, Next.js, etc.) to automatically track client-side navigation. When enabled, the pixel listens for pushState, replaceState, and popstate events.

<script 
  src="https://www.aisearchindex.com/pixel.js" 
  data-tid="YOUR_TRACKING_ID"
  data-spa="true"
  async
></script>
<noscript><img src="https://www.aisearchindex.com/api/pixel?tid=YOUR_TRACKING_ID" width="1" height="1" style="position:absolute;left:-9999px;visibility:hidden" alt="" /></noscript>

Tip: Enable SPA mode for any JavaScript framework that uses client-side routing.

data-debug

Enable debug mode to see detailed logs in your browser's Developer Tools console. This is useful for verifying the installation and troubleshooting issues.

<script 
  src="https://www.aisearchindex.com/pixel.js" 
  data-tid="YOUR_TRACKING_ID"
  data-debug="true"
  async
></script>
<noscript><img src="https://www.aisearchindex.com/api/pixel?tid=YOUR_TRACKING_ID" width="1" height="1" style="position:absolute;left:-9999px;visibility:hidden" alt="" /></noscript>

Note: Remember to disable debug mode in production to avoid unnecessary console output.

data-dnt

When enabled, the pixel will check the browser's Do Not Track setting. If DNT is enabled by the user, no tracking will occur.

<script 
  src="https://www.aisearchindex.com/pixel.js" 
  data-tid="YOUR_TRACKING_ID"
  data-dnt="true"
  async
></script>
<noscript><img src="https://www.aisearchindex.com/api/pixel?tid=YOUR_TRACKING_ID" width="1" height="1" style="position:absolute;left:-9999px;visibility:hidden" alt="" /></noscript>

Complete Example

Here's an example with all options enabled:

Full configuration example

<script 
  src="https://www.aisearchindex.com/pixel.js" 
  data-tid="t_abc123xyz789"
  data-spa="true"
  data-debug="false"
  data-dnt="true"
  async
></script>
<noscript><img src="https://www.aisearchindex.com/api/pixel?tid=t_abc123xyz789" width="1" height="1" style="position:absolute;left:-9999px;visibility:hidden" alt="" /></noscript>

Next Steps

Learn how to integrate the tracking pixel with your specific framework.

View Framework Guides