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

# Pinterest

> Connect Pinterest Ads to SegmentStream and import campaign cost data.

## Getting started

<Steps>
  <Step title="Navigate to Data Sources">
    Inside the admin panel navigate to the **Data Sources** page and click **+ NEW** on the top right corner.
  </Step>

  <Step title="Select Pinterest">
    Choose **Pinterest** from the list.
  </Step>

  <Step title="Authenticate">
    Click **Click to connect Pinterest** and go through the authentication and setup flow.
  </Step>

  <Step title="Name the data source">
    Name your data source.
  </Step>

  <Step title="Save">
    Click **Save**.
  </Step>
</Steps>

## UTM tagging best practices

Adding a `utm_id` parameter to your tagging template will guarantee improved stitching quality of costs to sessions without altering the rest of your existing UTM tags.

<Steps>
  <Step title="Append the utm_id parameter">
    In the **Destination URL** field of your ad setup, append the following parameter to your URL:

    ```plain text theme={null}
    &utm_id={campaignid}_{adid}
    ```
  </Step>

  <Step title="Publish">
    Click **Publish**.
  </Step>
</Steps>

## Shopping campaigns settings

SegmentStream does not support automatic UTM matching for [Shopping campaigns](https://help.pinterest.com/en/business/article/track-report-optimize-shopping-campaigns). You will need to match these types of campaigns manually inside the SegmentStream admin panel using the following settings.

### URL parameters for all Shopping campaigns

If you use a single UTM tracking template for all Shopping campaigns in your Pinterest account, enter it into this field to ensure proper allocation of cost to sessions in the reports.

### URL parameters for specific Shopping campaigns

If specific Shopping campaigns in your Pinterest account use unique UTM tracking templates, enter the respective **Campaign ID** and **URL parameters** to ensure that the cost is properly allocated to sessions for those campaigns.

## Supported dynamic URL parameters

By default Pinterest allows the use of [dynamic URL tagging parameters](https://help.pinterest.com/en/business/article/third-party-and-dynamic-tracking) to track campaigns.

SegmentStream supports the following parameters:

| Name              | Description                |
| ----------------- | -------------------------- |
| `{campaignid}`    | Advertising campaign ID.   |
| `{campaign_name}` | Advertising campaign name. |
| `{adgroupid}`     | Ad group ID.               |
| `{adgroup_name}`  | Ad group name.             |
| `{creative_id}`   | Pin promotion ID.          |
| `{adid}`          | Pin promotion ID.          |