Skip to Content
SourcesBranchOverview

Branch

Source — Vendo imports install attribution data from the Branch Daily Exports API.

What Vendo Syncs

Install Attribution Data

FieldDescription
TimestampWhen the install happened (Unix epoch)
CampaignAttributed campaign name
Campaign IDCampaign identifier
ChannelMarketing channel
FeatureBranch feature tag
Ad Set NameAd set / ad group
Ad NameAd creative name
Click TimestampWhen the attributed click/touch happened
Device IDIDFA (iOS) or AAID (Android)
CountryUser’s country
OSiOS or Android

Device Properties

PropertyDescription
IDFAiOS advertising identifier
AAIDAndroid advertising ID
IDFViOS vendor identifier
OSOperating system
CountryGeo country
LanguageDevice language
EnvironmentApp environment

Identity Resolution

Branch provides device-level identifiers (IDFA/AAID) that Vendo joins with your identity graph:

  • IDFA (iOS) and AAID (Android) are matched against the identity graph
  • Matched installs are linked to their cross-platform vUID (Vendo User ID)
  • Post-ATT installs without IDFA remain in the dataset but without identity links

Unified Mobile Schema

Branch data is normalized into the mobile_installs table alongside AppsFlyer and Adjust data for cross-MMP analysis.

Setup

  1. Log into your Branch Dashboard
  2. Navigate to Account Settings
  3. Copy your Branch Key (starts with key_live_ or key_test_)
  4. Copy your Branch Secret
  5. Ensure Data Feeds is enabled (requires Data Feeds subscription)
  6. In Vendo, go to AppsAdd AppBranch
  7. Paste your Branch key and secret
  8. Create a source and trigger your first sync

Requirements

  • Data Feeds subscription required (Branch paid feature)
  • Admin access required in Branch dashboard
  • Data Export API must be enabled via Data Feeds Manager

API Details

SettingValue
APIDaily Exports API (async)
AuthAccess-Token header
Sync FrequencyDaily
Data FormatGzipped CSV (S3 presigned URLs)
Export ProcessSubmit → poll → download
Historical Data7 days (full device IDs), older data has hashed fields

How It Works

Branch uses an async export pattern:

  1. Vendo submits an export request for install events
  2. Branch processes the export and returns S3 download URLs
  3. Vendo downloads the gzipped CSV files
  4. Data is parsed, normalized, and loaded into BigQuery

Export processing typically takes 1-10 minutes depending on data volume.

BigQuery Tables

TableDescription
branch_{id}_installsRaw Branch export data
branch_{id}_mobile_installsNormalized unified schema
Last updated on