mDSP
 
 

Branch Integration Guides

Enable event forwarding

Map your Branch events to mDSP via postbacks to provide the data necessary for campaign optimization.

  1. Log in to your Branch account.
  2. Navigate to Partner Management from the sidebar.
  3. Search for mDSP and select it as a partner.
  4. Click Save.
Partner Management
  • Verify basic postbacks: Events like Install and Purchase activate automatically when you enable an ad partner.
  • Manually enable other events: You must manually toggle any other relevant funnel events.
  • Make sure to check the All Events box to share organic data with mDSP.

Generate the trackers

    1. Select the Links section from the sidebar menu.
    2. In the App Only section, select App Install or Engagement. Use this for both User Acquisition and Retargeting campaigns.
  1. In the Name your link section, enter a name that is easy to identify for tracking in dashboards (e.g., mDSP_Install_US_Q4_2026).
  2. Ensure mDSP is selected in the Which Ad Partner is this for? box.
  3. In the Which ad format are you using? box, select App Only.
  4. Click Create Link Now to create the tracker.

⚠️ Leave Channel/Campaign /Tags and Analytics Tags as default.

  1. Copy the generated tracking links and send them to your mDSP Customer Success Manager.
  2. If you are only running User Acquisition, check the box for Only attribute based on install touch. If you are running Retargeting or Full Funnel campaigns, leave this box unchecked.

⚠️ Important: Make sure to check the Household Measurement option. This feature is part of Branch's Performance Pro package and requires developer support to be enabled. It tracks cross-screen conversions across household devices such as CTV, mobile, desktop, and tablets.

Verify attribution windows

We recommend sharing your attribution rules

  • Go to Ads > Partner Management > mDSP > Attribution Window.
  • Toggle Use ad partner attribution settings to the On position.
  • Take a screenshot of the Attribution Windows page and share it with your mDSP contact to verify that everything looks okay.

Granting partner access

Follow these steps to authorize mDSP to access your specific trackers and data logs within Branch.

  1. Open the Account Settings section from your Branch dashboard.
  2. Click on the Agencies tab.
  3. Click the Add New Agency button and select mDSP from the dropdown menu.
  4. Select Admin level access to allow mDSP to export data and verify settings. If you prefer Custom permissions, ensure you match the required settings below.
  5. Check the Export box so mDSP can download the necessary logs.
  6. Ensure Only show agency-tagged data is toggled OFF. If this is enabled, mDSP will not be able to see any data.
  7. Check both Fraud Settings & Data and Sensitive Data to enable ID matching at the impression level.
  8. Click Continue. mDSP admins will receive an email to accept the invitation on behalf of mDSP.

Configure API credentials

To finalize the connection between mDSP and Branch, you must authenticate your account and enable cost data sharing.

Get user credentials (API Keys)

  1. In your mDSP Dashboard, go to the Credentials section.
  2. Note:
    • If you do not have dashboard access, contact your mDSP Customer Success Manager.
  3. Generate a set of credentials consisting of a Description, Client ID, and Client Secret.
  4. Tip:
    • Create a unique API key for each integrated service so you can manage or revoke access individually. You can generate as many credentials as you need.
  5. Navigate to the Applications section and copy the unique ID for each app you want to share data for.

Enable cost data sharing in Branch

  1. In Branch, go to Ads > Partner Management and search for mDSP.
  2. Select the Cost Data tab.
  3. Enter your mDSP Ad Account ID and Token ID.
  4. Click Save Authentication.

Data synchronization typically takes 24 hours before spending details appear on your Branch dashboard.