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* |
|
Rate Limit for checking the status of a report* |
|
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)
- 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:
- Under Access Level, check the Export box.
- Under Permissions, check the Sensitive Data box.
- 선택 사항: 데이터 필터 추가
- 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:
상태 | 설명 |
---|---|
| Request is pending. |
| Request is still running. |
| Request is complete. |
| 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
토픽 | 사용자 친화적 토픽명 |
---|---|
| Blocked Clicks |
| Blocked Commerce Events |
| Blocked Content Events |
| Blocked CTA Views |
| Blocked Custom Events |
| Blocked Impressions |
| Blocked Installs |
| Blocked Opens |
| Blocked Pageviews |
| Blocked Reinstalls |
| Blocked SMS Sent |
| Blocked User Lifecycle Events |
| Blocked Web Session Starts |
| Click |
| Commerce Events |
| Content Events |
| CTA Views |
| Custom Events |
| Impressions |
| Install |
| Open |
| Pageviews |
| Postback Records |
| Reinstall |
| SKAdNetwork Invalid Messages |
| SKAdNetwork Valid Messages |
| 전송된 문자 메시지 |
| User Lifecycle Events |
| Web Session Start |
| Self-Attributing Network Touch |
차단된 토픽(Blocked Topics)
Branch에서는 요청 시점기준 최대 60일이전까지의 차단된 토픽을 추출할 수 있습니다.