Overview

Pinterest is a visual discovery engine for finding ideas like recipes, home and style inspiration, and more.
With billions of Pins on Pinterest, you'll always find ideas to spark inspiration. When you discover Pins you love, save them to boards to keep your ideas organized and easy to find.

PARTNER CAPABILITIES

Prerequisites

In order to enable Pinterest for your Branch account, you need to have completed the following:

1. Created a Branch Dashboard.
2. Enabled Universal Ads for your Branch account.
   1. Contact your Branch account manager or visit https://branch.io/pricing
3. Implemented the Branch SDK into your mobile app (iOS | Android)
   1. Track events
4. Admin, Analyst, Audience, or Campaign Business Access to your Pinterest Account.

Enable Pinterest

1. Retrieve IDs/Tokens from Pinterest

Retrieve Ad Account ID

In the Pinterest Dashboard, navigate to the Business Access page > Assets > Ad accounts. Use this to find your Ad Account ID.

Retrieve Conversion Token

If you do not have a Conversion Token already created, navigate to the Business Access page > Ads > Conversions > Conversion Access Token > Generate. Use this to generate the conversion access token.

2. Connect Pinterest in Branch

• Visit the Ads page on the Branch Dashboard. In the Branch Dashboard, visit Ads > Partner Management
• Find/Search for Pinterest.
• Enter the ID and Token from the previous step into the corresponding fields
• Select Pinterest, and click the Save & Enable button.

3. Configure Postbacks

After connecting Pinterest to Branch, navigate to the Postback Config tab. When a conversion/event attributed to an ad campaign occurs, Branch notifies the Ad partner of these events via postbacks which are turned on when you enable any Universal Ads integrated partner (Postback Config tab of the ad partner)

Basic postbacks will automatically be activated for events like INSTALL and PURCHASE when you enable your ad partner.

Default Event Mappings

👍

Postbacks

For more details on configuring Postbacks, view our guides:

• Basic Postback Configuration
• Advanced Postback Configuration
• Postback Testing

4. Configure Attribution Windows

After configuring postbacks, navigate to the Attribution Windows tab to set windows by attribution type.

You can use custom attribution windows to match Pinterest's attribution windows. This overrides your app-level attribution windows.

5. Verify Integration Setup

After configuring attribution windows, navigate to the Postback Testing tab to test your integration.

help.branch.io

Test Postbacks

6. Create a Branch Link

If you are running paid advertising campaigns, you'll want to create a Branch Ad Link so we can accurately attribute resulting app conversions to the appropriate advertising partner.

help.branch.io

Create Ad Links

7. Create a Campaign

1. Use a direct link to the Apple Store or Google Play Store in the Destination URL field.
   1. Remove $aaid_sha1={sha1_advertising_id} from your Branch Link if your Destination URL goes to the Apple Store.
   2. Remove $idfa_sha1={sha1_advertising_id} from your Branch Link if your Destination URL goes to the Google Play Store.
2. Place your Branch Click Tracking Link in the URL field for the campaign Event Type.
3. Place your Branch Impression Tracking Link in the URL field for Impressions Event Type.

8. Verify Data Sent

Once the above steps are complete, you are ready to start launching campaigns. Branch-attributed conversions enabled as postbacks will be sent to Pinterest if they were the last touch that drove the conversion.

To verify data is being sent from Branch to Pinterest, you can look at the Branch Dashboard's Liveview Webhook Records, and apply the following filter:

Troubleshoot

If you are running campaigns on Pinterest and having issues with Attribution on Branch, please check if you are using correct tracking links:

1. Link to the Apple AppStore or Google Play.
2. Click and Impression links, generated on Branch Dashboard, configured as described below.

Verify Link Formatting

Click Tracking Link

https://branchster.app.link/9kLGbtxJo2?%243p=a_pinterest&&%24idfa_sha1={sha1_advertising_id}&%24s2s=true&~ad_set_id={ad_group_id}&~ad_set_name={ad_group_name}&~campaign={campaign_name}&~campaign_id={campaign_id}&~click_id={click_id}&~creative_id={creative_id}&~creative_name={creative_name}&~secondary_publisher={publisher](https://branchster.app.link/9kLGbtxJo2?%243p=a_pinterest&%24aaid_sha1={sha1_advertising_id}&%24idfa_sha1={sha1_advertising_id}&%24s2s=true&~ad_set_id={ad_group_id}&~ad_set_name={ad_group_name}&~campaign={campaign_name}&~campaign_id={campaign_id}&~click_id={click_id}&~creative_id={creative_id}&~creative_name={creative_name}&~secondary_publisher={publisher)

Impression Tracking Link

https://impression.link/impression?branch_key=key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL&%243p=a_pinterest&%24s2s=true&%24aaid_sha1={sha1_advertising_id}&~ad_set_id={ad_group_id}&~ad_set_name={ad_group_name}&~branch_ad_format=App%20Only&~campaign={campaign_name}&~campaign_id={campaign_id}&~click_id={click_id}&~creative_id={creative_id}&~creative_name={creative_name}&~feature=paid%20advertising&~secondary_publisher={publisher](https://impression.link/impression?branch_key=key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL&%243p=a_pinterest&%24s2s=true&%24aaid_sha1={sha1_advertising_id}&~ad_set_id={ad_group_id}&~ad_set_name={ad_group_name}&~branch_ad_format=App%20Only&~campaign={campaign_name}&~campaign_id={campaign_id}&~click_id={click_id}&~creative_id={creative_id}&~creative_name={creative_name}&~feature=paid%20advertising&~secondary_publisher={publisher)

Since Pinterest users server-to-server clicks, make sure the following parameters are always present on the link:

• %24s2s=true
  • Must be always present on the link
• %24aaid_sha1={sha1_advertising_id}
  • For Android campaigns only, must be removed from the link for iOS campaigns
• %24idfa_sha1={sha1_advertising_id}
  • For iOS campaigns only, must be removed from the link for Android campaigns
    Only one OS-specific Advertiser Identifier parameter must be on the link: either %24idfa_sha1 for iOS or %24aaid_sha1 for Android campaigns.

Most Common Issues

• Advertiser ID is missed on the link
  • Solution: Add OS-specific Advertiser Identifier
• Both Advertiser IDs presented on the link
  • Solution: Keep only one OS-specific Advertiser Identifier
• Clicks are getting blocked by Branch Anti-Fraud rule - GEO_CONFLICT
  • Pinterest currently can’t provide the user’s IP address and this can cause a GEO_CONFLICT Fraud Rule. If you use a GEO_CONFLICT fraud rule, we recommend either disabling it or not running on Pinterest until they are able to pass the client IP to MMPs.