👍
Try it!
Try out the Custom Exports API using your Branch data via the API reference here

Overview

Benefits of Custom Exports API

The Branch Custom Exports find and queue log records that match your search criteria for export. You can do so either via the Custom Exports section in your Branch Dashboard or via the API (this page).

API Limitations

Limitation	Details
Data Availability	The data will be available around 2-3 hours behind real-time
Max number of records returned by API	2 Million 더 많은 레코드가 필요한 경우 요청당 조회기간을 더 짧게 설정하여 여러번으로 나누어 추출할 것을 권장합니다. In some cases, Branch can increase the number of records above 2 million. Please contact Support to request an increase.
Max number of days that can be queried at a time	60
Export Window	Rolling 120 day window
Rate Limit for creating exports*	분당 요청 10개 25 requests per hour
Rate Limit for checking the status of a report*	50 requests per minute 1000 requests per hour
Exporting from test environments	At this moment, it is not possible to export data out of a Branch Test environment
Repeated requests within 60 minutes will be cached	If you make identical requests within 60 minutes of each other, you will not see multiple export jobs running. Instead, the same export job will be used. If you are using the API, the same job_id will be returned. This is to avoid the case of hundreds or thousands of requests being made for the exact same data set, within seconds or minutes of each other. After 60 minutes, your request will kick off a new job to retrieve data.

*You will get the following response once you've hit the rate limit:

{
    "errors": [
        {
            "message": "Limit is exceeded for org-525983469347282987, retry after 3418 seconds",
            "error_code": 7
        }
    ]
}

Prerequisites & API Access

In order to use the Custom Exports API, you need to have completed the following:

Created a Branch Dashboard
Implemented the Branch SDK into your mobile app (iOS | Android)
- Track events.
Opt into sharing device data through Apple's AppTrackingTransparency framework. When an install is attributed to paid ads, a 2nd install event will fire post user opt-in.

🚧
Data Changes Post iOS
Opt-ins will affect your final install count. We recommend using a different identifier (ex. IDFV) to de-dupe install events on your internal systems.
For additional information on changes post iOS 14.5, visit our FAQ Pages

Logged into the Branch Dashboard with the Sensitive Data and Export Access Permission enabled.

대행사에 API 접근권한 제공하기

계정의 API 키에 접근할 수 있는 모든 사용자는 Branch의 Custom Exports API (및 필터링을 거치지 않은 로그 레벨 데이터)에 접근할 수 있습니다. 따라서 써드파티를 Branch대시보드의 사용자로 초대할 때 API키를 열람할 수 있는 권한을 제공하지 않는 것이 좋습니다.

🚧
Data Purge

Branch will purge last-attributed data after 60 days.

광고 캠페인을 운영하는 에이전시와 협력하며 후속 데이터를 내보낼 수 있는 액세스 권한을 부여하려는 경우 커스텀 Export API에 대한 액세스 권한을 제공할 수 있습니다. 대행사와 협력하여 광고 캠페인을 운영하고 이를 통해 발생한 데이터에 대한 추출할 수 있게 한다면 Custom Exports API에 대한 접근권한을 제공할 수 있습니다.

대행사에게 Custom Exports API에 대한 접근권한을 제공하려면 다음과 같이 진행할 수 있습니다.

In the left-hand navigation, under Configure, click on Account Settings.
On the Account Settings page, click on the Agencies tab.
Expand the agency in question, find the agency team member you want to give access to, hover on the button in the Actions column and click Edit.
In the Edit Agency Team Member modal:
1. Under Access Level, check the Export box.
2. Under Permissions, check the Sensitive Data box.
선택 사항: 데이터 필터 추가
1. Under Data Filters, toggle any necessary data filters on/blue. Exported data will be filtered accordingly.
Save를 클릭합니다.

🚧
대행사 태그 데이터
Only show agency-tagged data 필터를 활성화하지 않은 경우 대행사 맴버는 해당 대행사 데이터뿐만 아니라 모든 캠페인에 대한 민감한 데이터를 추출할 수 있게 됩니다

권한인증

Calls to the Custom Export API require an access token parameter to be passed with each request. Access tokens are generated on a per-user basis and are permanent.

Learn how to retrieve your Access Token (a.k.a. an API Key).

API Usage

Create Export Request

POST /v2/logs?organization_id=ORG_ID
POST /v2/logs?app_id=APP_ID
Headers:
Access-Token: API_KEY
Content-Type: application/json
Body: JSON parameters
Host: api2.branch.io

Request Headers:

Header	설명	필수
Access-Token	Key that encapsulates the user's permission w.r.t an org. Obtained from the Branch Dashboard needed for authentication.	예
Content-Type	application/json	예

Request Body Parameters:

파라미터	유형	설명	필수
start_date	날짜	The beginning datetime for the requested results, provided in ISO-8601 format including Hours, Minutes, Seconds and Milliseconds. 오프셋(예, 타임존)이 추가되지 않은 날짜는 디폴트로 timezone파라미터에 설정한 타임존이 적용됩니다. 타임존 파라미터가 지정되지 않았다면 날짜의 타임존은 UTC로 설정됩니다.날짜는 반드시 지난 120일 이내여야 합니다. 예: 2016-01-01T00:00:00Z	예
end_date	날짜	The end datetime for the requested results, provided in ISO-8601 format including Hours, Minutes, Seconds and Milliseconds. 오프셋(예, 타임존)이 추가되지 않은 날짜는 디폴트로 timezone파라미터에 설정한 타임존이 적용됩니다. 타임존 파라미터가 지정되지 않았다면 날짜의 타임존은 UTC로 설정됩니다. 예: 2016-01-01T23:59:59:999Z	예
report_type	String	The Branch EO topic to be exported.	예
fields	쉼표로 구분된 목록	List of comma-separated fields desired in results.	예
limit	정수	Limit the number of items returned per request. Maximum allowed value is 2 million. If more than 2 million records are required, please make multiple requests with smaller time intervals to pull the data needed in “batches”.	예
timezone	String	결과의 시간대. 'America/Los_Angeles'와 같은 tz 데이터베이스 string을 허용합니다. Optional parameter; results are returned in the dashboard timezone if not provided. Will default to UTC only if dashboard timezone is not set.	아니오
filter	쉼표로 구분된 목록	Filter by fields and boolean operators against fields of the LogInstalls model; must be URI encoded and JSON parsed. Example: ["gt","last_attributed_touch_timestamp", 1604015756]	아니오
response_format	널(Null) 가능 string	응답형식. "json" 또는 "csv" 중 하나를 선택할 수 있습니다. 선택하지 않으면 기본값은 CSV입니다. Branch는 CSV파일에 대해 UTF-8 인코딩을 적용합니다.	아니오

Response Body Parameters:

파라미터	설명
handle	Unique request handle generated against the endpoint call.
export_job_status_url	The URL of the export request.

Example Request/Response:

curl -X POST 'https://api2.branch.io/v2/logs?app_id=123456700098765432'
    -H "Content-Type: application/json"
    -H "Access-Token: YOUR_ACCESS_TOKEN_HERE"
    -d '{"report_type": "eo_open",
            "limit": 100,
            "fields": ["timestamp","name"],
            "start_date": "2019-12-09T00:00:00Z",
            "end_date": "2019-12-09T01:59:59Z",
            "filter": ["gt","last_attributed_touch_timestamp", 1604015756]
            }'

{"handle":"1612dbb3-85ef-49f8-b1c5-5818c163600c","export_job_status_url":"https://api2.branch.io/v2/logs/1612dbb3-85ef-49f8-b1c5-5818c163600c?app_id=123456700098765432"}

Response Codes:

Response Code	설명
200	Status of aggregate export.
400	Authentication Failed.

Get Export Request

GET /v2/logs/JOB_ID
Headers:
Access-Token: API_KEY
Host: api2.branch.io

Request Headers:

Header	설명	필수
Access-Token	Key that encapsulates the user's permission w.r.t an org. Obtained from the Branch Dashboard needed for authentication.	예
Content-Type	application/json	예

Response Path Parameters

파라미터	유형	설명	필수
request_handle	String	The ID returned by the log export queue.	예

Request Query Parameters:

파라미터	유형	설명	필수
limit	정수	반환할 최대 결과의 수입니다.	아니오
format	String	Format of returned data. json or csv	아니오

Response Body Parameters

파라미터	유형	설명
code	정수	The response code.
lines_exported	정수	Number of lines exported against the originated request.
status	String	Request status over the current execution time.
status_url	String	The URL of the export request.

Example Request/Response:

curl -X GET https://api2.branch.io/v2/logs/<YOUR_HANDLE>\?app_id\=<YOUR_BRANCH_APP_ID>
  -H "Content-Type: application/json" 
  -H "Access-Token:<YOUR_ACCESS_TOKEN>"

{"code":200,"lines_exported":2000000,"status":"complete","response_url":"https://branch-exports-web.s3.amazonaws.com/732662944269095814-eo_open-2019-12-10-2019-12-10-1612dbb3-85ef-49f8-b1c5-5818c163600c-bUlN2lwyTE10qIVH.csv?Signature=YOUR_ACCESS_TOKEN_HERE&AWSAccessKeyId=YOUR_ACCESS_TOKEN_HERE&Expires=1577305615"}

Response Codes:

Response Code	설명
200	Status of aggregate export
400	Authentication Failed
404	Job ID Not Found

Status Values:

상태	설명
`pending`	Request is pending.
`running`	Request is still running.
`complete`	Request is complete.
`fail`	Request failed.

부록

Available EO Fields

Fields	유형	설명
app_id	롱(Long)	App ID (capitalize ID in Liveview)
app_name	String	App Name
어트리뷰션된	불리안(Boolean)	Attributed
content_items	ArrayStruct	Content Items
custom_data	MapStringString	커스텀 데이터
customer_event_alias	String	Customer Event Alias
days_from_last_attributed_touch_to_event	정수	Days From Last Attributed Touch To Event
deep_linked	불리안(Boolean)	Deep Linked
di_match_click_token	롱(Long)	DI Match Click Token
event_data_ad_type	enum { BANNER, INTERSTITIAL, REWARDED_VIDEO, NATIVE }	광고 유형
event_data_affiliation	String	Affiliation
event_data_coupon	String	Coupon
event_data_currency	String	Currency
event_data_description	String	Event Description
event_data_exchange_rate	Double	Exchange Rate
event_data_revenue	Double	Revenue
event_data_revenue_in_usd	Double	Revenue In USD
event_data_search_query	String	Search Query
event_data_shipping	Double	Shipping
event_data_tax	Double	Tax
event_data_transaction_id	String	Transaction ID
event_data_local_currency	String	Local Currency
event_data_local_currency_exchange_rate	String	Local Currency Exchange Rate
event_data_revenue_in_local_currency	String	Revenue in Local Currency
event_data_custom_param_1	String	Custom parameter for event
event_data_custom_param_2	String	Custom parameter for event
event_data_custom_param_3	String	Custom parameter for event
event_timestamp	롱(Long)	Event Timestamp
existing_user	불리안(Boolean)	Existing User
external_intent_uri	String	External Intent URI
first_event_for_user	불리안(Boolean)	First Event For User
hash_version	String	Hash Version
hours_from_last_attributed_touch_to_event	정수	House From Last Attributed Touch To Event
ID	String	ID
install_activity_attributed	불리안(Boolean)	Install Attributed
install_activity_data_has_clicked_ad	불리안(Boolean)	Install Has Clicked Ad
install_activity_data_has_clicked_email	불리안(Boolean)	Install Has Clicked Email
install_activity_timestamp	롱(Long)	Install Timestamp
install_activity_touch_data_additional_data_tilde_ad_id	롱(Long)	Install Ad ID
install_activity_touch_data_additional_data_tilde_ad_set_id	롱(Long)	Install Ad Set ID
install_activity_touch_data_additional_data_tilde_campaign_id	롱(Long)	Install Campaign ID
install_activity_touch_data_additional_data_tilde_creative_id	롱(Long)	Install Creative ID
install_activity_touch_data_dollar_3p	String	Install Partner 3p Value
install_activity_touch_data_plus_via_features	String	Install Features
install_activity_touch_data_plus_web_format	String	Install Web Format
install_activity_touch_data_tilde_ad_name	String	Install Ad Name
install_activity_touch_data_tilde_ad_set_name	String	Install Ad Set Name
install_activity_touch_data_tilde_advertising_partner_id	롱(Long)	Install Ad Partner ID
install_activity_touch_data_tilde_advertising_partner_name	String	Install Ad Partner
install_activity_touch_data_tilde_agency	String	Install Agency
install_activity_touch_data_tilde_agency_id	롱(Long)	Install Agency ID
install_activity_touch_data_tilde_campaign	String	Install Campaign
install_activity_touch_data_tilde_channel	String	Install Channel
install_activity_touch_data_tilde_creative_name	String	Install Creative Name
install_activity_touch_data_tilde_customer_ad_name	String	Install Customer Ad Name
install_activity_touch_data_tilde_customer_ad_set_name	String	Install Customer Ad Set Name
install_activity_touch_data_tilde_customer_campaign	String	Install Customer Campaign
install_activity_touch_data_tilde_customer_keyword	String	Install Customer Keyword
install_activity_touch_data_tilde_customer_placement	String	Install Customer Placement
install_activity_touch_data_tilde_customer_secondary_publisher	String	Install Customer Secondary Publisher
install_activity_touch_data_tilde_customer_sub_site_name	String	Install Customer Sub Site Name
install_activity_touch_data_tilde_feature	String	Install Feature
install_activity_touch_data_tilde_journey_name	String	Install Journey Name
install_activity_touch_data_tilde_keyword	String	Install Keyword
install_activity_touch_data_tilde_placement	String	Install Placement
install_activity_touch_data_tilde_secondary_publisher	String	Install Secondary Publisher
install_activity_touch_data_tilde_stage	String	Install Stage
install_activity_touch_data_tilde_tags	String	Install Tags
install_activity_touch_data_tilde_view_name	String	Install View Name
install_activity_touch_type	String	Install Touch Type
last_attributed_touch_data_custom_fields	String	Last Attributed Touch Custom Fields
last_attributed_touch_data_dollar_3p	String	Ad Partner (3p)
last_attributed_touch_data_dollar_marketing_title	String	Marketing Title
last_attributed_touch_data_plus_current_feature	String	Current Feature
last_attributed_touch_data_tilde_id	롱(Long)	Last Attributed Touch ID
last_attributed_touch_data_plus_touch_id	String	Last Attributed Touch Touch ID
last_cta_view_data_plus_touch_id	String	Last CTA View Touch ID
last_attributed_touch_data_plus_via_features	ArrayString	Via Features
last_attributed_touch_data_plus_web_format	String	Web Format
last_attributed_touch_data_tilde_ad_id	String	Ad ID
last_attributed_touch_data_tilde_ad_name	String	Ad Name
last_attributed_touch_data_tilde_ad_set_id	String	Ad Set ID
last_attributed_touch_data_tilde_ad_set_name	String	Ad Set Name
last_attributed_touch_data_tilde_advertising_account_name	String	Advertising Account Name
last_attributed_touch_data_tilde_advertising_account_id	String	Advertising Account ID
last_attributed_touch_data_tilde_advertising_partner_id	String	Ad Partner ID
last_attributed_touch_data_tilde_advertising_partner_name	String	광고 파트너
last_attributed_touch_data_tilde_agency	String	에이전시
last_attributed_touch_data_tilde_agency_id	String	Agency ID
last_attributed_touch_data_tilde_banner_dimensions	String	Banner Dimensions
last_attributed_touch_data_tilde_branch_ad_format	String	Branch 광고 형식
last_attributed_touch_data_tilde_campaign	String	Campaign
last_attributed_touch_data_tilde_campaign_id	String	캠페인 ID
last_attributed_touch_data_tilde_campaign_type	String	캠페인 유형
last_attributed_touch_data_tilde_channel	String	Channel
last_attributed_touch_data_tilde_creative_name	String	Creative Name
last_attributed_touch_data_tilde_creative_id	String	Creative ID
last_attributed_touch_data_tilde_customer_ad_name	String	Customer Ad Name
last_attributed_touch_data_tilde_customer_ad_set_name	String	Customer Ad Set Name
last_attributed_touch_data_tilde_customer_campaign	String	Customer Campaign
last_attributed_touch_data_tilde_customer_keyword	String	Customer Keyword
last_attributed_touch_data_tilde_customer_placement	String	Customer Placement
last_attributed_touch_data_tilde_customer_secondary_publisher	String	Customer Secondary Publisher
last_attributed_touch_data_tilde_customer_sub_site_name	String	Customer Sub Site Name
last_attributed_touch_data_tilde_external_touch_id	String	External Touch ID
last_attributed_touch_data_tilde_feature	String	Feature
last_attributed_touch_data_tilde_journey_id	String	Journey ID
last_attributed_touch_data_tilde_journey_name	String	Journey Name
last_attributed_touch_data_tilde_keyword	String	keyword
last_attributed_touch_data_tilde_keyword_id	String	Keyword ID
last_attributed_touch_data_tilde_optimization_model	String	Optimization Model
last_attributed_touch_data_tilde_placement	String	Placement
last_attributed_touch_data_tilde_placement_id	String	Placement ID
last_attributed_touch_data_tilde_secondary_ad_format	String	Secondary Ad Format
last_attributed_touch_data_tilde_secondary_publisher	String	Secondary Publisher
last_attributed_touch_data_tilde_secondary_publisher_id	String	Secondary Publisher ID
last_attributed_touch_data_tilde_stage	String	Stage
last_attributed_touch_data_tilde_sub_site_name	String	Sub Site Name
last_attributed_touch_data_tilde_tags	ArrayString	Tags
last_attributed_touch_data_tilde_technology_partner	String	Technology Partner
last_attributed_touch_data_tilde_touch_subtype	String	Google Video Ads "Engaged View"
last_attributed_touch_data_tilde_view_id	String	View ID
last_attributed_touch_data_tilde_view_name	String	View Name
last_attributed_touch_timestamp	롱(Long)	Last Attributed Touch Timestamp
last_attributed_touch_timestamp_iso	String	Last Attributed Touch Timestamp (ISO)
last_attributed_touch_type	String	Last Attributed Touch Type
last_cta_view_data_custom_fields	String	Last CTA View Custom Fields
last_cta_view_data_dollar_3p	String	Last CTA View Ad Partner (3p)
last_attributed_touch_data_plus_referring_domain	String	Referring Domain
last_cta_view_data_plus_via_features	ArrayString	Last CTA View Via Features
last_cta_view_data_plus_web_format	String	Last CTA View Web Format
last_cta_view_data_tilde_ad_id	String	Last CTA View Ad ID
last_cta_view_data_tilde_ad_name	String	Last CTA View Ad Name
last_cta_view_data_tilde_ad_set_id	String	Last CTA View Ad Set ID
last_cta_view_data_tilde_ad_set_name	String	Last CTA View Ad Set Name
last_cta_view_data_tilde_advertising_partner_name	String	Last CTA View Ad Partner
last_cta_view_data_tilde_agency	String	Last CTA View Agency
last_cta_view_data_tilde_banner_dimensions	String	Last CTA View Banner Dimensions
last_cta_view_data_tilde_branch_ad_format	String	Last CTA View Branch Ad Format
last_cta_view_data_tilde_campaign	String	Last CTA View Campaign
last_cta_view_data_tilde_campaign_id	String	Last CTA View Campaign ID
last_cta_view_data_tilde_campaign_type	String	Last CTA View Campaign Type
last_cta_view_data_tilde_channel	String	Last CTA View Channel
last_cta_view_data_tilde_creative_id	String	Last CTA View Creative ID
last_cta_view_data_tilde_creative_name	String	Last CTA View Creative Name
last_cta_view_data_tilde_external_touch_id	롱(Long)	Last CTA View External Touch ID
last_cta_view_data_tilde_feature	String	Last CTA View Feature
last_cta_view_data_tilde_id	롱(Long)	Last CTA View ID
last_cta_view_data_tilde_keyword_id	String	Last CTA View Keyword ID
last_cta_view_data_tilde_optimization_model	String	Last CTA View Optimization Model
last_cta_view_data_tilde_placement	String	Last CTA View Placement
last_cta_view_data_tilde_secondary_ad_format	String	Last CTA View Secondary Ad Format
last_cta_view_data_tilde_secondary_publisher	String	Last CTA View Secondary Publisher<
last_cta_view_data_tilde_stage	String	Last CTA View Stage
last_cta_view_data_tilde_tags	ArrayString	Last CTA View Tags
last_cta_view_data_tilde_technology_partner	String	Last CTA View Technology Partner
last_cta_view_timestamp	롱(Long)	Last CTA View Timestamp
last_cta_view_timestamp_iso	String	Last CTA View Timestamp (ISO)
+match_guaranteed	boolean	Flag that determines if the app session was made with 100% accuracy. Only available in Custom Exports API
minutes_from_last_attributed_touch_to_event	정수	Minutes From Last Attributed Touch To Event
name	String	Name of event based on selected topic
organization_id	롱(Long)	Organization ID
organization_name	String	Organization Name
origin	String	Origin
reengagement_activity_attributed	불리안(Boolean)	Reengagement Activity Attribute
reengagement_activity_data_has_clicked_ad	불리안(Boolean)	Reengagement Has Clicked Ad
reengagement_activity_data_has_clicked_email	불리안(Boolean)	Reengagement Has Clicked Email
reengagement_activity_timestamp	String	Reengagement Timestamp
reengagement_activity_touch_data_additional_data_tilde_ad_id	롱(Long)	Reengagement Ad ID
reengagement_activity_touch_data_additional_data_tilde_ad_set_id	롱(Long)	Reengagement Ad Set ID
reengagement_activity_touch_data_additional_data_tilde_campaign_id	롱(Long)	Reengagement Campaign ID
reengagement_activity_touch_data_additional_data_tilde_creative_id	롱(Long)	Reengagement Creative ID
reengagement_activity_touch_data_dollar_3p	String	Reengagement Partner 3p Value
reengagement_activity_touch_data_plus_via_features	String	Reengagement Features
reengagement_activity_touch_data_plus_web_format	String	Reengagement Web Format
reengagement_activity_touch_data_tilde_ad_name	String	Reengagement Ad Name
reengagement_activity_touch_data_tilde_ad_set_name	String	Reengagement Ad Set Name
reengagement_activity_touch_data_tilde_advertising_partner_id	롱(Long)	Reengagement Advertising Partner ID
reengagement_activity_touch_data_tilde_advertising_partner_name	String	Reengagement Advertising Partner Name
reengagement_activity_touch_data_tilde_agency	String	Reengagement Agency
reengagement_activity_touch_data_tilde_agency_id	롱(Long)	Reengagement Agency ID
reengagement_activity_touch_data_tilde_campaign	String	Reengagement Campaign
reengagement_activity_touch_data_tilde_channel	String	Reengagement Channel
reengagement_activity_touch_data_tilde_creative_name	String	Reengagement Creative Name
reengagement_activity_touch_data_tilde_customer_ad_name	String	Reengagement Customer Ad Name
reengagement_activity_touch_data_tilde_customer_ad_set_name	String	Reengagement Customer Ad Set Name
reengagement_activity_touch_data_tilde_customer_campaign	String	Reengagement Customer Campaign
reengagement_activity_touch_data_tilde_customer_keyword	String	Reengagement Customer Keyword
reengagement_activity_touch_data_tilde_customer_placement	String	Reengagement Customer Placement
reengagement_activity_touch_data_tilde_customer_secondary_publisher	String	Reengagement Customer Secondary Publisher
reengagement_activity_touch_data_tilde_customer_sub_site_name	String	Reengagement Customer Sub Site
reengagement_activity_touch_data_tilde_feature	String	Reengagement Feature
reengagement_activity_touch_data_tilde_journey_name	String	Reengagement Journey Name
reengagement_activity_touch_data_tilde_keyword	String	Reengagement Keyword
reengagement_activity_touch_data_tilde_placement	String	Reengagement Placement
reengagement_activity_touch_data_tilde_secondary_publisher	String	Reengagement Secondary Publisher
reengagement_activity_touch_data_tilde_stage	String	Reengagement Stage
reengagement_activity_touch_data_tilde_tags	String	Reengagement Tags
reengagement_activity_touch_data_tilde_view_name	String	Reengagement View Name
reengagement_activity_touch_type	String	Reengagement Touch Type
referrer_click_timestamp	롱(Long)	Referrer Click Timestamp
seconds_from_install_to_event	정수	Seconds From Install To Event
seconds_from_last_attributed_touch_to_event	정수	Seconds From Last Attributed Touch To Event
seconds_from_last_attributed_touch_to_store_install_begin	정수	Seconds From Touch To Store Install Begin
site_event_items_count	정수	Content Items Count
store_install_begin_timestamp	롱(Long)	Store Install Begin Timestamp
timestamp	롱(Long)	Timestamp
timestamp_iso	String	Timestamp (ISO)
user_data_aaid	String	AAID
user_data_android_id	String	Android ID
user_data_app_package_name	String	App Package Name \| TUNE ONLY
user_data_app_version	String	앱 버전
user_data_brand	String	브랜드
user_data_browser	String	Browser
user_data_build	String	Build
user_data_cpu_type	String	CPU Type
user_data_cross_platform_id	String	Cross Platform ID
user_data_developer_identity	String	Developer Identity
user_data_device_type	String	Device Type
user_data_environment	String	Environment
user_data_geo_city_code	정수	도시 코드
user_data_geo_city_en	String	City
user_data_geo_country_code	String	Country Code
user_data_geo_country_en	String	Country
user_data_geo_dma_code	정수	DMA Code
user_data_geo_lat	Float	Latitude
user_data_geo_lon	Float	Longitude
user_data_geo_postal_code	String	Postal Code
user_data_geo_region_en	String	Region
user_data_geo_region_code	String	Region Code
user_data_http_referrer	String	HTTP Referrer
user_data_idfa	String	애플 광고 식별자 (IDFA)
user_data_idfv	String	IDFV
user_data_installer_package_name	String	Installer Package Name \| TUNE ONLY
user_data_internet_connection_type	String	Internet Connection Type
user_data_ip	String	IP 주소
user_data_is_jailbroken	불리안(Boolean)	IIs Jailbroken
user_data_kindle_id	String	Kindle ID
user_data_language	String	Language
user_data_limit_ad_tracking	불리안(Boolean)	광고 트래킹 제한
user_data_model	String	모델
user_data_oaid	String	Huawei OAID
user_data_os	String	OS
user_data_os_version	String	OS Version
user_data_os_version_android	String	OS Version (Android)
user_data_past_cross_platform_ids	ArrayString	Past Cross Platforms IDs
user_data_platform	ArrayString	Platform
user_data_prob_cross_platform_ids	ArrayStruct	Probabilistic Cross Platform IDs
user_data_roku_rida	String	Roku Device ID
user_data_screen_height	정수	Screen Height
user_data_screen_width	정수	Screen Width
user_data_sdk_version	String	SDK Version
user_data_user_agent	String	User Agent
user_data_windows_aid	String	Windows AID
user_data_device_locale	String	Device Locale
user_data_carrier_name	String	Carrier Name
user_data_opted_in_status	String	Whether user opted in to ATT or not
user_data_app_store	String	The app store the user downloaded from

Available SKAdNetwork Message Fields

Field	유형	설명
ID	varchar	SkAdNetwork Message ID
body_transaction_id	varchar	SKAdNetwork Transaction ID
body_version	varchar	SKAdNetwork Version
body_ad_network_id	varchar	SKAdNetwork Ad Network ID
body_campaign_id	정수	SKAdNetworkCampaign ID
body_app_id	bigint	SKAdNetwork App ID (App Store ID)
body_attribution_signature	varchar	Body Attribution Signature
body_redownload	boolean	SKAdNetwork Redownload
body_source_app_id	bigint	SKAdNetwork Source App ID
body_conversion_value	정수	Body Conversion Value
body_fidelity_type	정수	Body Fidelity Type
body_did_win	boolean	Body Did Win
last_attributed_touch_data_tilde_ad_set_name	varchar	Ad Partner Ad Set Name
last_attributed_touch_data_tilde_ad_set_id	varchar	Ad Partner Ad Set ID
last_attributed_touch_data_tilde_campaign_id	varchar	Ad Partner Campaign ID
last_attributed_touch_data_tilde_campaign	varchar	Ad Partner Campaign Name
invalid_reason	varchar	Invalid Reason
timestamp	bigint	Timestamp when Branch received data
event_timezone_adjusted_day	bigint	Timestamp provided by Partner
annotation_dollar_3p	varchar	Annotation Dollar 3P
annotation_conversion_value_mapped_value	varchar	Annotation Conversion Vale Mapped Value
annotation_customer_event_alias	varchar	Annotation Customer Event Alias
annotation_revenue_lower	varchar	Annotation Revenue Lower Bound
annotation_revenue_upper	varchar	Annotation Revenue Upper Bound
app_id	bigint	Branch App ID
organization_id	bigint	Branch Organization ID
advertiser_copy	불리안(Boolean)	Advertiser Copy for iOS 15+ devices

🚧
IP와 위치정보의 불일치
IP로 위치를 분석할 수 없는 매우 적은 비율의 이벤트에 대해서는 국가 및 도시와 같은 지리 데이터를 사용하지 못할 수 있습니다.

Available Topics

토픽	사용자 친화적 토픽명
`eo_click_blocked`	Blocked Clicks
`eo_commerce_event_blocked`	Blocked Commerce Events
`eo_content_event_blocked`	Blocked Content Events
`eo_branch_cta_view_blocked`	Blocked CTA Views
`eo_custom_event_blocked`	Blocked Custom Events
`eo_impression_blocked`	Blocked Impressions
`eo_install_blocked`	Blocked Installs
`eo_open_blocked`	Blocked Opens
`eo_pageview_blocked`	Blocked Pageviews
`eo_reinstall_blocked`	Blocked Reinstalls
`eo_sms_sent_blocked`	Blocked SMS Sent
`eo_user_lifecycle_event_blocked`	Blocked User Lifecycle Events
`eo_web_session_start_blocked`	Blocked Web Session Starts
`eo_click`	Click
`eo_commerce_event`	Commerce Events
`eo_content_event`	Content Events
`eo_branch_cta_view`	CTA Views
`eo_custom_event`	Custom Events
`eo_impression`	Impressions
`eo_install`	Install
`eo_open`	Open
`eo_pageview`	Pageviews
`webhook2`	Postback Records
`eo_reinstall`	Reinstall
`skadnetwork_invalid_messages`	SKAdNetwork Invalid Messages
`skadnetwork_valid_messages`	SKAdNetwork Valid Messages
`eo_sms_sent`	전송된 문자 메시지
`eo_user_lifecycle_event`	User Lifecycle Events
`eo_web_session_start`	Web Session Start
`eo_san_touch`	Self-Attributing Network Touch

🚧
차단된 토픽(Blocked Topics)
Branch에서는 요청 시점기준 최대 60일이전까지의 차단된 토픽을 추출할 수 있습니다.

Custom Exports API

👍
Try it!

Overview

Benefits of Custom Exports API

API Limitations

Prerequisites & API Access

🚧
Data Changes Post iOS

대행사에 API 접근권한 제공하기

🚧
Data Purge

🚧
대행사 태그 데이터

권한인증

API Usage

Create Export Request

Request Headers:

Request Body Parameters:

Response Body Parameters:

Example Request/Response:

Response Codes:

Get Export Request

Request Headers:

Response Path Parameters

Request Query Parameters:

Response Body Parameters

Example Request/Response:

Response Codes:

Status Values:

부록

Available EO Fields

Available SKAdNetwork Message Fields

🚧
IP와 위치정보의 불일치

Available Topics

🚧
차단된 토픽(Blocked Topics)

👍Try it!

Overview

Benefits of Custom Exports API

API Limitations

Prerequisites & API Access

🚧Data Changes Post iOS

대행사에 API 접근권한 제공하기

🚧Data Purge

🚧대행사 태그 데이터

권한인증

API Usage

Create Export Request

Request Headers:

Request Body Parameters:

Response Body Parameters:

Example Request/Response:

Response Codes:

Get Export Request

Request Headers:

Response Path Parameters

Request Query Parameters:

Response Body Parameters

Example Request/Response:

Response Codes:

Status Values:

부록

Available EO Fields

Available SKAdNetwork Message Fields

🚧IP와 위치정보의 불일치

Available Topics

🚧차단된 토픽(Blocked Topics)

👍
Try it!

🚧
Data Changes Post iOS

🚧
Data Purge

🚧
대행사 태그 데이터

🚧
IP와 위치정보의 불일치

🚧
차단된 토픽(Blocked Topics)