👍

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:

  1. Created a Branch Dashboard
  2. Implemented the Branch SDK into your mobile app (iOS | Android)
  3. 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

  1. 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에 대한 접근권한을 제공하려면 다음과 같이 진행할 수 있습니다.

  1. In the left-hand navigation, under Configure, click on Account Settings.
  2. On the Account Settings page, click on the Agencies tab.
  3. 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.
  4. In the Edit Agency Team Member modal:
    1. Under Access Level, check the Export box.
    2. Under Permissions, check the Sensitive Data box.
  5. 선택 사항: 데이터 필터 추가
    1. Under Data Filters, toggle any necessary data filters on/blue. Exported data will be filtered accordingly.
  6. Save를 클릭합니다.
12421242

🚧

대행사 태그 데이터

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일이전까지의 차단된 토픽을 추출할 수 있습니다.