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.


Integrating the SDKs and tracking in-app events

The Branch SDKs for iOS and Android allow you to get up and running quickly.

If you haven't already integrated Branch SDK into your application, please follow our integration guide to integrate Branch SDK into your application:

  1. Documentation for Android

  2. Documentation for iOS

Limitations with setDebug and seeing data in Branch

When integrating the SDKs, it's often useful to use setDebug to verify that your app is able to communicate with Branch servers, and is receiving deep link data. However, our upstream systems don't register test events sent using setDebug, so events will not appear in Liveview or Analytics, nor will they fire postbacks. You should disable setDebug when looking at Liveview or testing postbacks.

Track conversion events

Install and open events are automatically tracked using just the Branch SDK integration. However, to track custom events, such as registration or purchase, you will need to integrate them into your application.

Sending event metadata from your application

Please make sure that you setup and pass event metadata from the application to the ad partner. Follow up with your ad partner to get the list of required parameters.

Please reference the general V2 Event Tracking Guide. This will help ensure that you've integrated the right Branch events with the correct metadata.

Testing your events with Liveview

You can test your integration by going to our Liveview page. Set a filter with the event name to verify that the Branch SDK is recording each event.

Enable the integration

  1. Visit the Ads page on the Branch dashboard.
  2. Select Partner Management from the sidebar.
  3. Search for Pinterest and click Enable.


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 the Pinterest Tag ID

When using the Pinterest Tag ID, please ensure you include it in the event postbacks:

  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. Hover on the Actions button and click Advanced Edit.
  6. Navigate to the Body section and replace PINTEREST_TAG_ID with your Pinterest Tag ID.

Create an ad link

Once you've enabled an integration it's time to create a tracking link.

  1. First click Create Ad Link and select an ad format. For App Install or App Engagement campaigns you'll want to select the App Only format. For campaigns where the user should go to web if they don't have the app, then you should select Cross-Platform Search or Cross-Platform Display. Product Links are for shopping or dynamic re-marketing campaigns.


  2. Make sure the following required information is selected:

    • Name your Link
    • Which Ad Partner is this for?
    • What ad format are you using?
    • Select OS type

3.Click Configure Options to continue.

  1. This is your chance to add deep link data and analytics tags. Analytics tags are important for later segmentation, so click the Analytics sub tab to add a Channel and Campaign value.


Set Analytics tags

It's easier to slice your data in our analytics platform if you properly assign analytics parameters to your link. Channels generally correspond to ad networks, and Campaigns correspond to marketing initiatives that you're launching. For example: Channel: YouTube, Campaign: Summer 2017 Shoe Discounts.

Links Created by Agency Users

When an Agency user saves an ad link/Journey/Quick Link, that ad link/Journey/Quick Link is associated with that Agency via a unique agency_id that is included as a key-value in deep linking setup.

  1. Click Create Link Now, and you have your tracking link!


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


Viewing Your Data

The Ads Analytics Page on the Branch dashboard provides an interactive time series graph and table to view the performance of your Ad campaigns:

  • Easily interact with your Analytics data breakdown and compare aspects of your Ad campaigns' performance by using the Compare by button to add a parameter to split the data displayed data by.
  • You can also use the Add Filter + button to refine the data displayed to gain deeper insight into the performance of your Ad campaigns.

The TRENDS table shows the chart and breakdown of last 7 days data on the campaign performance by ad partner.

Example Ads Analytics Graph

The EVENTS table shows summary data on the performance of each Ad campaign.

Example Ads Table

On the top right side of the table you can find a download button to retrieve the chart's content as a CSV file. For more info about Ads Analytics refer here.

Advanced Setup

Please refer to our Advanced Universal Ads guide for advanced options when enabling a Universal Ads partner.


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 19 days ago


Suggested Edits are limited on API Reference Pages

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