> ## 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.

# Snapchat Ads Setup

> Connect your Snapchat ad account and add the Northbeam parameter so spend and revenue line up.

When you're done, Northbeam shows your Snapchat spend, impressions, visits, and attributed revenue on the same campaigns, ad sets, and ads.

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

  * A Snapchat login with **admin access** to the ad account
  * Access to **Snapchat Ads Manager** to edit your ads
</Info>

<CardGroup cols={3}>
  <Card title="1. Connect the account" icon="plug" href="#connect-your-snapchat-ad-account">
    Sync spend, impressions, and campaign structure from Snapchat.
  </Card>

  <Card title="2. Add Northbeam parameters" icon="link" href="#add-northbeam-parameters-to-your-ads">
    Add `nbt` so visits and orders tie back to your ads.
  </Card>

  <Card title="3. Confirm tracking" icon="circle-check" href="#confirm-tracking">
    Check that the parameter and the connection are working.
  </Card>
</CardGroup>

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

    <span id="what-does-the-connection-do" style={{ display: "block", scrollMarginTop: "7rem" }} />

    <span id="how-to-connect-your-ad-account" style={{ display: "block", scrollMarginTop: "7rem" }} />

    1. Open [Connections](https://dashboard.northbeam.io/settings/connections). If you're still in onboarding, go to **Integrations** instead.
    2. Find **Snapchat Ads** and click **Connect**.
    3. Sign in with a Snapchat login that has **admin access** to the ad account.

    The connection pulls your current and historical campaigns, ad sets, and ads from the Snapchat Ads API, along with spend, impressions, and Snapchat-reported conversion and creative metrics. Impressions also power the **Clicks + Modeled Views** attribution model.

    **If you skip this step:** campaign, ad set, and ad names are missing, along with spend, impressions, and Snapchat-reported metrics.
  </Step>

  <Step title="Add Northbeam parameters to your ads">
    <span id="step-2-insert-northbeam-utm-parameters" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Add the `nbt` parameter to every ad. There are two ways to do it, and either one works.

    ### Method 1: Appending in the URL

    Add this to the end of your ad's URL:

    ```
    ?nbt=nb:snapchat:{{site_source_name}}:{{campaign.id}}:{{adSet.id}}:{{ad.id}}
    ```

    **Have existing UTM parameters?** Add ours to the end and join them with an ampersand (`&`). For example:

    ```
    utm_source=paid&utm_medium=snapchat&nbt=nb:snapchat:{{site_source_name}}:{{campaign.id}}:{{adSet.id}}:{{ad.id}}
    ```

    ### Method 2: Using the Custom Parameter field

    Create a **custom parameter** with this name and value:

    | Parameter name | Parameter value |
    | :- | :- |
    | `nbt` | `nb:snapchat:{{site_source_name}}:{{campaign.id}}:{{adSet.id}}:{{ad.id}}` |

    <span id="step-by-step-guide" style={{ display: "block", scrollMarginTop: "7rem" }} />

    To have Northbeam add the parameter to new Snapchat ads automatically, [ask Support](https://www.northbeam.io/submit-a-support-ticket) to turn on UTM auto-appending.

    <AccordionGroup>
      <Accordion title="Watch a walkthrough">
        <iframe src="https://www.youtube.com/embed/bnjQpwazReA?si=wy08-3TNWhc7sERP" width="100%" height="450" allowfullscreen />
      </Accordion>
    </AccordionGroup>

    **If you skip this step:** Northbeam can't tie visits and orders to your Snapchat ads, so spend and revenue show up on separate lines.
  </Step>

  <Step title="Confirm tracking">
    * **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm the Northbeam parameter reaches your landing pages.
    * **Connection syncing:** 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>

## Need help?

<CardGroup cols={2}>
  <Card title="Snapchat Ads FAQ" icon="circle-question" href="/docs/channels/snapchat/faq">
    Extra accounts, data discrepancies, and other common questions.
  </Card>

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