This guide will walk you through how to setup your campaigns with Pinterest using Branch Universal Ads and track ad conversions across every device, platform, and channel.

1. Complete Universal Ads Prerequisites



The following Universal Ads prerequisite includes providing URI schemes and other components that may require a developer:



The following Universal Ads prerequisites involve app code changes:

2. Enable the Integration

  1. Visit the Ads page on the Branch dashboard.
  2. Select Partner Management from the sidebar.
  3. Search for your Universal Ads Partner.
  4. Select Pinterest and hit Save & Enable.

3. Enable Postbacks

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

You can then add additional postbacks, for example, if you wanted to add postbacks for custom events that are specific to your app like Account Created.

You can also edit postbacks if there's additional data you really need to pass along to your ad partner.


Using Custom Events

It's required by Pinterest to map event names to Pinterest's pre-defined event names. We have already mapped standard events, but for any Custom events - you have to work with Pinterest team on event mapping.

Make sure that you updated event_type parameter in the postbacks body and replaced it with the Pinterest specific event name.
Example: "event_type": "pin_purchase"

3a. Resetting Postbacks

There may be times when you need to reset a partner's settings; i.e. when a partner updates their postback templates or when perhaps you've made a mistake during partner setup. Resetting a partner's settings allows you to re-enable the partner integration with the correct information to accurately measure and attribute conversion.


Disables Ad Partner

Resetting partner settings will:

  • Disable the ad partner.
  • Clear out all of your saved credentials and postbacks that are already setup.
  • Return the ad partner to its basic configuration.

To reset a Pinterest's postbacks:

  1. Click on the Account Settings tab.
  2. Click the Reset All Settings button in the right-hand corner.

3b. Using the Pinterest Tag ID

To use your Pinterest Tag ID:

  1. Under Partner Management, select the partner for whom you want to add/edit their postback.
  2. Click on the Postback Config tab on said partner’s page.
  3. Click the Add New Postback button at the bottom of the screen.
  4. A modal will appear with Branch default events, as well as any commerce (reserved events like PURCHASE) or custom events you've set up. Select an event, enter a postback URL if you're asked to, and click Save. This will be the event that triggers your new postback.
  5. Once the postback has been added, input your Pinterest Tag ID in the PINTEREST_TAG_ID field.
  6. Click Save.


Pinterest Campaign Setup

When creating your Pinterest ad campaign, make sure to:

  1. Use a direct link to the Apple Store or Google Play Store in the Destination URL field.
  2. Remove $idfa_sha1={sha1_advertising_id} from your Branch Link if your Destination URL goes to the Google Play Store.
  3. Remove $aaid_sha1={sha1_advertising_id} from your Branch Link if your Destination URL goes to the Apple Store.
  4. Place your Branch link in the Click Tracking URL.
  5. Avoid using the View Tracking URL until further notice.


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


Impression Tracking Link


Since Pinterest uses 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 current can’t provide 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.

Updated about a month ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.