Passer au contenu principal

​
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

  1. Go to Admin -> Layout Settings -> Meta & Analytics
  2. Scroll to the Pinterest tag section
  3. Enter your Pinterest Tag ID, for example 2612345678901
  4. Optional: enter your Pinterest ad account ID
  5. Optional: enter your Pinterest Conversions API access token
  6. 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.
ParameterTypeDescription
currencystringISO 4217 currency code, for example USD, CAD
valuenumberTotal value of the item payload
line_itemsobject[]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.
ParameterTypeDescription
currencystringISO 4217 currency code
valuenumberTotal transaction amount
order_idstringCrowdChange transaction ID
event_idstringtransaction_<transaction_id> dedupe identifier
order_quantitynumberNumber of transaction items
line_itemsobject[]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.
FieldDescription
event_namecheckout
action_sourceweb
event_idtransaction_<transaction_id>
event_source_urlCheckout page URL when available
currencyTransaction currency
valueTransaction total
order_idCrowdChange transaction ID
num_itemsPurchased item count
contentsPurchased content IDs and quantities
click_idCaptured Pinterest epik value when available
emSHA-256 hashed donor email when available
external_idSHA-256 hashed CrowdChange user ID when available
client_ip_addressRequest IP address
client_user_agentRequest 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:
  1. Visit any page on your platform and confirm Pinterest Tag loads from https://s.pinimg.com/ct/core.js
  2. Navigate between pages and confirm page events fire
  3. Add an item to the cart and confirm addtocart fires
  4. 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.