> ## Documentation Index
> Fetch the complete documentation index at: https://help.dash.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Ad Pay Protection pixel

> Add the Dash.fi Ad Pay Protection pixel to your website using Google Tag Manager, Shopify, BigCommerce, Funnelish, or a direct HTML script tag.

The Ad Pay Protection (A.P.P.) pixel is a lightweight JavaScript snippet that tracks user events on your website and correlates them with your ad platform data for real-time auditing and fraud detection. Your unique pixel script is provided by your Dash.fi Customer Success Manager during your implementation call. Once you have the script, follow the instructions below for your platform.

<Note>
  If you haven't received your pixel script yet, contact your Customer Success Manager or email [support@dash.fi](mailto:support@dash.fi) before proceeding.
</Note>

***

## Installation methods

Choose the tab that matches how your website is built or managed.

<Tabs>
  <Tab title="Google Tag Manager">
    Google Tag Manager (GTM) is the recommended method if you already use GTM on your site, as it lets you deploy and update the pixel without touching your site's code directly.

    <Steps>
      <Step title="Open Google Tag Manager">
        Go to [tagmanager.google.com](https://tagmanager.google.com/) and select the account and container where you want to install the pixel.
      </Step>

      <Step title="Create a new tag">
        Click **New Tag** and give the tag a descriptive name (e.g., `Dash.fi Ad Pay Protection`).
      </Step>

      <Step title="Configure the tag">
        Set the following options:

        * **Tag Type**: Custom HTML
        * **HTML**: Paste your full pixel script into the HTML field
        * **Triggering**: All Pages
      </Step>

      <Step title="Save the tag">
        Click **Save** to store the tag configuration.
      </Step>

      <Step title="Publish the container">
        Click **Submit** in the top navigation bar, add a version name or description if prompted, and publish. The pixel is now live on all pages.
      </Step>
    </Steps>

    <Tip>
      After publishing, use GTM's Preview mode to verify the tag fires correctly on page load before closing your session.
    </Tip>
  </Tab>

  <Tab title="Shopify">
    If your storefront runs on Shopify, you can add the pixel directly to your theme's `theme.liquid` file so it loads on every page automatically.

    <Warning>
      Always back up your theme before editing code. In Shopify Admin, go to **Online Store > Themes**, click the three-dot menu on your active theme, and select **Duplicate** to create a backup copy.
    </Warning>

    <Steps>
      <Step title="Open the theme code editor">
        In Shopify Admin, go to **Online Store > Themes**. Click the three-dot menu (or **Actions**) on your active theme, then select **Edit code**.
      </Step>

      <Step title="Open theme.liquid">
        In the **Layout** folder on the left, click **theme.liquid** to open the file.
      </Step>

      <Step title="Locate the closing head tag">
        Use your browser's find function (Ctrl+F / Cmd+F) to locate the closing `</head>` tag in the file.
      </Step>

      <Step title="Paste the pixel script">
        Paste your pixel script on a new line **directly above** the `</head>` tag.
      </Step>

      <Step title="Save the file">
        Click **Save**. The pixel will now load on every page of your Shopify store.
      </Step>
    </Steps>
  </Tab>

  <Tab title="BigCommerce">
    BigCommerce's Script Manager lets you add third-party scripts without editing theme files directly.

    <Steps>
      <Step title="Open Script Manager">
        In your BigCommerce Dashboard, navigate to **Storefront > Script Manager**.
      </Step>

      <Step title="Create a new script">
        Click **Create a Script**.
      </Step>

      <Step title="Configure the script">
        Fill in the following fields:

        * **Name**: A descriptive name (e.g., `Ad Pay Protection Pixel`)
        * **Location**: Head
        * **Pages**: All Pages
        * **Category**: Analytics or Targeting / Advertising
        * **Script type**: Script
        * **Script contents**: Paste your entire pixel script here
      </Step>

      <Step title="Save the script">
        Click **Save**. BigCommerce will inject the script into the `<head>` of every page automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Funnelish">
    If you use Funnelish to build and manage your funnels, add the pixel through the funnel's custom codes settings.

    <Steps>
      <Step title="Open Funnel Settings">
        From your Funnelish Dashboard, select the funnel you want to track. Click the **Funnel Settings** gear icon.
      </Step>

      <Step title="Navigate to Custom Codes">
        Go to the **Tracking Codes** section, then open **Custom Codes**.
      </Step>

      <Step title="Create a new code">
        Click **Create a new code**.
      </Step>

      <Step title="Configure the code">
        Set the following options:

        * **Name**: A descriptive name (e.g., `Ad Pay Protection Pixel`)
        * **Code placement**: Append to page head *(this setting is critical — do not choose a footer option)*
        * **Lazy Load**: **Disabled** (leave unchecked)
        * **Code Block**: Paste your entire pixel script
      </Step>

      <Step title="Save the code">
        Click **Create Code** or **Save changes**. The pixel will now fire on every page of your funnel.
      </Step>
    </Steps>

    <Warning>
      Ensure **Lazy Load** is disabled. If the pixel loads lazily, it may miss early page events and produce incomplete tracking data.
    </Warning>
  </Tab>

  <Tab title="Manual HTML">
    If you manage your website's HTML directly, you can add the pixel manually to each page or to a shared header file.

    <Warning>
      Always back up your HTML files before making edits. Keep a copy of the original files in a safe location before you begin.
    </Warning>

    <Steps>
      <Step title="Identify files to edit">
        Determine which HTML files need the pixel. If your site uses a shared header or layout file, you only need to edit that one file. Otherwise, identify every individual page you want to track.
      </Step>

      <Step title="Open the file in a text editor">
        Open the target HTML file in your preferred text or code editor.
      </Step>

      <Step title="Locate the closing head tag">
        Find the closing `</head>` tag in the file.
      </Step>

      <Step title="Paste the pixel script">
        Paste your pixel script on a new line **immediately before** `</head>`.

        ```html theme={null}
        <!-- Dash.fi Ad Pay Protection Pixel -->
        <!-- Paste your pixel script here -->
        </head>
        ```
      </Step>

      <Step title="Save and upload">
        Save the file and upload it to your web server, replacing the existing version. Repeat this process for all pages if there is no shared header file.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Verifying installation

After installing the pixel, confirm it's firing. Load a page on your site and open your browser's developer tools (Network tab) — look for a request to the Dash.fi pixel endpoint. Your Customer Success Manager can also confirm receipt of pixel events on the Dash.fi side.

<Note>
  If you need help verifying your pixel installation, contact [support@dash.fi](mailto:support@dash.fi) with your site URL and the installation method you used.
</Note>