Branch - Custom Export API: Most-used fields#
The table below gives information about most-used fields that you can import from Branch - Custom Export API. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
Annotation Conversion Vale Mapped Value |
annotation_conversion_value_mapped_value |
The mapped conversion value associated with an annotation. |
dimension |
Annotation Customer Event Alias |
annotation_customer_event_alias |
The customer event alias associated with an annotation. |
dimension |
Annotation Dollar 3P |
annotation_dollar_3p |
The 3rd party advertising partner value associated with an annotation. |
dimension |
Annotation Revenue Lower Bound |
annotation_revenue_lower |
The lower bound of the revenue range associated with an annotation. |
dimension |
Annotation Revenue Upper Bound |
annotation_revenue_upper |
The upper bound of the revenue range associated with an annotation. |
dimension |
Body Attribution Signature |
body_attribution_signature |
The attribution signature for an SKAdNetwork postback. |
dimension |
Body Conversion Value |
body_conversion_value |
The conversion value for an SKAdNetwork postback. |
dimension |
Body Did Win |
body_did_win |
Indicates if an SKAdNetwork postback was a winning postback. |
dimension |
Body Fidelity Type |
body_fidelity_type |
The fidelity type for an SKAdNetwork postback, indicating the attribution model. |
dimension |
Branch App ID |
app_id |
The unique identifier for the Branch app. |
dimension |
Branch Organization ID |
organization_id |
The unique identifier for the Branch organization. |
dimension |
Invalid Reason |
invalid_reason |
The reason why a SKAdNetwork postback was considered invalid. |
dimension |
SKAdNetwork Ad Network ID |
body_ad_network_id |
The Ad Network ID from an SKAdNetwork postback. |
dimension |
SKAdNetwork App ID (App Store ID) |
body_app_id |
The App Store ID from an SKAdNetwork postback. |
dimension |
SKAdNetwork Redownload |
body_redownload |
Indicates if the app associated with the SKAdNetwork postback was a re-download. |
dimension |
SKAdNetwork Source App ID |
body_source_app_id |
The source App ID from an SKAdNetwork postback. |
dimension |
SKAdNetwork Transaction ID |
body_transaction_id |
The transaction ID from an SKAdNetwork postback. |
dimension |
SKAdNetwork Version |
body_version |
The version of SKAdNetwork used for the postback. |
dimension |
SKAdNetworkCampaign ID |
body_campaign_id |
The campaign ID from an SKAdNetwork postback. |
dimension |
app_version |
app_version |
The version of the application. |
dimension |
content_items |
content_items |
An array of content items associated with an event. |
dimension |
custom_data |
custom_data |
Custom data in a map (string to string) associated with an event. |
dimension |
customer_event_alias |
customer_event_alias |
An alias for a customer event. |
dimension |
date |
date |
The timestamp of the event or activity, provided in ISO-8601 format for precise date and time tracking. This field can represent various event timestamps within the exported data. |
dimension |
days_from_last_attributed_touch_to_event |
days_from_last_attributed_touch_to_event |
The number of days between the last attributed touch and the event. |
metric |
deep_linked |
deep_linked |
Indicates if the event was a result of a deep link. |
dimension |
di_match_click_token |
di_match_click_token |
The DI (Deep Install) Match Click Token. |
dimension |
event_data_affiliation |
event_data_affiliation |
The affiliation data associated with the event. |
dimension |
event_data_coupon |
event_data_coupon |
The coupon code used in the event. |
dimension |
event_data_currency |
event_data_currency |
The currency used for the event’s revenue. |
dimension |
event_data_description |
event_data_description |
A description of the event. |
dimension |
event_data_exchange_rate |
event_data_exchange_rate |
The exchange rate applied to the event’s revenue. |
dimension |
event_data_revenue |
event_data_revenue |
The revenue value associated with the event. |
metric |
event_data_revenue_in_usd |
event_data_revenue_in_usd |
The revenue value associated with the event, converted to USD. |
metric |
event_data_search_query |
event_data_search_query |
The search query associated with the event. |
dimension |
event_data_shipping |
event_data_shipping |
The shipping cost associated with the event. |
dimension |
event_data_tax |
event_data_tax |
The tax amount associated with the event. |
dimension |
event_data_transaction_id |
event_data_transaction_id |
The transaction ID associated with the event. |
dimension |
event_timestamp |
event_timestamp |
The timestamp of when the event occurred. |
metric |
existing_user |
existing_user |
Indicates if the event was performed by an existing user. |
dimension |
external_intent_uri |
external_intent_uri |
The URI of the external intent that triggered the event. |
dimension |
first_event_for_user |
first_event_for_user |
Indicates if this is the first event recorded for a user. |
dimension |
hours_from_last_attributed_touch_to_event |
hours_from_last_attributed_touch_to_event |
The number of hours between the last attributed touch and the event. |
metric |
install_activity_timestamp |
install_activity_timestamp |
The timestamp of the install activity. |
metric |
install_activity_touch_data_tilde_advertising_partner_name |
install_activity_touch_data_tilde_advertising_partner_name |
The name of the advertising partner for the install activity touch. |
dimension |
install_activity_touch_data_tilde_campaign |
install_activity_touch_data_tilde_campaign |
The campaign name associated with the install activity touch. |
dimension |
last_attributed_touch_data_custom_fields |
last_attributed_touch_data_custom_fields |
Custom fields associated with the last attributed touch. |
dimension |
last_attributed_touch_data_dollar_3p |
last_attributed_touch_data_dollar_3p |
The 3rd party advertising partner value for the last attributed touch. |
dimension |
last_attributed_touch_data_plus_current_feature |
last_attributed_touch_data_plus_current_feature |
The current feature associated with the last attributed touch. |
dimension |
last_attributed_touch_data_plus_touch_id |
last_attributed_touch_data_plus_touch_id |
The touch ID of the last attributed touch. |
dimension |
last_attributed_touch_data_plus_via_features |
last_attributed_touch_data_plus_via_features |
An array of features through which the last attributed touch occurred. |
dimension |
last_attributed_touch_data_plus_web_format |
last_attributed_touch_data_plus_web_format |
The web format of the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_ad_id |
last_attributed_touch_data_tilde_ad_id |
The advertising ID of the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_ad_name |
last_attributed_touch_data_tilde_ad_name |
The name of the ad for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_advertising_account_id |
last_attributed_touch_data_tilde_advertising_account_id |
The advertising account ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_advertising_account_name |
last_attributed_touch_data_tilde_advertising_account_name |
The advertising account name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_advertising_partner_id |
last_attributed_touch_data_tilde_advertising_partner_id |
The ID of the advertising partner for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_advertising_partner_name |
last_attributed_touch_data_tilde_advertising_partner_name |
The name of the advertising partner for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_agency |
last_attributed_touch_data_tilde_agency |
The agency associated with the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_agency_id |
last_attributed_touch_data_tilde_agency_id |
The ID of the agency for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_banner_dimensions |
last_attributed_touch_data_tilde_banner_dimensions |
The banner dimensions for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_branch_ad_format |
last_attributed_touch_data_tilde_branch_ad_format |
The Branch ad format for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_campaign_type |
last_attributed_touch_data_tilde_campaign_type |
The type of campaign for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_channel |
last_attributed_touch_data_tilde_channel |
The marketing channel for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_creative_id |
last_attributed_touch_data_tilde_creative_id |
The creative ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_creative_name |
last_attributed_touch_data_tilde_creative_name |
The creative name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_ad_name |
last_attributed_touch_data_tilde_customer_ad_name |
The customer’s ad name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_ad_set_name |
last_attributed_touch_data_tilde_customer_ad_set_name |
The customer’s ad set name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_campaign |
last_attributed_touch_data_tilde_customer_campaign |
The customer’s campaign name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_keyword |
last_attributed_touch_data_tilde_customer_keyword |
The customer’s keyword for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_placement |
last_attributed_touch_data_tilde_customer_placement |
The customer’s placement for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_secondary_publisher |
last_attributed_touch_data_tilde_customer_secondary_publisher |
The customer’s secondary publisher for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_customer_sub_site_name |
last_attributed_touch_data_tilde_customer_sub_site_name |
The customer’s sub-site name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_external_touch_id |
last_attributed_touch_data_tilde_external_touch_id |
The external touch ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_feature |
last_attributed_touch_data_tilde_feature |
The feature associated with the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_id |
last_attributed_touch_data_tilde_id |
The ID of the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_journey_id |
last_attributed_touch_data_tilde_journey_id |
The journey ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_journey_name |
last_attributed_touch_data_tilde_journey_name |
The journey name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_keyword |
last_attributed_touch_data_tilde_keyword |
The keyword for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_keyword_id |
last_attributed_touch_data_tilde_keyword_id |
The keyword ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_optimization_model |
last_attributed_touch_data_tilde_optimization_model |
The optimization model for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_placement |
last_attributed_touch_data_tilde_placement |
The placement for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_placement_id |
last_attributed_touch_data_tilde_placement_id |
The placement ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_secondary_ad_format |
last_attributed_touch_data_tilde_secondary_ad_format |
The secondary ad format for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_secondary_publisher |
last_attributed_touch_data_tilde_secondary_publisher |
The secondary publisher for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_secondary_publisher_id |
last_attributed_touch_data_tilde_secondary_publisher_id |
The ID of the secondary publisher for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_stage |
last_attributed_touch_data_tilde_stage |
The stage of the last attributed touch in the user journey. |
dimension |
last_attributed_touch_data_tilde_sub_site_name |
last_attributed_touch_data_tilde_sub_site_name |
The sub-site name for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_tags |
last_attributed_touch_data_tilde_tags |
An array of tags associated with the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_technology_partner |
last_attributed_touch_data_tilde_technology_partner |
The technology partner for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_view_id |
last_attributed_touch_data_tilde_view_id |
The view ID for the last attributed touch. |
dimension |
last_attributed_touch_data_tilde_view_name |
last_attributed_touch_data_tilde_view_name |
The view name for the last attributed touch. |
dimension |
last_attributed_touch_timestamp |
last_attributed_touch_timestamp |
The timestamp of the last attributed touch. |
metric |
last_attributed_touch_timestamp_iso |
last_attributed_touch_timestamp_iso |
The ISO-formatted timestamp of the last attributed touch. |
dimension |
last_attributed_touch_type |
last_attributed_touch_type |
The type of the last attributed touch (e.g., click, impression). |
dimension |
last_cta_view_data_custom_fields |
last_cta_view_data_custom_fields |
Custom fields associated with the last CTA (Call-to-Action) view. |
dimension |
last_cta_view_data_dollar_3p |
last_cta_view_data_dollar_3p |
The 3rd party advertising partner value for the last CTA view. |
dimension |
last_cta_view_data_plus_touch_id |
last_cta_view_data_plus_touch_id |
The touch ID of the last CTA view. |
dimension |
last_cta_view_data_plus_via_features |
last_cta_view_data_plus_via_features |
An array of features through which the last CTA view occurred. |
dimension |
last_cta_view_data_plus_web_format |
last_cta_view_data_plus_web_format |
The web format of the last CTA view. |
dimension |
last_cta_view_data_tilde_ad_id |
last_cta_view_data_tilde_ad_id |
The advertising ID of the last CTA view. |
dimension |
last_cta_view_data_tilde_ad_name |
last_cta_view_data_tilde_ad_name |
The name of the ad for the last CTA view. |
dimension |
last_cta_view_data_tilde_ad_set_id |
last_cta_view_data_tilde_ad_set_id |
The ad set ID for the last CTA view. |
dimension |
last_cta_view_data_tilde_ad_set_name |
last_cta_view_data_tilde_ad_set_name |
The ad set name for the last CTA view. |
dimension |
last_cta_view_data_tilde_advertising_partner_name |
last_cta_view_data_tilde_advertising_partner_name |
The name of the advertising partner for the last CTA view. |
dimension |
last_cta_view_data_tilde_agency |
last_cta_view_data_tilde_agency |
The agency associated with the last CTA view. |
dimension |
last_cta_view_data_tilde_banner_dimensions |
last_cta_view_data_tilde_banner_dimensions |
The banner dimensions for the last CTA view. |
dimension |
last_cta_view_data_tilde_branch_ad_format |
last_cta_view_data_tilde_branch_ad_format |
The Branch ad format for the last CTA view. |
dimension |
last_cta_view_data_tilde_campaign |
last_cta_view_data_tilde_campaign |
The campaign name associated with the last CTA view. |
dimension |
last_cta_view_data_tilde_campaign_id |
last_cta_view_data_tilde_campaign_id |
The campaign ID for the last CTA view. |
dimension |
last_cta_view_data_tilde_campaign_type |
last_cta_view_data_tilde_campaign_type |
The type of campaign for the last CTA view. |
dimension |
last_cta_view_data_tilde_channel |
last_cta_view_data_tilde_channel |
The marketing channel for the last CTA view. |
dimension |
last_cta_view_data_tilde_creative_id |
last_cta_view_data_tilde_creative_id |
The creative ID for the last CTA view. |
dimension |
last_cta_view_data_tilde_creative_name |
last_cta_view_data_tilde_creative_name |
The creative name for the last CTA view. |
dimension |
last_cta_view_data_tilde_external_touch_id |
last_cta_view_data_tilde_external_touch_id |
The external touch ID for the last CTA view. |
dimension |
last_cta_view_data_tilde_feature |
last_cta_view_data_tilde_feature |
The feature associated with the last CTA view. |
dimension |
last_cta_view_data_tilde_id |
last_cta_view_data_tilde_id |
The ID of the last CTA view. |
dimension |
last_cta_view_data_tilde_keyword_id |
last_cta_view_data_tilde_keyword_id |
The keyword ID for the last CTA view. |
dimension |
last_cta_view_data_tilde_optimization_model |
last_cta_view_data_tilde_optimization_model |
The optimization model for the last CTA view. |
dimension |
last_cta_view_data_tilde_placement |
last_cta_view_data_tilde_placement |
The placement for the last CTA view. |
dimension |
last_cta_view_data_tilde_secondary_ad_format |
last_cta_view_data_tilde_secondary_ad_format |
The secondary ad format for the last CTA view. |
dimension |
last_cta_view_data_tilde_secondary_publisher |
last_cta_view_data_tilde_secondary_publisher |
The secondary publisher for the last CTA view. |
dimension |
last_cta_view_data_tilde_stage |
last_cta_view_data_tilde_stage |
The stage of the last CTA view in the user journey. |
dimension |
last_cta_view_data_tilde_tags |
last_cta_view_data_tilde_tags |
An array of tags associated with the last CTA view. |
dimension |
last_cta_view_data_tilde_technology_partner |
last_cta_view_data_tilde_technology_partner |
The technology partner for the last CTA view. |
dimension |
last_cta_view_timestamp |
last_cta_view_timestamp |
The timestamp of the last CTA view. |
dimension |
last_cta_view_timestamp_iso |
last_cta_view_timestamp_iso |
The ISO-formatted timestamp of the last CTA view. |
dimension |
minutes_from_last_attributed_touch_to_event |
minutes_from_last_attributed_touch_to_event |
The number of minutes between the last attributed touch and the event. |
metric |
name |
name |
The name of the event, based on the selected topic. |
dimension |
organization_name |
organization_name |
The name of the Branch organization. |
dimension |
origin |
origin |
The origin of the event. |
dimension |
reengagement_activity_attributed |
reengagement_activity_attributed |
Indicates if the reengagement activity was attributed. |
dimension |
referrer_click_timestamp |
referrer_click_timestamp |
The timestamp of the referrer click. |
metric |
sdk_version |
sdk_version |
The version of the Branch SDK used. |
dimension |
seconds_from_install_to_event |
seconds_from_install_to_event |
The number of seconds between the install and the event. |
dimension |
seconds_from_last_attributed_touch_to_event |
seconds_from_last_attributed_touch_to_event |
The number of seconds between the last attributed touch and the event. |
metric |
seconds_from_last_attributed_touch_to_store_install_begin |
seconds_from_last_attributed_touch_to_store_install_begin |
The number of seconds from the last attributed touch to the beginning of the store install process. |
metric |
site_event_items_count |
site_event_items_count |
The count of content items associated with a site event. |
dimension |
store_install_begin_timestamp |
store_install_begin_timestamp |
The timestamp when the store install process began. |
metric |
timestamp_iso |
timestamp_iso |
The ISO-formatted timestamp of when Branch received the data. |
dimension |
user_agent |
user_agent |
The user agent string from the user’s device or browser. |
dimension |
user_data_aaid |
user_data_aaid |
The Google Advertising ID (AAID) of the user. |
dimension |
user_data_android_id |
user_data_android_id |
The Android ID of the user’s device. |
dimension |
user_data_app_package_name |
user_data_app_package_name |
The unique identifier for the application on a user’s device, often used to distinguish between different applications. |
dimension |
user_data_app_version |
user_data_app_version |
The version of the application that generated the event. |
dimension |
user_data_brand |
user_data_brand |
The brand of the device. |
dimension |
user_data_browser |
user_data_browser |
The browser used by the user. |
dimension |
user_data_build |
user_data_build |
The build number of the application or operating system. |
dimension |
user_data_carrier_name |
user_data_carrier_name |
The name of the mobile carrier network the user’s device is connected to. |
dimension |
user_data_cpu_type |
user_data_cpu_type |
The CPU type of the device. |
dimension |
user_data_cross_platform_id |
user_data_cross_platform_id |
An identifier used to track users across different platforms. |
dimension |
user_data_developer_identity |
user_data_developer_identity |
The developer-defined identity of the user. |
dimension |
user_data_device_locale |
user_data_device_locale |
The locale of the user’s device. |
dimension |
user_data_device_type |
user_data_device_type |
The type of device used by the user (e.g., mobile, tablet, desktop). |
dimension |
user_data_environment |
user_data_environment |
The environment in which the event occurred (e.g., production, development). |
dimension |
user_data_geo_city_code |
user_data_geo_city_code |
The geographic city code of the user. |
metric |
user_data_geo_city_en |
user_data_geo_city_en |
The geographic city name (in English) of the user. |
dimension |
user_data_geo_country_code |
user_data_geo_country_code |
The geographic country code of the user. |
dimension |
user_data_geo_country_en |
user_data_geo_country_en |
The geographic country name (in English) of the user. |
dimension |
user_data_geo_dma_code |
user_data_geo_dma_code |
The geographic DMA (Designated Market Area) code of the user. |
metric |
user_data_geo_lat |
user_data_geo_lat |
The latitude coordinate of the user’s geographic location. |
metric |
user_data_geo_lon |
user_data_geo_lon |
The longitude coordinate of the user’s geographic location. |
metric |
user_data_geo_postal_code |
user_data_geo_postal_code |
The geographic postal code of the user. |
dimension |
user_data_http_referrer |
user_data_http_referrer |
The HTTP referrer URL that led to the event. |
dimension |
user_data_idfa |
user_data_idfa |
The Identifier for Advertisers (IDFA) for iOS devices. |
dimension |
user_data_idfv |
user_data_idfv |
The Identifier for Vendors (IDFV) for iOS devices. |
dimension |
user_data_installer_package_name |
user_data_installer_package_name |
The package name of the application installer. While not directly listed, this is a common user data field for app analytics, similar to app_name or user_data_app_store. |
dimension |
user_data_internet_connection_type |
user_data_internet_connection_type |
The type of internet connection used by the device (e.g., Wi-Fi, cellular). |
dimension |
user_data_ip |
user_data_ip |
The IP address of the user’s device. |
dimension |
user_data_is_jailbroken |
user_data_is_jailbroken |
Indicates whether the user’s device is jailbroken. |
dimension |
user_data_kindle_id |
user_data_kindle_id |
The unique identifier for Kindle devices. |
dimension |
user_data_language |
user_data_language |
The language setting of the user’s device. |
dimension |
user_data_limit_ad_tracking |
user_data_limit_ad_tracking |
Indicates if the user has enabled Limit Ad Tracking (LAT) on their device. |
dimension |
user_data_model |
user_data_model |
The model of the user’s device. |
dimension |
user_data_os |
user_data_os |
The operating system of the user’s device. |
dimension |
user_data_os_version |
user_data_os_version |
The operating system version of the user’s device. |
dimension |
user_data_os_version_android |
user_data_os_version_android |
The Android operating system version of the user’s device. |
metric |
user_data_past_cross_platform_ids |
user_data_past_cross_platform_ids |
A list of past cross-platform identifiers associated with the user. |
dimension |
user_data_platform |
user_data_platform |
The operating system or platform of the user’s device (e.g., iOS, Android, Web). |
dimension |
user_data_prob_cross_platform_ids |
user_data_prob_cross_platform_ids |
Probabilistic cross-platform identifiers, indicating a likelihood of association across different platforms. |
dimension |
user_data_screen_height |
user_data_screen_height |
The height of the device’s screen in pixels. |
metric |
user_data_screen_width |
user_data_screen_width |
The width of the device’s screen in pixels. |
metric |
user_data_sdk_version |
user_data_sdk_version |
The version of the Branch SDK integrated into the application. |
dimension |
user_data_user_agent |
user_data_user_agent |
The user agent string from the user’s browser or application. |
dimension |
user_data_windows_aid |
user_data_windows_aid |
The Advertising ID for Windows devices. |
dimension |
windows_aid |
windows_aid |
The Windows Advertising ID of the user’s device. |
dimension |