The Tracking Script

After you sign up for Luigi's Box, you will receive a unique tracking script. This script activates Luigi's Box services, including Analytics, Autocomplete, Search, Product Listing, and Recommender.

Example:

html

<script async src="https://scripts.luigisbox.tech/LBX-123.js"></script>

Note This script is required unless you are performing a full server-side integration via the API.

Domain Specificity

Each tracking script is unique to a specific domain. Do not use the same script across different domains. Doing so will merge data from multiple sites into a single view, making analysis difficult. If you manage multiple domains, please contact us for separate tracking scripts.

Installation

Option 1: Direct HTML Injection (Recommended)

Locate your website's main layout or header file. This file is typically responsible for the global header across all pages (e.g., header.php, theme.liquid, or head.phtml).

Paste the script tag anywhere between the opening <head> and closing </head> tags.

Example:

html

<!DOCTYPE html>
<html>
    <head>
        <script async src="https://scripts.luigisbox.tech/LBX-123.js"></script>

    </head>
    <body>
    </body>
</html>

Tip If you are using Magento or IdoSell, browse our Platform Integrations to find the specific setup guide for your store.

Option 2: Google Tag Manager (GTM)

If you cannot modify the HTML directly, you may use Google Tag Manager.

You can refer to this step-by-step guide for GTM integration.

Important We strictly recommend Option 1 instead. Using GTM has two major downsides:

Adblockers: Many adblockers block GTM entirely. If you load Luigi's Box via GTM, our services will not load for users with adblockers enabled.
Performance: Loading via GTM introduces latency, which may cause advanced features (such as Fixit rules) to execute more slowly.

Content Security Policy (CSP)

If your website enforces a Content Security Policy, add the following rules to allow Luigi's Box services to communicate with your site:

CSP Directive	Required Values
`connect-src`	`https://api.luigisbox.com` `https://live.luigisbox.com` `https://app.luigisbox.tech`
`script-src`	`https://scripts.luigisbox.tech` `https://cdn.luigisbox.tech`
`style-src`	`https://cdn.luigisbox.tech`

Navigation