Pinterest Ads Quick Start Guide
Send advertising events directly to Pinterest Ads Conversions.
Last updated
Send advertising events directly to Pinterest Ads Conversions.
Last updated
Supports Track calls
Supports HIPAA mode
Refer to this destination as pinterest-ads in the Integrations object
Connection Modes:
| Client-side | Server-side | |
|---|---|---|
This guide enables you to fully enable the Pinterest Ads destination for your site. The guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow this guide.
Enable the Freshpaint Pinterest Ads destination
If in HIPAA mode enable the required/recommended fields
To configure your Pinterest Ads destination, you'll first need to create a conversion access token.
Open the menu in the top left corner.
In the Business column on the right click Conversions.
On the Conversions page in the left menu click API for Conversions > Conversion Access Token.
Click Generate New Token.
Copy the new conversion access token.
Take notice that you can also see your ad account ID in the paragraph, for example the demonstration ad account ID is Freshpaint (555666677123).
To configure your Pinterest Ads destination events, you'll need to find your Ad Account ID.
Open the menu in the top left corner.
In the Business column on the right click Conversions.
On the Conversions page in the left menu click API for Conversions > Conversion Access Token.
Copy the ad account ID in the paragraph, the Freshpaint ad account ID is 555666677123 .
You can also copy the Ad Account ID from the URL.
To enable the Pinterest Ads destination you simply need to enable and configure it just how you would any other destination.
Navigate to the Freshpaint Apps.
Search for the Pinterest Ads advertising destination.
Enable Pinterest Ads.
Paste in your Conversion Access Token and Ad Account ID in the integration settings.
Optional: Customers that use HIPAA mode should then configure the required properties and enable $epik.
Optional: Customers that use HIPAA mode should then configure recommended properties and enable action_source.
Navigate to the Event Library.
Select/create an event with a valid name (See list of valid names here).
In this example we are going to create an event called page_visit triggering on every page view for demonstration purposes.
At the bottom of the event page enable Pinterest Ads.
Navigate to Event Transformations.
Click the Create New button.
Select Modify Data.
Select your event (in this demo we will select page_visit) .
Select Pinterest Ads for the destination.
Set the following values for the transform fields.
Send Constant Property for transform type.
test for property name.
true or another valid action source (See here for list of valid action sources) for the property value.
True/False for the property type.
When you are done testing delete this transformation.
Open the test event panel on Pinterest Business page.
Open the menu in the top left corner.
In the Business column on the right click Conversion.
Click Test Events.
On a new tab navigate to your site and visit a page that should trigger your event (For demonstration purposes we will use FreshHealth.co).
Add a query parameter called epik to the URL (Example: https://www.freshhealth.co/?epik=TEST).
Trigger your event (Our demonstration event is page_visit).
Navigate to the Event Verification tool.
Select Pinterest Ads and verify your event went through.
This can take up to 90 seconds.
Verify the event is marked as OK or resolve missing property issues.
Verify the event appears on the Pinterest test event page.
Delete the test transformation, otherwise real events will not send to Pinterest.
Web
Mobile
Server
$epik
