Branch - Custom Export API: Most-used fields

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