Skip to content
Get Help

Ad Partner Cost Import Overview (New)

Overview ​

Cost data is the amount of money spent on ad campaigns, and that value is required to make ad optimization decisions in the mobile marketing ecosystem. With Branch, you can bring your cost data from across disparate ad partner sources together in one place and ensure optimal use of your investment dollars.

Branch also makes it easy to monitor the status of each of your ad partner connections, so you can find and fix issues quickly.

Currently, Branch supports over 20 of the largest and most commonly used ad partners via direct API integration. If we don't support a direct integration with an ad partner, you can still send their data to Branch via file upload or email ingestor.

Note: this guide is for new Branch

In the legacy Branch experience, cost data ingestion through API connection, file upload, or email ingestion was called ROI Hub. In the new Branch experience, ROI Hub has been replaced by the Cost Import tab. Please note that this guide is about cost data in new Branch. For information on ROI Hub in legacy Branch, visit our legacy guide.

Access ​

Access to cost data features requires a premium plan. Please contact our Sales team to learn more about pricing and availability.

View cost data status ​

In the new Branch experience, cost data is managed per ad partner. Instead of a single centralized import area, each ad partner's page includes everything you need to connect, import, and monitor cost data for that partner. The sections below describe where to find each piece.

To get started, go to Configuration > Integrations > Ad Partners. This page is your central hub for managing all ad partner connections.

Below the metrics, a searchable card grid displays all available integrations, each with a status badge of either Enabled (green) or Needs setup (gray). Use the My partners button to narrow the list.

Partner status tab ​

Select a partner card to open that partner's page. The Status tab provides a real-time view of your integration health, including a Cost Data feature card showing whether cost data is Enabled (green) or Needs setup (gray). Select the Cost Data feature card or select the Cost Import tab to start cost ingestion setup for that ad partner.

Below the feature cards, each connected ad account displays a table that includes a Cost data row with its sync status, import method, and the time of the last pull and last successful pull.

Cost Import tab ​

The Cost Import tab on each partner's page is where you import cost data for partners without a direct API integration. From here you can:

  • Upload a CSV file containing cost data. Column mapping happens right on the import page, so no separate file template is required.
  • Set up an email ingestor that generates a unique email alias your ad partner can send scheduled cost data to.
  • Review the Import history table, which records all past imports. Select Details on any row to view the full import metadata.

Import cost data ​

To learn about the three methods for importing cost data into Branch (API connection, file upload, and email ingestor) and the requirements for each, visit our guide on importing ad partner cost data. For the list of ad partners that Branch has direct API integrations with, visit our guide on importing cost data via API connection.