Pinterest Ads Quick Start Guide

Send advertising events directly to Pinterest Ads Conversions.

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Supports forwarding from the Google Tag Manager Integration

• Refer to this destination as pinterest-ads in the Integrations object

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

Getting Started

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.

1. Find/create your Conversion Access Token

2. Find/create your Ad Account ID

3. Enable the Freshpaint Pinterest Ads destination

   • If in HIPAA mode enable the required/recommended fields

4. Create a valid event and enable Pinterest for this event

5. Set up action source

6. Set Pinterest Ads into test mode

7. Confirm and validate events

Conversion Access Token

To configure your Pinterest Ads destination, you'll first need to create a conversion access token.

1. Sign in to Pinterest Ads.

2. Open the menu in the top left corner.

3. In the Business column on the right click Conversions.

4. On the Conversions page in the left menu click API for Conversions > Conversion Access Token.

5. Click Generate New Token.

6. Copy the new conversion access token.

7. Take notice that you can also see your ad account ID in the paragraph, for example the demonstration ad account ID is Freshpaint (555666677123).

Once you generate the new token you can copy it into a safe document

Ad Account ID

To configure your Pinterest Ads destination events, you'll need to find your Ad Account ID.

1. Sign in to Pinterest Ads.

2. Open the menu in the top left corner.

3. In the Business column on the right click Conversions.

4. On the Conversions page in the left menu click API for Conversions > Conversion Access Token.

5. Copy the ad account ID in the paragraph, the Freshpaint ad account ID is 555666677123 .

6. You can also copy the Ad Account ID from the URL.

Take note that you can see the Ad Account ID 555666677123

Take note of the Freshpaint Ad Account ID in this text.

Enable the Pinterest Ads Destination

To enable the Pinterest Ads destination you simply need to enable and configure it just how you would any other destination.

1. Navigate to the Freshpaint Apps.

2. Search for the Pinterest Ads advertising destination.

3. Enable Pinterest Ads.

4. Paste in your Conversion Access Token and Ad Account ID in the integration settings.

5. Optional: Customers that use HIPAA mode should then configure recommended properties and enable action_source and $epik.

Enabling recommended properties

1. Optional: If tracking view-through conversions, enable the recommended view-through conversion properties. Pinterest recommends enabling all 3 properties for the highest quality event data, but requires at least one of either email or a combination of $ip and $user_agent to process conversion events. Read more about Pinterest event quality scoring here.

Allowlisting recommended VTC properties

Enable Pinterest Ads Events

1. Navigate to the Event Library.

2. 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.

3. At the bottom of the event page enable Pinterest Ads.

Creating an event with a valid name

Enabling Pinterest Ads for the event

Put Pinterest Ads Destination in Test Mode

1. Navigate to Event Transformations.

2. Click the Create New button.

3. Select Modify Data.

   • Select your event (in this demo we will select page_visit) .

   • Select Pinterest Ads for the destination.

4. 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.

5. When you are done testing delete this transformation.

Enabling test mode

Confirm and Validate Conversions in Pinterest

1. Put the Pinterest Ads destination into test mode.

2. Open the test event panel on Pinterest Business page.

   1. Sign in to Pinterest Ads.

   2. Open the menu in the top left corner.

   3. In the Business column on the right click Conversion.

   4. Click Test Events.

3. 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).

4. Add a query parameter called epik to the URL (Example: https://www.freshhealth.co/?epik=TEST).

5. Trigger your event (Our demonstration event is page_visit).

6. Navigate to the Event Verification tool.

7. Select Pinterest Ads and verify your event went through.

   • This can take up to 90 seconds.

8. Verify the event is marked as OK or resolve missing property issues.

9. Verify the event appears on the Pinterest test event page.

10. Delete the test transformation, otherwise real events will not send to Pinterest.

Our Pinterest Ads event went through smoothly with all required properties in place

Our event is looking good on the Pinterest test event page