Pinterest

Pinterest Tag Integration

CrowdChange supports Pinterest Tag browser tracking, enhanced match, and optional Pinterest Conversions API checkout tracking. Once connected, your Pinterest Tag receives page, addtocart, and checkout events. If a Pinterest Conversions API access token is configured, CrowdChange also sends completed checkout events from the server.

Setup

Go to Admin -> Layout Settings -> Meta & Analytics
Scroll to the Pinterest tag section
Enter your Pinterest Tag ID, for example 2612345678901
Optional: enter your Pinterest ad account ID
Optional: enter your Pinterest Conversions API access token
Click Save

The browser Tag snippet and noscript fallback are automatically injected once the Tag ID is saved. Conversions API tokens are stored as write-only encrypted values; leave the token field blank to keep an existing token.

Tracked Events

page

Fired automatically on page load and virtual page navigation.

pintrk('page');

addtocart

Fired when an item is added to the checkout cart.

Parameter	Type	Description
`currency`	`string`	ISO 4217 currency code, for example `USD`, `CAD`
`value`	`number`	Total value of the item payload
`line_items`	`object[]`	Pinterest line item payloads

Example payload

{
  "currency": "CAD",
  "value": 50,
  "line_items": [
    {
      "product_id": "registration",
      "product_name": "Registration",
      "product_price": 50,
      "product_quantity": 1
    }
  ]
}

checkout

Fired when a donor successfully completes a transaction.

Parameter	Type	Description
`currency`	`string`	ISO 4217 currency code
`value`	`number`	Total transaction amount
`order_id`	`string`	CrowdChange transaction ID
`event_id`	`string`	`transaction_<transaction_id>` dedupe identifier
`order_quantity`	`number`	Number of transaction items
`line_items`	`object[]`	Pinterest line item payloads

Example payload

{
  "currency": "CAD",
  "value": 100,
  "order_id": "1000",
  "event_id": "transaction_1000",
  "order_quantity": 1,
  "line_items": [
    {
      "product_id": "donation",
      "product_name": "Donation",
      "product_price": 100,
      "product_quantity": 1
    }
  ]
}

Enhanced Match

When a logged-in user is available, CrowdChange loads Pinterest enhanced match with a normalized SHA-256 email hash. Raw email addresses are not sent to the browser tag.

Server-Side Checkout Tracking

When both a Pinterest ad account ID and Pinterest Conversions API access token are configured, CrowdChange sends a server-side checkout event.

Field	Description
`event_name`	`checkout`
`action_source`	`web`
`event_id`	`transaction_<transaction_id>`
`event_source_url`	Checkout page URL when available
`currency`	Transaction currency
`value`	Transaction total
`order_id`	CrowdChange transaction ID
`num_items`	Purchased item count
`contents`	Purchased content IDs and quantities
`click_id`	Captured Pinterest `epik` value when available
`em`	SHA-256 hashed donor email when available
`external_id`	SHA-256 hashed CrowdChange user ID when available
`client_ip_address`	Request IP address
`client_user_agent`	Request user agent

Ad-network failures are logged and do not interrupt the donor checkout flow.

Click ID Attribution (`epik`)

When a visitor arrives via a Pinterest ad, Pinterest may append epik to the URL or set an _epik cookie. CrowdChange captures either value and passes it to server-side checkout events as click_id.

Verifying Your Setup

After saving your Tag ID:

Visit any page on your platform and confirm Pinterest Tag loads from https://s.pinimg.com/ct/core.js
Navigate between pages and confirm page events fire
Add an item to the cart and confirm addtocart fires
Complete a test transaction and confirm checkout fires with the expected value, currency, and event_id

If you configured Conversions API, verify the server-side checkout in Pinterest Events Manager.

Additional Information

See Pinterest Tag docs and Pinterest Conversions API docs for further information.

Analytics & Tracking

Widgets

Pinterest Tag Integration

Setup

Tracked Events

page

addtocart

checkout

Enhanced Match

Server-Side Checkout Tracking

Click ID Attribution (`epik`)

Verifying Your Setup

Additional Information

​Pinterest Tag Integration

​Setup

​Tracked Events

​page

​addtocart

​checkout

​Enhanced Match

​Server-Side Checkout Tracking

​Click ID Attribution (epik)

​Verifying Your Setup

​Additional Information

Pinterest Tag Integration

Setup

Tracked Events

page

addtocart

checkout

Enhanced Match

Server-Side Checkout Tracking

Click ID Attribution (`epik`)

Verifying Your Setup

Additional Information