Introduction
Raptor's Customer Data Platform (CDP) integrates with Pinterest Business. From the CDP, it is possible to synchronize audiences to Pinterest for advertisement use. The audiences can also be used for look-a-like targeting, re-targeting etc.
How it works
1. General Information
In Raptor you will find a template created to assist the integration setup. To create the Pinterest Activation, go to “Customer Data Platform --> Activation --> Create New Activation --> Pinterest”.
Type in Name, Description and select the preferred person identifier - in Pinterest this would be Email - then click Next.
2. Pinterest Information
Only two pieces of information is needed on this stage - the AdAccount ID, and a Refresh Token. The later, however, is deceptively tricky to acquire, and a fair bit of setup is also required within your Pinterest account in order to make the connection work.
However, the AdAccount ID is, at least, fairly easy to find. Simply go to your Pinterest account, log in, open the account-dropdown in the upper left corner, and - if necessary - switch to the Ad accounts tab. The ID will be shown there, and can easily be copied into the specified Activation field.
Conveniently, this also means that you have now logged onto Pinterest, which you will need to be in order to make the necessary adjustments there, and in the process, acquire a viable Refresh Token.
3. Pinterest Authentication and Access Token Acquisition
Now, for the hard part. Please follow this guide carefully.
- Make sure you are still logged into your Pinterest Business Account from the previous section.
- Follow this link: OAuth 2.0 Authentication
- You will arrive at an Authorize app dialogue, requesting that you give Raptor access to your profile. Simply click on the Give access button.
- You will now be redirected to Google.com - however, it is crucial that you do not navigate elsewhere from here! Instead, look at the URL in the address-bar. After the usual address, you will find a segment marked as ?code= - you need to copy this number. Note that this code will expire after a certain span of time, so you will need to carry out the remaining steps in a timely fashion. Otherwise, you will need to redo this step and get a fresh code.
- For the next step, you will need a tool that allows for the automatic delivery of HTTP requests - we recommend Postman, but if you are already used to another system, that will likely work as well. Note that if you use a different app, you will likely need to adjust the next couple of steps a fair bit.
- Set up the app to fire off an HTTP request - the Post option - with the target being https://api.pinterest.com/v5/oauth/token
- In the Parameters section, select Body, the x-www-form-urlencoded radio-button, and then add three lines. grant_type with a value of authorization_code, code with the value being the code you copied down in Step 4, and redirect_url with a value of https://www.google.com/
- Switch to the Authorization tab. For Auth Type, select Basic Auth. As Username, enter 1496726. As Password, enter - or, alternately, copy and paste - 709c3824cc1924cd118e748024e62ad6220ac555.
- Finally, click on Send. If everything has been set up correctly, the result-field at the bottom of the screen will now display a number of lines, with one being labeled refresh_token. This rather long figure will need to be copy-pasted into the Raptor Activation interface, alongside the Ad Account ID that was fetched from your Pinterest-account earlier.
4. Finishing up
The final step is to add Audiences to the new Activations - one or multiple, which will be synchronized to your Pinterest-account. When a person enters/leaves this Audience, the Pinterest activation is automatically updated in real-time. Then, simply hit Save to engage the Activation - it will take around 5 minutes for it to start up, and it should run smoothly from there.