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

# Neon Pixel Setup

> Connect Neon Pixel with your API key and turn on Clicks + Deterministic Views for spend reporting and deterministic view attribution.

When you're done, Northbeam shows your Neon Pixel spend and platform data, and uses Neon Pixel impressions for deterministic view attribution in the **Clicks + Deterministic Views** model.

<span id="before-you-start" style={{ display: "block", scrollMarginTop: "7rem" }} />

<span id="need-an-api-key" style={{ display: "block", scrollMarginTop: "7rem" }} />

<Info>
  **Before you start**, make sure you have:

  * A Neon Pixel API key
  * The channel information from your Neon Pixel representative
  * Contact details for your Neon Pixel representative

  **Need an API key?** Contact your Neon Pixel representative. Keep the key secure. Don't add it to landing page URLs or share it outside the people responsible for this integration.
</Info>

<span id="setup" style={{ display: "block", scrollMarginTop: "7rem" }} />

<CardGroup cols={4}>
  <Card title="1. Connect the account" icon="plug" href="#connect-your-neon-pixel-account">
    Paste your API key and pick your channel.
  </Card>

  <Card title="2. Finalize impressions" icon="eye" href="#finalize-impression-data-setup">
    Ask your Neon Pixel rep to finish impression setup.
  </Card>

  <Card title="3. Enable C+DV" icon="sliders" href="#enable-clicks-+-deterministic-views">
    Turn on Clicks + Deterministic Views for Neon Pixel.
  </Card>

  <Card title="4. Confirm tracking" icon="circle-check" href="#confirm-tracking">
    Check the connection and wait about 48 hours.
  </Card>
</CardGroup>

<Steps titleSize="h2">
  <Step title="Connect your Neon Pixel account">
    <span id="step-1-connect-your-neon-pixel-account" style={{ display: "block", scrollMarginTop: "7rem" }} />

    1. In Northbeam, go to [**Settings > Connections**](https://dashboard.northbeam.io/settings/connections).
    2. Find **Neon Pixel** and click **Connect**.
    3. Under **Neon Pixel Channels**, select the channel or channels your Neon Pixel representative gave you (for example, **Multi-touch**).
    4. Paste your Neon Pixel API key into the **API Key** field.
    5. Optional: turn on **Apex data sharing** if you want Northbeam to send performance signals to Neon Pixel.
    6. Review the data sharing terms.
    7. Turn on **Clicks + Deterministic Views** so Northbeam can receive impressions for this attribution model.
    8. Click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/96247aca-02-configure-neon-pixel.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=5feab407901e15229d81da515ad0c97e" alt="Neon Pixel connection configuration dialog" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1160" height="660" data-path="images/readme/96247aca-02-configure-neon-pixel.png" />
    </Frame>

    <AccordionGroup>
      <Accordion title="See screenshots">
        <Frame caption="Neon Pixel connection card on the Connections page">
          <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/970b9103-neon-pixel-connect-card.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=f81ea9ae45d532148ae724a216dddc47" alt="Neon Pixel connection card on the Connections page" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1902" height="843" data-path="images/readme/970b9103-neon-pixel-connect-card.png" />
        </Frame>

        <Frame caption="Neon Pixel Channels selector (Multi-touch shown)">
          <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/1a752bcc-neon-pixel-channels.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=41d83a2c690f8f37a94d6f82bc031cfd" alt="Neon Pixel Channels selector" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="769" height="228" data-path="images/readme/1a752bcc-neon-pixel-channels.png" />
        </Frame>
      </Accordion>
    </AccordionGroup>

    **If you skip this step:** Neon Pixel data won't appear in Northbeam. If you leave Apex data sharing off, the account still connects, but Northbeam won't share Apex performance signals with Neon Pixel.
  </Step>

  <Step title="Finalize impression data setup">
    <span id="step-2-finalize-impression-data-setup" style={{ display: "block", scrollMarginTop: "7rem" }} />

    After the account connects, Northbeam shows a **Finalize Neon Pixel impression setup** message.

    1. Click **Done** to close the message.
    2. Contact your Neon Pixel representative and ask them to finalize your impression data setup.

    <Frame>
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/60ae47f9-03-finalize-impression-setup.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=2713c89a9b9b80027da790f497dd65fc" alt="Finalize Neon Pixel impression setup message" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="700" height="260" data-path="images/readme/60ae47f9-03-finalize-impression-setup.png" />
    </Frame>

    <span id="required-for-view-attribution" style={{ display: "block", scrollMarginTop: "7rem" }} />

    <Warning>
      **Required for view attribution.** Connecting the account doesn't complete impression setup. Your Neon Pixel representative must finalize it before deterministic impression data can flow to Northbeam.
    </Warning>

    **If you skip this step:** Neon Pixel impression data won't populate.
  </Step>

  <Step title="Enable Clicks + Deterministic Views">
    <span id="step-3-enable-clicks-+-deterministic-views" style={{ display: "block", scrollMarginTop: "7rem" }} />

    1. In Northbeam, go to [**Settings > Model Settings**](https://dashboard.northbeam.io/settings/model-settings).
    2. Turn on **Clicks + Deterministic Views** under **Attribution Models Available**.
    3. In the platform list below the model, select **Neon Pixel**.
    4. Save your changes if prompted.

    <Frame>
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/c70982c9-05-model-settings.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=28e525c14e3a5e557ba99435f3ffb875" alt="Clicks + Deterministic Views enabled for Neon Pixel in Model Settings" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1150" height="380" data-path="images/readme/c70982c9-05-model-settings.png" />
    </Frame>

    The model must be on both in Model Settings and for Neon Pixel.

    **If you skip this step:** spend may appear, but deterministic view attribution won't be available.
  </Step>

  <Step title="Confirm tracking">
    <span id="verify-the-integration" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Once the connection and impression setup are complete, allow about **48 hours** for data to start flowing.

    Go back to [**Settings > Connections > Neon Pixel**](https://dashboard.northbeam.io/settings/connections) and confirm that:

    * The connection card shows a green confirmation icon.
    * The correct Neon Pixel ad account ID is linked.
    * **Enable C+DV for Neon Pixel** is turned on.
    * Apex data sharing matches your preferred setting.

    <Frame>
      <img src="https://mintcdn.com/northbeam/2WFDmMEgiT5tNzbL/images/readme/1ba604b4-04-connected-account.png?fit=max&auto=format&n=2WFDmMEgiT5tNzbL&q=85&s=0ef942f1f02085baffb5a3403e1c295d" alt="Connected Neon Pixel account on the Connections page" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="1160" height="400" data-path="images/readme/1ba604b4-04-connected-account.png" />
    </Frame>

    Then check that:

    * **Clicks + Deterministic Views** and **Neon Pixel** are both turned on in Model Settings.
    * Your Neon Pixel representative has confirmed impression setup is complete.
    * In Sales Attribution, with the **Clicks + Deterministic Views** model selected, Neon Pixel spend appears for the expected date range.
    * Revenue and ROAS populate when eligible impressions are matched to orders.

    For a full check, follow [Checking platform connections](/docs/checking-api-connections) to confirm the account shows as connected and data is arriving.

    If a check fails, see [Troubleshooting Northbeam data](/docs/troubleshooting-tracking-issues).
  </Step>
</Steps>

## After switching: items to review

Switching to Neon Pixel doesn't delete historical data from the previous connection. Northbeam updates built-in platform references automatically, but it doesn't rewrite configurations you created. Saved views and columns that point to the inactive platform may show up blank.

After switching, review your:

* Custom metrics
* Breakdowns
* Saved views
* Scheduled exports
* Marketing Mix Modeling mappings

## Need help?

<CardGroup cols={2}>
  <Card title="Neon Pixel FAQ" icon="circle-question" href="/docs/channels/neon-pixel/faq">
    Common Neon Pixel setup and reporting questions.
  </Card>

  <Card title="Troubleshooting Northbeam data" icon="wrench" href="/docs/troubleshooting-tracking-issues">
    Start here if a check above fails.
  </Card>
</CardGroup>
