RudderStack lets you send your event data to Pinterest Conversions API via the cloud mode. It sends the event calls in a batch where each batch can contain upto 1000 events.

Track

The track call allows you to capture the users' conversion events.

RudderStack maps the track events as specified in the Map Your Events To Pinterest Events connection setting in the dashboard.

A sample track call is shown below:

Copy
rudderanalytics.track("Order Completed", {
  event_id: 'eventIDordercompleted',
  order_id: "transactionId",
  value: 35.00,
  revenue: 31.98,
  currency: 'USD',
  products: [{
    product_id: '123454387',
    price: 3.00,
    quantity: 2,
    currency: 'USD',
    position: 1,
    value: 6.00,
  }]
}, {
  traits: {
    email: "alex@example.com",
    lastname: "Keener",
    firstname: "Alex",
    action_source: "offline" // or app_ios / app_android / web
  }
});

Ecommerce conversion tracking

RudderStack supports ecommerce conversion tracking for Pinterest. You can use the Ecommerce Events Specification for sending the events while instrumenting your site with the RudderStack SDK.

The following table mentions how the specific RudderStack track Ecommerce events are mapped to standard Pinterest Conversion Events:

You can also track a custom event that you want to include in the conversion reporting. It will be mapped to a custom Pinterest event, for example:

Copy
rudderanalytics.track("custom event")

Standard Pinterest events

Pinterest supports the following nine standard events that can be mapped and tracked for reporting. Any event apart from these is treated as a user-defined event.

• Checkout
• AddToCart
• PageVisit
• SignUp
• WatchVideo
• Lead
• Search
• ViewCategory
• Custom

Page

The page call lets you record your website's page views with any additional relevant information about the viewed page.

• view_category: RudderStack sends this event if both the name and category fields are present. The below sample event contains both the fields and is mapped to the Pinterest's view_category event:

Copy
rudderanalytics.page("Best Seller", "Games", {
  path: "/best-seller/games/1",
  url: "https://www.estore.com/best-seller/games/1",
  title: "Best selling games offered by EStore",
  search: "estore bestseller games",
  referrer: "https://www.google.com/search?q=estore+bestseller",
  testDimension: "true",
})

• page_visit: RudderStack sends this event if only name field is present and drops any additional properties. The below sample event contains only name and is mapped to the Pinterest's page_visit event:

Copy
rudderanalytics.page("Best Seller", {
  path: "/best-seller/1",
})

Common field mappings

The following table lists the mappings specific for Pinterest Conversion API and are relevant for both the track and page calls:

User field mappings

The following table lists the mappings for fields carrying the user information for track and page calls:

Custom field mappings

The following table lists the custom fields mappings for track and page calls:

Limited Data Processing (LDP)

Starting January 1, 2023, you can use Pinterest's Limited Data Processing (LDP) flag to limit how Pinterest uses certain data to help the advertisers comply with the users' privacy settings in accordance with the CCPA (California Consumer Privacy Act).

The following table lists the event properties required to enable Limited Data Processing and their mappings with the Pinterest fields:

FAQ

How can I verify if my events are being sent to Pinterest Conversions API?

Follow these steps to see your events in Pinterest Conversions API:

1. Login to your Pinterest ads manager account.
2. Click the Ads tab and select Conversions from the dropdown.
3. Select API for conversions from the dropdown to see your events.