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

# Pinterest Ads

> An introduction to the Pinterest Ads Destination

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

## Overview

Destination Type: <IconText text="Client-side" name="browser" iconType="duotone" iconLocation="after" />  and <IconText text="Server-side" name="server" iconType="duotone" iconLocation="after" />

* Includes support for the <OutboundLink linkText="Pinterest API for Conversions" linkTarget="https://help.pinterest.com/en-gb/business/article/the-pinterest-api-for-conversions" />

***

## Installation instructions

1. Navigate to your <OutboundLink linkText="Pinterest Ads Manager" linkTarget="https://ads.pinterest.com/" /> . If the direct link does not open your Events Manager, you can access it from the Pinterest Ads Manager dashboard under **Tools** > **Events**.

2. From your Ads Manager click on <IconText text="Account overview" name="bars" iconLocation="after" /> in the top left corner.

3. Click on **Conversions** under the Business section.
   <Frame>
     <img src="https://mintcdn.com/converge/L45wyZk0Nu0wVlB6/images/destinations/pinterest/pinterest-destination-0.png?fit=max&auto=format&n=L45wyZk0Nu0wVlB6&q=85&s=86b5c9dd8622385d6bd71bc758c4d9b3" alt="pinterest-1" width="1059" height="628" data-path="images/destinations/pinterest/pinterest-destination-0.png" />
   </Frame>

4. Navigate to the **Pinterest Tag** > **Tag Manager** tab and copy your **Tag ID**, you will need it later. Create a tag if you do not have one.
   <Frame>
     <img src="https://mintcdn.com/converge/L45wyZk0Nu0wVlB6/images/destinations/pinterest/pinterest-destination-1.png?fit=max&auto=format&n=L45wyZk0Nu0wVlB6&q=85&s=cba0a80b3bcf413ecc5826bcf50d5963" alt="pinterest-2" width="918" height="299" data-path="images/destinations/pinterest/pinterest-destination-1.png" />
   </Frame>

5. Lastly, get your **Ad Account ID**, you can find it in the URL of the ad manager. It consists of 12 numbers.
   <Frame>
     <img src="https://mintcdn.com/converge/L45wyZk0Nu0wVlB6/images/destinations/pinterest/pinterest-destination-2.png?fit=max&auto=format&n=L45wyZk0Nu0wVlB6&q=85&s=a10024294b346df4fc5c0db34634f285" alt="pinterest-3" width="636" height="49" data-path="images/destinations/pinterest/pinterest-destination-2.png" />
   </Frame>

6. Navigate to the **API for conversions** > **Conversion access token** tab. Click on **Generate new token** and copy the token, you will need it later.

7. In the Converge sidebar, click on <IconText name="arrow-right-from-line" text="Event streams" /> and then click **Create new Destination**.

8. Select the **Pinterest** destination and click **Next**.

9. Give your destination a **name** (e.g. Pinterest Destination) and click **Next**.

10. Fill in the **Ad Account ID**, **Tag ID** and **Access Token** you copied from **Pinterest** and click **Next**.

11. Select **Use default mapping** and click **Next**.

<Note>You can find the Default mapping for the Pinterest destination [here](#event-mapping). For more information on setting up Custom mappings, look [here](/destinations/event-mapping).</Note>

12. Select the sources you want to forward events from, then click **Next**.

13. Review any issues and click **Submit**.

<Warning>
  Set this destination to **Deactivated** while you remove your existing Pinterest tracking setup. Running both in parallel leads to duplicate conversion data. Follow the **Turn off your old Pinterest tracking** instructions below, then set the destination to **Active** when you're ready.
</Warning>

***

## Turn off your old Pinterest tracking

### Turning off the Shopify Pinterest Ads Sales Channel

<Warning>
  The Pinterest Ads app for Shopify does not support disabling tracking without uninstalling the app. Uninstalling also stops your product sync to Pinterest. Before you continue, switch to a third-party feed manager as described <OutboundLink linkText="here" linkTarget="https://help.pinterest.com/en/business/article/upload-your-products-with-a-third-party" />.
</Warning>

1. Navigate to your <OutboundLink linkText="Shopify Admin Dashboard" linkTarget="https://admin.shopify.com/" />.

2. Click on **Sales channels** and choose **Pinterest** from the *Installed sales channels* menu.

3. Click on the menu icon in the top right, and click on **Uninstall**.

4. Confirm by clicking **Uninstall**.

***

## Modify your Content ID

The Converge Pinterest Destination will use the **Product ID** by default.
However, you can configure the destination to use explicitly the **Variant ID** or **SKU** instead.

1. Navigate to your Pinterest Destination, click on **Configuration**.
2. Click on the **Configuration**-subtab
3. Open the **Advanced configuration (optional)** section
4. Pick your desired Content ID, and click on **Save**

**List of available Content ID Modes**

| Content ID Mode | Behavior                    |
| --------------- | --------------------------- |
| Product Id      | Always use the `product_id` |
| Variant Id      | Always use the `variant_id` |
| SKU             | Always use the `sku`        |

***

## Converge functionality

This integration supports the following Converge destination functionality.

| Converge Feature                                     |       Supported       |
| ---------------------------------------------------- | :-------------------: |
| Custom Events                                        | <Icon name="xmark" /> |
| Filters                                              | <Icon name="check" /> |
| Server-side Conversions                              | <Icon name="check" /> |
| [Conversion amount](/destinations/conversion-amount) | <Icon name="check" /> |

***

## Event mapping

Converge automatically maps the following events from the [Converge event spec](/sources/converge-spec) to the Pinterest Ads spec.

| Converge Event Name                                                         | Pinterest Ads Event Name |
| --------------------------------------------------------------------------- | ------------------------ |
| [\$page\_load](/sources/converge-spec#page-load)                            | `page`                   |
| [Viewed Product](/sources/converge-spec#viewed-product)                     | `page_visit`             |
| [Viewed Collection](/sources/converge-spec#viewed-collection)               | `view_category`          |
| [Added To Cart](/sources/converge-spec#added-to-cart)                       | `add_to_cart`            |
| [Searched](/sources/converge-spec#searched)                                 | `search`                 |
| [Subscribed To Newsletter](/sources/converge-spec#subscribed-to-newsletter) | `lead`                   |
| [Placed Order](/sources/converge-spec#placed-order)                         | `checkout`               |