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

# Pinterest Ads Setup

> Connect your Pinterest ad account and add Northbeam parameters so spend and revenue line up.

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

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

  * A Pinterest login with **admin access** to the ad account
  * Access to **Pinterest Business Manager** to change ad account settings
</Info>

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

  <Card title="2. Add Northbeam parameters" icon="link" href="#add-northbeam-parameters-to-your-ads">
    Add `nbt` and `nb_platform` once in your ad account settings.
  </Card>

  <Card title="3. Confirm tracking" icon="circle-check" href="#confirm-tracking">
    Click a live ad and check the landing page URL.
  </Card>
</CardGroup>

<Steps titleSize="h2">
  <Step title="Connect your Pinterest ad account">
    <span id="step-1-connect-your-pinterest-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 **Pinterest Ads** and click **Connect**.
    3. Sign in with a Pinterest login that has **admin access** to the ad account.

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

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

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

    <span id="step-2-insert-northbeam-utm-parameters" style={{ display: "block", scrollMarginTop: "7rem" }} />

    Add these two custom parameters in your ad account settings. They apply to every campaign in the account.

    | Parameter | Value |
    | :- | :- |
    | `nbt` | `nb:pinterest::{campaignid}:{adgroupid}:{adid}` |
    | `nb_platform` | `pinterest` |

    1. Log in to your **Pinterest Business account**.
    2. Click the menu icon (top-left) → **Business Manager**.
    3. Select **Ad Accounts** and choose your ad account.
    4. Open the **Settings** tab → **Parameter Settings**.
    5. Under **Custom Parameters**, add both parameters above.

    <Frame caption="Business Manager > Ad Accounts > Settings > Parameter Settings">
      <img src="https://mintcdn.com/northbeam/EpMPeQ8Ec2Yrg9EI/images/readme/789ad440-CleanShot_2026-03-11_at_11.05.282x.png?fit=max&auto=format&n=EpMPeQ8Ec2Yrg9EI&q=85&s=4a428e558e36470e336d3e5048cfdbe6" alt="Pinterest Parameter Settings with nbt and nb_platform custom parameters" style={{ maxWidth: "560px", maxHeight: "440px", width: "auto", height: "auto", margin: "0 auto" }} width="3400" height="1864" data-path="images/readme/789ad440-CleanShot_2026-03-11_at_11.05.282x.png" />
    </Frame>

    Pinterest adds standard GA UTMs (`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`) by default. Northbeam doesn't need them, so you can keep or remove them. To have Northbeam add the parameters to new Pinterest ads automatically, [ask Support](https://www.northbeam.io/submit-a-support-ticket) to turn on UTM auto-appending.

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

  <Step title="Confirm tracking">
    **Quick check:** click one of your live Pinterest ads and look at the landing page URL. `nbt` should show real numbers where `{campaignid}`, `{adgroupid}`, and `{adid}` are. If you see that placeholder text, check the parameters against the table above.

    For a full check:

    * **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm the Northbeam parameters reach 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="Pinterest FAQ" icon="circle-question" href="/docs/channels/pinterest/faq">
    Common Pinterest 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>