The Pinterest API for Conversions enables advertisers to send conversions directly to Pinterest via a server-to-server connection. Conversions captured with the Pinterest API can then be used for retargeting in campaigns and can be reviewed in conversion reporting for improved conversion visibility.
Through the Pinterest API for Conversions, advertisers can send:
Events can be received in real-time or within an hour of the event occurring and being captured. Events received outside this window or as part of a delayed batch event will be counted as offline conversions.
Using the Pinterest API for Conversions along with the Pinterest Tag can help maximize visibility into captured conversions. Our best practice is to use both conversion capturing solutions to ensure you’re receiving a comprehensive view of your conversion campaign performance.
The Pinterest API for Conversions is one of several products that live within our Pinterest API ecosystem. Anyone with a Pinterest Business account will be able to use the Pinterest API for Conversions, but this does not automatically grant access to the wider Pinterest API.
The Pinterest
Anyone with a Pinterest Business account has access to the Pinterest API for Conversions.
To get started, you’ll first need to generate an access token. An access token is a string of characters that verifies the requests are being made and sent back to the correct user’s account.
To generate an access token:
If you’re trying to access an account you don’t own, you’ll need to set up Business Access first.
Conversion Events: all event types available for capture on the Pinterest Tag are also available via the Pinterest API for Conversions. You can find a full list of the events and further information around their importance in our
Setting up a server to server
We strongly recommend using the Pinterest API for Conversions alongside the Pinterest Tag to ensure you’re maximizing your conversions.
If you’ve already set up the Pinterest Tag previously, you’ll need to ensure conversions aren’t being counted twice - once through the Pinterest Tag, and once through the API.
To achieve this, you’ll need to make sure the parameter, event_id is being passed back with conversions captured by both the Pinterest Tag and the Pinterest API for Conversions.
Our system will then recognize the event_ids as duplicates and only retain the first conversion captured. To ensure this deduplication is success, event_ids will need to be:
Based on that event identifier and the event_name, Pinterest will remove any duplicate events from the record, provided that (a) the event did not take place offline (the action_source is not offline), and (b) Pinterest receives the duplicate events within 48 hours of one another.
Once you’ve finished setting up the API, you can verify conversion events are being received by checking:
- Login to your
Pinterest business account - Click Ads in the top menu and choose Conversions
- Select Deduplication from the left hand navigation.
A resilient event setup includes additional conversion data that Pinterest can use to ensure that events will be matched and attributed correctly. This additional data will help us provide more accurate reporting as ad industry policies change and evolve.
There are three levels to rank an advertiser’s resilience: Poor, Good/Fair, and Great. Your resilience status is visible in the Conversion Health section of Ads Manager.
Poor
A poor status rating means that either:
Good / Fair
A good or fair status rating is achieved when:
Great
A great status rating means that an advertiser meets all of the Good/Fair requirements and also sends all of the medium and low priority ids.
To reach resilient advertiser status, Pinterest recommends sending the following signals.
API ID's/Signals | Weights/Rank |
---|---|
hashed_maid | High |
em | High |
client_ip_address + client_user_agent | High |
external_id | Medium |
fn+In | Medium |
click_id | Low |
ph | Low |
ge, bd, ct, st, zp, country | Low |
Pinterest has several Third Party Integrations to help support your API adoption process.
Google Tag Manager - Server Side
Connect your Google Tag Manager account with the Pinterest API for Conversions to find out how much Pinterest influences traffic to your store and sales of your products.
This integration requires you to deploy a server container using your preferred cloud provider and knowledge of server side tagging. For more info on prerequisites visit the
Shopify
This API for Conversions integration compliments the Pinterest Tag to ensure high data coverage and quality. As long as the Shopify app is installed, no action is required to take advantage of this enhancement. The changes will automatically be applied to the merchant’s store.
Tealium
Advertisers who are interested in Tealium, can set up the API for Conversions directly with the third party. Tealium builds the template and will help facilitate the integration with the advertiser.
The implementation process is outlined in
If you’re interested in any additional third party integrations, please reach out to your sales rep for more information.
Starting January 1, 2023, advertisers can use a Limited Data Processing flag to help them comply with the California Consumer Privacy Act, as amended by the California Privacy Rights Act (together, CCPA). With this flag in place, Pinterest will limit how we use certain data to help advertisers comply with user privacy settings. For example, an advertiser might implement the Limited Data Processing flag for California users who have opted out of the sale or sharing of their data under CCPA. When the Limited Data Processing flag is used, Pinterest will act as a service provider under CCPA with respect to flagged data from users in California.
Advertisers are responsible for complying with user opt-outs, as well as identifying the user’s state of residency when implementing the Limited Data Processing flag.