Configuration

Pinterest Ads & Conversions API Setup

Configure Pinterest Tag tracking and Pinterest Conversions API (CAPI) in a hybrid layout. Stream storefront user engagement and checkout conversions directly from your Shopify server to Pinterest's ad system.

Deduplication and Server-Side Recovery

Standard client-side Pinterest tags can miss up to 30% of visitor behaviors due to browser ad-blockers, tracking restrictions, and page abandonment.

TrakIt bypasses these limitations by deploying a dual-tracking architecture. Browser tags track front-end shopping behaviors, while TrakIt's server transmits transaction actions directly using the Pinterest Conversions API.

To prevent conversion double-counting, TrakIt attaches matching deduplication tokens (unique event identifiers) to both browser tag triggers and server-side webhook payloads. Pinterest's matching engine joins these streams, deduplicating matching events and attributing conversions cleanly.

Step-by-Step Configuration Guide

Step A: Retrieve Your Pinterest Tag/Pixel ID

  1. Log into your Pinterest Business Manager dashboard.
  2. Navigate to the top menu and select Ads → click Conversions.
  3. Click Tag Manager on the left-hand menu.
  4. Copy your numeric Tag/Pixel ID (e.g. 2614221885475).
  5. Paste it into TrakIt's Pixel ID input field in the Configuration card.

Step B: Retrieve Your Ad Account ID

  1. Under your Pinterest Business profile settings, navigate to account details.
  2. Copy the numeric Ad Account ID (e.g. 549769530006).
  3. Paste it into the Ad Account ID input field inside TrakIt.

Step C: Generate API Access Token

  1. Navigate to the **Conversions** tab inside Pinterest Ads Manager and go to **Settings**.
  2. Scroll down to the **Conversions API** section and generate an Access Token.
  3. Copy the generated token string (starting with pina_...).
  4. Paste the token into the Api Access Token field inside TrakIt.
  5. Click Save inside the Configuration panel.

Configuration Notes & Save Rules

• Save Button Unlock: In TrakIt, the **Save** buttons under the lower *Event Selection* and *Settings* cards are disabled initially. They will unlock for editing once you have successfully entered and saved your credentials under the main *Configuration* card.

• UI Note on Measurement ID: The blue warning box at the bottom of the Configuration card in TrakIt states: "Note: If you change Measurement ID, you'll need to re-download and import the container." In the context of Pinterest Ads, "Measurement ID" refers directly to your Pinterest **Pixel ID** or credentials.

Step D: Google Tag Manager (GTM) Container Sync

To load Pinterest Tag web triggers onto storefront pages, the tracking tag configuration must be synced with your Google Tag Manager (GTM) workspace:

Automatic GTM Import (Recommended)

If your Google Account is connected to TrakIt, all Pinterest Ads events and tag configurations will be imported automatically into your GTM container via GTM API. There is no need to download or upload container files manually.

If your Google account is not connected, you must download the container JSON file from TrakIt's right-hand sidebar and import it manually:

How to import manually into GTM:

  1. Open your Google Tag Manager workspace.
  2. Go to Admin → Import Container.
  3. Upload the downloaded container file.
  4. Choose Merge.
  5. Click Confirm to integrate the tag configurations.

* Note: Since we automatically import the tags into the container when the Google account is connected, there is no need to manually import it.

Offered Events Mapping

TrakIt supports the following standard events for Pinterest Ads. Check the boxes to activate Web or Server reporting for each event:

Event NameTrigger DescriptionServerWeb
PageVisitCustomer loads any page on your storefront.-✔
ViewContentCustomer opens a product page.-✔
ViewCategoryCustomer opens a collection or category page.-✔
SearchCustomer executes a store search query.-✔
AddToCartCustomer adds a product to their shopping cart.✔✔
InitiateCheckoutCustomer clicks to begin Shopify checkout.✔✔
AddPaymentInfoCustomer enters payment card details.-✔
CheckoutCustomer completes payment and finishes the checkout.✔-

Important Event Settings Notes

• Server-Only Checkout: In the Pinterest Ads integration, the final conversion purchase event (labeled Checkout) is **Server-only**. Because checkout completion runs entirely via TrakIt's server webhooks, browser-based double counting is avoided, securing 100% accurate conversion numbers directly on the server.

• Web Events Container Sync: The warning note under Event Selection states: "Note: If you change web events, you'll need to re-download and import the container." If you change checkboxes for Web events, you must download the container and re-import it into GTM to reflect the updated event triggers.

Granular Settings & Parameters

The **Settings** panel at the bottom of the left column provides customization options for your parameter data feeds:

Order Identifier

Define the order ID sent to Pinterest. Select between **Transaction ID** (recommended), **Order Number**, or **Order Name**.

Product Identifier

Align item catalog matches with your Pinterest Product Catalog. Choose **Product ID**, **Variant ID**, or **SKU**.

Exclude Sales Channels

Filter out specific non-storefront orders from triggering Pinterest Conversions API payloads. Select channels like Recharge, Point of Sale (POS), or Shopify Draft Orders.

Conversion Value Adjustments

Set checkable toggles to exclude taxes or shipping costs, or deduct discount values from order total amounts.

Testing Server Events via Test Mode

Pinterest Ads settings in TrakIt include an **Enable Test Mode** checkbox under the Settings panel. This routes conversions to Pinterest's test log stream for verification:

  1. Check the Enable Test Mode checkbox inside TrakIt's Settings card.
  2. Click Save Settings.
  3. Open your Pinterest Ads dashboard, navigate to **Conversions** → select **Test Events** tab.
  4. Perform standard test behaviors on your storefront (such as adding to cart or checking out).
  5. Verify in your Pinterest Test console that events appear immediately with server attribution tags active.

Disable Test Mode in Production

Always uncheck the **Enable Test Mode** checkbox and click **Save Settings** once event validation completes. If left checked in production, Pinterest will catalog real storefront conversions as test data instead of utilizing them for ad delivery optimization.

Unlinking & Tag Deletion

To remove the integration:

  1. Click Disconnect in the Disconnect panel.
  2. TrakIt automatically triggers an API removal run on your Tag Manager workspace to clean up Pinterest Ads tags and parameters. (If you are in manual setup mode, you will need to delete these variables inside GTM yourself).