Unified Analytics Export API

Overview

Unified Analytics has been a great tool for viewing campaign data from all attribution methods in a single view. Now you can get this valuable data in your data warehouses using the Unified Analytics Export API!

The Unified Analytics Exports API introduces a new data_source called skan_unified_view.

Common Use Cases

Export your unified total conversions.
Compare SKAdNetwork and Non-SKAdNetwork total counts.
Compare SKAdNetwork and Non-SKAdNetwork revenue.

Access

Access to Unified Analytics Exports requires our Advanced Data Feeds add-on.

The Advanced Data Feeds add-on also includes access to:

The Scheduled Log Exports API.
The Cross-Events Export API.
Data integrations for exports.
Webhook functionality.

Learn more on our packaging page.

Examples

Export Unified Complete Registrations by Campaign ID

Request (cURL)

Response After Decompression (JSON)

curl --request POST \
     --url 'https://api2.branch.io/v1/branch_aggregate/async/analytics?app_id=123456789' \
     --header 'Access-Token: api_app_123456789abcdefghi' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "filter": {
    "type": "selector",
    "dimension": "name",
    "value": "COMPLETE_REGISTRATION"
  },
  "granularity": "all",
  "response_format_compression": "gz",
  "response_format": "json",
  "start_date": "2024-04-28",
  "end_date": "2024-05-05",
  "dimensions": [
    "name",
    "last_attributed_touch_data_tilde_campaign_id"
  ],
  "aggregations": [
    {
      "field_name": "unified_total_count",
      "data_source": "skan_unified_view",
      "display_name": "total_count"
    }
  ]
}
'

{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"1624766361","total_count":1.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"452798654","total_count":2197.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"7ceb4624-b7a8-43c1-8c95-247fd3ffa582","total_count":274.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"120206639272860749","total_count":2091.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"1797766853010482","total_count":10.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"2dd25d10-d388-4ecf-894e-2b68b2185708","total_count":15.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"671357963","total_count":607.0}
{"name":"COMPLETE_REGISTRATION","last_attributed_touch_data_tilde_campaign_id":"40790","total_count":1.0}

Compare Facebook Only SKAdNetwork and Non-SKAdNetwork Installs

Request (cURL)

Response After Decompression (JSON)

curl --request POST \
     --url 'https://api2.branch.io/v1/branch_aggregate/async/analytics?app_id=123456789' \
     --header 'Access-Token: api_app_123456789abcdefghi' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "filter": {
    "type": "and",
    "fields": [
      {"type":"selector","dimension":"last_attributed_touch_data_tilde_advertising_partner_name","value":"Facebook"},
      {"type":"selector","dimension":"name","value":"INSTALL"}
    ]
  },
  "granularity": "all",
  "response_format_compression": "gz",
  "response_format": "json",
  "start_date": "2024-04-28",
  "end_date": "2024-05-05",
  "dimensions": [
    "name",
    "last_attributed_touch_data_tilde_advertising_partner_name"
  ],
  "aggregations": [
    {
      "field_name": "skan_count",
      "data_source": "skan_unified_view",
      "display_name": "SKAN_Count"
    },
    {
      "field_name": "non_skan_unique_count",
      "data_source": "skan_unified_view",
      "display_name": "Non_SKAN_Count"
    }
  ]
}
'

{
  "name": "INSTALL",
  "last_attributed_touch_data_tilde_advertising_partner_name": "Facebook",
  "Non_SKAN_Count": 706086,
  "SKAN_Count": 29
}

Appendix

Dimensions

General

Last Attributed Touch

User Data

Event

app_id
attributed
name
timestamp

last_attributed_touch_data_dollar_3p
last_attributed_touch_data_tilde_advertising_partner_name
last_attributed_touch_data_tilde_campaign
last_attributed_touch_data_tilde_campaign_id
last_attributed_touch_data_tilde_feature

user_data_platform

event_timezone_adjusted_day
event_days_from_timestamp

Data Source + Field Name

`data_source`	`field_name`
`skan_unified_view`	- `skan_count` - `skan_revenue` - `non_skan_revenue` - `unified_revenue` - `non_skan_total_count` - `unified_total_count` - `non_skan_unique_count` - `unified_unique_count`