Pinterest Conversions API

Send your conversion events directly to Pinterest’s Conversions API (CAPI), now at the edge.

Find it on GitHub: /edgee-cloud/pinterest-capi-component

Pinterest Conversions API (CAPI) allows you to send web events directly to Pinterest from your server, ensuring reliable data tracking even with ad blockers or browser limitations. With Edgee’s edge integration, you can now send these events directly from the edge, improving both reliability and performance.

Event Mapping

Here’s how Edgee events map to Pinterest CAPI events:

Edgee event	Pinterest CAPI Event
Page	page_visit
Track	custom
User	lead

Pinterest Conversions API requires user identification data for event processing. Each event must include at least one of the following user properties:

• Email

Events without any user identification will be ignored by Pinterest.

User Identification

When you make a user call, Edgee stores the user’s data (user_id, anonymous_id, and properties) on the device. This enables proper attribution for subsequent page views and events.

Getting Started

To integrate Pinterest CAPI into your Edgee project:

1. Open the Edgee console and navigate to your project’s Components.
2. Select “Add a component” and choose edgee/pinterest-capi from the list of available components.
3. Enter the following credentials:
   • Pinterest Access Token: Your Pinterest CAPI access token
   • Pinterest Ad Account ID: Your Pinterest Ad Account ID
   • Pinterest is Test (Optional): For testing your implementation
4. Click Save to complete the setup.

To know how to get your access token and ad Account Id visit the Pinterest API documentation.

Destination name

When configuring the destination in your Edgee Data Layer or within SDK calls, use pinterest_capi as the component name:

{
  "components": {
    "edgee/pinterest-capi": true
  }
}

Testing Your Implementation

1. Set your is_test flag to true in the component configuration
2. Send test events through Edgee
3. Verify events in Pinterest Conversion Tab within ads manager

Use Pinterest test property is_test to test your implementation without affecting your production data.

For more details on Pinterest Conversions API implementation, refer to the official Pinterest CAPI documentation.