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.Dates without offsets (i.e. a timezone) default to the value provided for the timezone parameter. If the timezone parameter is not specified, the dates timezone defaults to UTC. Date must be within the last 120 days. Example: 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.Dates without offsets (i.e. a timezone) default to the value provided for the timezone parameter. If the timezone parameter is not specified, the dates timezone defaults to UTC. Example: 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 | Timezone for results. Accepts tz database strings like βAmerica/Los_Angelesβ.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μΌμ΄μ κΉμ§μ μ°¨λ¨λ ν ν½μ μΆμΆν μ μμ΅λλ€.
Cthulhu filter κ·κ²©
Cthulhuλ λ μ½λ(μΌλ°μ μΌλ‘ μ»¬λΌ κΈ°λ°μ λ μ½λ)μ νν°λ₯Ό μ§μ νκΈ° μν΄ JSONμΌλ‘ μμ±λ μ λλΆ νκΈ°λ² κ΅¬λ¬Έμ λλ€.
λͺ©μ
μ½κ² μΆμ ꡬ문 νΈλ¦¬λ‘ νμ±ν©λλ€.
μ©μ΄ μ¬μ
any
- any valid json basic value (number, string)
...
- previous item in a list can repeat as many times as necessary
μ΄λ¦ | κ·κ²© | μμ | SQL Equivalent |
---|---|---|---|
eq | ["eq",<column:string>, <value:any>] | ["eq","x", 1] | x= 1 |
gt | ["gt",<column:string>, <value:any>] | ["gt","x", 1] | x> 1 |
gte | ["gte",<column:string>, <value:any>] | ["gte","x", 1] | x >= 1 |
lt | ["lt",<column:string>, <value:any>] | ["lt","x", 1] | x< 1 |
lte | ["lte",<column:string>, <value:any>] | ["lte","x", 1] | x <= 1 |
like | ["like",<column:string>, <value:regex>] | ["like", "x", ". *foobar"] | x LIKE "% foobar" |
between | ["between",<column:string>, <lower:any>, <upper:any>] | ["between", "x",1, 2] | x BETWEEN 1 AND 2x >= 1 AND x <= 2 |
In | ["in", <column: string>, <value: any>, ...] | ["in","x", 1,2, 3] | x IN (1,2,3) |
and | ["and", , ...] | ["and",["gt","x", 1],["lt","x", 2]] | x> 1 AND x < 2 |
or | ["or", , ...] | ["or",["eq","x", 1],["eq", "x", 2]] | x = 1 OR x= 2 |
not | ["not",] | ["not",["eq","x", 1]] | x != 1 |
array_contains | ["array_contains", , ] | ["array_contains","last_attributed_touch_data_tilde_tags","Share"] | array_contains(array(1, 2, 3), 2) |