> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1eye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Vision Pixel

> Learn how to install the 1eye Vision pixel, add tracked domains, track important forms, verify installation, and troubleshoot signal capture.

The Vision pixel is a small JavaScript tag that runs on your website. Once installed, it helps 1eyeᴬᴵ capture page visits, traffic source, UTM data, form activity, session activity, and visitor signals from buyers.

## Before you begin

To install the Vision pixel, you need:

* Access to your 1eyeᴬᴵ workspace
* Admin access to your website, CMS, or tag manager
* Permission to add JavaScript to your website
* Your company domain added to your 1eyeᴬᴵ workspace

For this guide, we'll use Snowbricks as the example workspace.

| Field           | Example                                         |
| --------------- | ----------------------------------------------- |
| Company         | Snowbricks                                      |
| Domain          | snowbricks.io                                   |
| Workspace admin | Matt Bru                                        |
| Admin email     | [matt@snowbricks.io](mailto:matt@snowbricks.io) |

## Where to find the Vision Pixel

<img src="https://mintlify.s3.us-west-1.amazonaws.com/1eye/images##-Where-to-find-the-Vision-Pixel.png" alt="## Where To Find The Vision Pixel" />

You can access the Vision Pixel in two places.

**During onboarding** — When you first create your workspace, 1eyeᴬᴵ will guide you through the Vision setup step. Look for "Install 1eye Vision." Before the Vision pixel is installed, the status will show `Not Installed`.

**Inside Settings** — You can also access the Vision pixel anytime from your workspace settings: open your 1eyeᴬᴵ workspace, select Workspace Settings from the left-hand nav, open the Vision pixel tab, copy your Vision pixel, and manage included domains. This is useful if you skipped onboarding, need to reinstall the pixel, or want to add more domains later.

## What the Vision pixel does

The 1eye Vision pixel helps 1eyeᴬᴵ understand activity on your website. Once installed, 1eyeᴬᴵ can capture signals such as:

* Website visits
* Page views
* Session activity
* Traffic source
* UTM parameters
* Form activity
* Contact-level identification when available
* Buyer activity

These signals help your team understand which buyers are active, what pages they viewed, where they came from, and what GTM action to take next.

## Step 1: Open the Vision setup screen

From onboarding or Workspace Settings, open Vision pixel. You should see your 1eye Vision pixel, installation status, and included domains. If the pixel has not been installed yet, the status will show `Not Installed`. If the pixel has been detected, the status will show `Installed`.

## Step 2: Confirm your domain

Before installing the pixel, confirm that your domain is included. For Snowbricks, the domain should be `https://snowbricks.io`. If your website uses www, include `https://www.snowbricks.io`. If your website uses both root and www, make sure both are covered or that one redirects cleanly to the other.

## Step 3: Add included domains

Included domains tell 1eyeᴬᴵ where the Vision pixel is allowed to track activity. For Snowbricks, you may add `https://snowbricks.io`, `https://www.snowbricks.io`, and, if Snowbricks has marketing landing pages on a subdomain, `https://go.snowbricks.io`. Only add domains that belong to your company and should be tracked by 1eyeᴬᴵ.

## Step 4: Copy your Vision pixel

In the Vision pixel tab, find the code block labeled "1eye Vision pixel." Click Copy to copy the full pixel. Your pixel will look similar to this:

```html theme={null}
<script>
  (function() {
    var s = document.createElement("script");
    s.src = "https://vision.1eye.ai/pixel.js";
    s.setAttribute("data-client-id", "YOUR_CLIENT_ID");
    s.defer = true;
    document.head.appendChild(s);
  })();
</script>
```

Use the exact pixel from your own 1eyeᴬᴵ workspace. Do not copy the sample vision pixel above into production.

## Step 5: Choose your installation method

You can install the Vision pixel in either of these ways:

* Add the script directly inside the `<head>` tag of your website
* Add it using a Custom HTML tag in Google Tag Manager

Use the direct `<head>` method if you control your website code, CMS, or website builder. Use Google Tag Manager if your team manages website scripts through GTM.

### Option 1: Install directly in the website `<head>`

Use this option if your website is built on Framer, Webflow, WordPress, custom code, or another CMS that lets you add custom code to the site header.

Instructions:

1. Open your website builder, CMS, or codebase
2. Go to the global custom code or site header settings
3. Paste the full 1eye Vision Pixel snippet before the closing `</head>` tag
4. Save your changes
5. Publish or deploy your website
6. Return to 1eyeᴬᴵ and test the installation

The vision pixel should be installed globally so it loads on every important marketing page.

Where to place the Vision Pixel snippet:

```html theme={null}
<head>
  <!-- Other scripts and metadata -->

  <script>
    (function() {
      var s = document.createElement("script");
      s.src = "https://vision.1eye.ai/pixel.js";
      s.setAttribute("data-client-id", "YOUR_CLIENT_ID");
      s.defer = true;
      document.head.appendChild(s);
    })();
  </script>
</head>
```

### Option 2: Install using Google Tag Manager

Use this option if your company manages website scripts through Google Tag Manager.

Instructions:

1. Open Google Tag Manager
2. Select the container for your website
3. Click Tags
4. Click New
5. Name the tag "1eye Vision"
6. Choose Tag Configuration
7. Select Custom HTML
8. Paste your full 1eye Vision Pixel snippet
9. Under Triggering, choose All Pages
10. Save the tag
11. Submit and publish the GTM container
12. Return to 1eyeᴬᴵ and test the installation

Recommended GTM trigger: **All Pages** — this ensures 1eyeᴬᴵ can capture activity across your website, not just one landing page. Only use a limited trigger if you intentionally want Vision to run on specific pages; for most teams, All Pages is the right default.

## Step 6: Test the installation

After installing the Vision Pixel snippet, return to 1eyeᴬᴵ and test the installation. 1eyeᴬᴵ will check whether the Vision pixel is loading on your website. If the Vision Pixel is detected, the status should change from `Not Installed` to `Installed`. You should also see a confirmation message that your 1eye Vision pixel is installed and tracking signals. If the status does not update immediately, wait a few minutes and test again.

## Step 7: Watch for confirmation

<img src="https://mintlify.s3.us-west-1.amazonaws.com/1eye/images##-Where-to-find-the-Vision-Pixel---installed.png" alt="## Where To Find The Vision Pixel Installed" />

Once the Vision pixel is installed successfully, 1eyeᴬᴵ will confirm that tracking is active. You may see:

* The Vision status change to Installed
* A confirmation message inside the setup screen
* A completed onboarding step
* An email notification confirming that Vision is installed
* Website signals begin flowing into your workspace

After confirmation, select Get Started to continue into your workspace.

## Step 8: Generate your first signal

After the Vision Pixel snippet is installed, open your website in a new browser tab. Visit a few important pages, such as Homepage, Pricing page, Product page, Contact page, and Demo page. For Snowbricks, that could include:

* [https://snowbricks.io](https://snowbricks.io)
* [https://snowbricks.io/pricing](https://snowbricks.io/pricing)
* [https://snowbricks.io/product](https://snowbricks.io/product)
* [https://snowbricks.io/contact](https://snowbricks.io/contact)
* [https://snowbricks.io/demo](https://snowbricks.io/demo)

Then return to 1eyeᴬᴵ and open Signals. You should start seeing website activity after 1eyeᴬᴵ receives and processes the first events.

## What to expect after installation

Once Vision Pixel is installed, 1eyeᴬᴵ can begin capturing website signals. You may see anonymous website activity, identified buyers, page-level activity, source and UTM data, form-related activity, recent website visitors, and buyer timelines. Not every website visitor will be identified — identification depends on available signal data, enrichment match, source quality, and visitor context.

## Add multiple domains

You can add more than one included domain in Workspace Settings. Use this when your company uses multiple websites, subdomains, or landing page domains. For Snowbricks, examples could include:

* [https://snowbricks.io](https://snowbricks.io)
* [https://www.snowbricks.io](https://www.snowbricks.io)
* [https://go.snowbricks.io](https://go.snowbricks.io)
* [https://resources.snowbricks.io](https://resources.snowbricks.io)

Add a domain if 1eyeᴬᴵ should track website activity there. Do not add domains that are unrelated to your company or domains where you do not want tracking to run.

## Manage form tracking

Which pages count as high-intent form submissions is configured from your Knowledge Base's Target Forms tab, alongside your ICPs, personas, and Target Pages — not from the Vision Pixel settings screen. See Knowledge Base for how to mark which pages contain forms that matter for GTM.

## Recommended pages to track

Install the Vision pixel on all important GTM pages, including: Homepage, Product pages, Pricing page, Demo page, Contact page, Blog pages, Case study pages, Comparison pages, Landing pages, Campaign pages, Webinar pages, Gated content pages. The more complete your coverage, the better 1eyeᴬᴵ can understand target activity.

## UTM tracking

1eye Vision can capture UTM parameters when they are present in the URL. Common UTM parameters include:

| Parameter     | Example                   | What it tells you                    |
| ------------- | ------------------------- | ------------------------------------ |
| utm\_source   | linkedin                  | Where the traffic came from          |
| utm\_medium   | paid\_social              | The channel or medium                |
| utm\_campaign | q2\_pipeline\_push        | The campaign name                    |
| utm\_content  | founder\_ad\_v1           | The ad, creative, or content variant |
| utm\_term     | cloud\_cost\_optimization | The keyword or audience term         |

This helps your team understand which campaigns are driving buyer activity. For example, if a buyer visits Snowbricks from a LinkedIn campaign, 1eyeᴬᴵ can help your team connect the signal back to the source.

## Privacy and compliance

Before installing any tracking script, review your website privacy policy and cookie practices with your legal or compliance team. Your privacy policy should explain that your website may use analytics, tracking, enrichment, and similar technologies to understand website activity and improve sales, marketing, and customer experiences. You may also need to update your cookie banner or consent management platform depending on your company's policies and the regions where you operate.

### Action items for your team

Installing the Vision pixel is a data collection change, not just a script install. Work through this checklist with whoever owns privacy, legal, or compliance at your company before you turn tracking on broadly:

* **Update your privacy policy** — Add or confirm language describing the use of analytics, visitor identification, and enrichment technologies — for example, "we use tools that may identify the companies and individuals visiting our website for sales and marketing purposes."
* **Review your cookie banner or consent management platform (CMP)** — If your site uses a CMP such as OneTrust, Cookiebot, or Osano, add the 1eye Vision pixel as a tracked script and categorize it, typically under Analytics or Marketing/Advertising.
* **Decide when the pixel should fire** — Some companies load the pixel on page view; others gate it behind consent. Confirm which approach matches your company's policy and the regions you operate in, such as GDPR in the EU/UK or CCPA/CPRA in California.
* **Scope form tracking intentionally** — Only track forms where a submission is meant to identify a business contact for GTM purposes, such as demo, contact, trial, or newsletter pages. Set this up from your Knowledge Base's Target Forms tab, and don't track forms that collect sensitive personal data unrelated to sales or marketing.
* **Confirm data retention and access** — Check who inside your workspace can view identified contacts, and how long that data should be retained under your internal policy.
* **Loop in legal before multi-region launches** — If your website is visited from the EU, UK, or other regions with visitor-identification rules, have legal confirm the pixel's use is covered before enabling it site-wide.
* **Keep a record of the decision** — Note who approved the installation, when, and under which privacy policy version, so you have a reference if the setup is reviewed later.

1eyeᴬᴵ provides the tracking technology, but your company is responsible for how it is disclosed to visitors and used in compliance with applicable laws. If you're unsure how these requirements apply to your business, consult your legal counsel before installing the pixel broadly.

## Troubleshooting

**Installation still says "Not Installed"** — Check the following: confirm the snippet was copied from the correct 1eyeᴬᴵ workspace; confirm the snippet was added to the correct domain; confirm the website was published or deployed after adding the snippet; confirm the snippet is inside the `<head>` or loaded through GTM; confirm Google Tag Manager was published, not just saved; refresh the website and test again; wait a few minutes and retry the installation test.

**Vision Pixel Snippet is installed but no signals appear** — Check the following: visit the website after installation to generate a test event; open multiple pages, not just the homepage; confirm the domain in 1eyeᴬᴵ matches your live website domain; confirm the domain is listed under included domains; confirm the snippet is not blocked by a browser extension, consent banner, or Content Security Policy; confirm the page is publicly accessible; confirm the snippet is not only installed on a staging site.

**Installed on root domain but not www** — Some websites use both `https://snowbricks.io` and `https://www.snowbricks.io`. If your website uses www, make sure the snippet is installed on the www version. If your website redirects root to www, test the final destination URL.

**Installed on staging instead of production** — Check whether the snippet was added to a staging or preview environment instead of your live website (e.g. `staging.snowbricks.io`, `preview.snowbricks.io`, `snowbricks.framer.app`, `snowbricks.webflow.io`). For production tracking, install Vision on `https://snowbricks.io` or `https://www.snowbricks.io`.

**Google Tag Manager tag is saved but not live** — In Google Tag Manager, saving a tag is not enough. You must save the tag, submit the container, publish the container, refresh your website, and test the installation again in 1eyeᴬᴵ.

**Script is blocked by Content Security Policy** — Some websites use a Content Security Policy that blocks third-party scripts. If Vision pixel is blocked, ask your engineering team to allow scripts from `https://vision.1eye.ai`. Your engineering team may need to update the script-src directive in your CSP.

**Script is blocked by consent settings** — If your website uses a cookie banner or consent management platform, the Vision pixel may not load until a visitor gives consent. Check whether the snippet is categorized as analytics, marketing, or tracking. If your policy requires consent, make sure the tag fires only after the right consent event.

**Browser extensions block the script** — Ad blockers, privacy extensions, and corporate security tools can block tracking scripts. To test cleanly: open your website in an incognito window, disable browser extensions, try another browser, ask another teammate to visit the site, or test from a non-corporate network if needed.

**Vision Pixel Snippet appears twice** — Avoid installing the Vision pixel script more than once. Duplicate installation can happen if the snippet is installed directly in the website header and also through Google Tag Manager, added inside a reusable page component, or added by both marketing and engineering teams. Keep one clean installation path.

**Signals only show on some pages** — This usually means the Vision Pixel is not installed globally. Check whether the snippet was added only to one landing page, one template, one route, one CMS collection, or one GTM trigger. For full coverage, install Vision across all important website pages.

**Form activity is not showing** — Check the following: confirm the Vision pixel snippet is installed on the form page; confirm the form page is added under Target Forms in your Knowledge Base; confirm the form is publicly accessible; confirm the form is not blocked by consent settings; submit a test form and wait a few minutes; check Signals again.

### How to verify manually

You can manually check whether the Vision script is loading.

**In your browser:** Open your website, right-click the page, select Inspect, open the Network tab, refresh the page, and search for `vision.1eye.ai`. If the script appears in the Network tab, it is loading.

**In page source:** Open your website, right-click the page, select View Page Source, and search for `vision.1eye.ai`. If the Vision pixel snippet was injected dynamically through Google Tag Manager, it may not appear in page source — use the Network tab instead.

### Send instructions to a teammate

If someone else manages your website, select "Send instructions via email" from the Vision setup screen. Send the instructions to the teammate, agency, or engineer who manages your website. A good internal note looks like this:

> Hi Matt,
>
> Can you install the 1eye Vision snippet on snowbricks.io? Please add it before the closing `</head>` tag across the full website, or install it through Google Tag Manager as a Custom HTML tag with an All Pages trigger.
>
> Once it is published, I'll test the installation in 1eyeᴬᴵ. Thanks

## Best practices

* **Install Vision globally** — Add the vision pixel across your full marketing website so 1eyeᴬᴵ can capture complete target activity.
* **Use one installation method** — Install directly in the `<head>` or through Google Tag Manager. Do not use both.
* **Install on production** — Make sure the Vision Pixel snippet is installed on your live company domain, not only on a staging or preview domain.
* **Add all relevant domains** — Add root, www, and marketing subdomains if they are part of your GTM website.
* **Track high-intent forms** — In your Knowledge Base's Target Forms tab, add demo, contact, trial, and gated content pages so submissions count as signals.
* **Publish your changes** — Website builders and GTM both require publishing before changes go live.
* **Test after publishing** — Always test the installation after the site is published.
* **Review privacy settings** — Make sure your privacy policy and consent setup match your company's requirements.
* **Install before building target lists** — Install Vision early so signals can start flowing before your team builds target lists.

## FAQs

<AccordionGroup>
  <Accordion title="Does the Vision pixel slow down my website?">
    The Vision pixel is designed to load asynchronously so it does not block your page from loading.
  </Accordion>

  <Accordion title="Where should I install the Vision Pixel snippet?">
    Install it before the closing `</head>` tag or through Google Tag Manager as a Custom HTML tag.
  </Accordion>

  <Accordion title="Should I install it on every page?">
    Yes. For best results, install it across your full marketing website.
  </Accordion>

  <Accordion title="Can I install it only on landing pages?">
    Yes, but 1eyeᴬᴵ will only capture activity from the pages where the Vision Pixel snippet is installed.
  </Accordion>

  <Accordion title="Can I use Google Tag Manager?">
    Yes. Create a Custom HTML tag, paste the Vision pixel snippet, set the trigger to All Pages, then publish the container.
  </Accordion>

  <Accordion title="How long does it take to show signals?">
    Signals may take a few minutes to appear after the Vision Pixel is installed and website activity is captured.
  </Accordion>

  <Accordion title="Will I get a confirmation?">
    Yes. Once 1eyeᴬᴵ detects the vision pixel, you will see an installed confirmation in the product. You may also receive an email notification confirming that Vision has been installed successfully.
  </Accordion>

  <Accordion title="Why are some visitors not identified?">
    Not every visitor can be identified. Identification depends on available signal data, enrichment match, source quality, and visitor context.
  </Accordion>

  <Accordion title="What if my site uses both root and www domains?">
    Install Vision on the version visitors actually use. If both versions are active, make sure both are covered or redirected correctly.
  </Accordion>

  <Accordion title="What if my site uses a cookie banner?">
    Your consent setup may control when the Vision Pixel loads. Review your consent and privacy settings before going live.
  </Accordion>

  <Accordion title="Can I add multiple domains?">
    Yes. Add each domain or subdomain where 1eyeᴬᴵ should capture website activity.
  </Accordion>

  <Accordion title="Can I exclude certain companies from being surfaced as signals?">
    Yes. Use Exclusions in your Knowledge Base to keep specific companies — like existing customers or partners — out of buyer matching. This isn't page-level tracking control; the Vision pixel installed here still captures activity across your included domains.
  </Accordion>

  <Accordion title="Can I specify which form pages to track?">
    Yes. Add important form pages under Target Forms in your Knowledge Base, such as demo, contact, trial, newsletter, webinar, and gated content pages.
  </Accordion>

  <Accordion title="Can I remove the Vision Pixel later?">
    Yes. Remove the vision pixel from your website header or delete the Google Tag Manager tag, then publish your changes.
  </Accordion>
</AccordionGroup>

## Next step

After Vision is installed, go to Knowledge Base to review the ICPs, personas, Target Pages, exclusions, and tracking rules that 1eyeᴬᴵ creates for your workspace.