Amplitude: Most-used fields#
The table below gives information about most-used fields that you can import from Amplitude. 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 |
|---|---|---|---|
$insert_id |
$insert_id |
A unique identifier for the event insert operation. |
dimension |
$insert_key |
$insert_key |
A unique identifier used by Amplitude for deduplication of events. |
dimension |
$schema |
$schema |
The version identifier for the event data schema, used for parsing and validation of the exported event data. |
dimension |
adid |
adid |
The Android Advertising ID, used for tracking and attribution. |
dimension |
amplitude_attribution_ids |
amplitude_attribution_ids |
Amplitude’s internal attribution IDs associated with the event. |
dimension |
amplitude_event_type |
amplitude_event_type |
The type of event as defined by Amplitude. |
dimension |
amplitude_id |
amplitude_id |
Amplitude’s unique identifier for a user. |
dimension |
app |
app |
The ID of the Amplitude project the event belongs to. |
metric |
city |
city |
The city where the event occurred, derived from the user’s IP address. |
dimension |
client_event_time |
client_event_time |
UTC ISO-8601 formatted timestamp indicating when the event occurred on the client device. |
dimension |
client_upload_time |
client_upload_time |
UTC ISO-8601 formatted timestamp indicating when the event was uploaded from the client device. |
dimension |
country |
country |
The country where the event occurred, derived from the user’s IP address. |
dimension |
data_type |
data_type |
Represents the type or name of the event being tracked within Amplitude. This field describes specific user actions or system events, such as ‘Product Purchased’, ‘Page Viewed’, or ‘Item Added to Cart’. |
dimension |
date |
date |
The date of the event. |
dimension |
device_brand |
device_brand |
The brand of the device used for the event. |
dimension |
device_carrier |
device_carrier |
The carrier of the device used for the event. |
dimension |
device_family |
device_family |
The family of the device used for the event (e.g., iPhone, Android). |
dimension |
device_id |
device_id |
A unique identifier for the device. |
dimension |
device_manufacturer |
device_manufacturer |
The manufacturer of the device used for the event. |
dimension |
device_model |
device_model |
The model of the device used for the event. |
dimension |
device_type |
device_type |
The type of device used (e.g., mobile, desktop). |
dimension |
dma |
dma |
Designated Market Area of the user. |
dimension |
event_id |
event_id |
A unique identifier for the event. |
dimension |
event_properties.Browser Name |
event_properties.Browser Name |
The name of the browser used by the user when the event occurred. |
dimension |
event_properties.Browser Version |
event_properties.Browser Version |
The version of the browser used by the user. |
dimension |
event_properties.Device Model |
event_properties.Device Model |
The specific model of the device on which the event occurred. |
dimension |
event_properties.Device Type |
event_properties.Device Type |
The category of the device used, such as ‘mobile’, ‘tablet’, or ‘desktop’. This corresponds to Amplitude’s ‘device_type’ field. |
dimension |
event_properties.Device Vendor |
event_properties.Device Vendor |
The manufacturer or vendor of the device used. |
dimension |
event_properties.OS Name |
event_properties.OS Name |
The name of the operating system (OS) on which the event occurred, such as ‘iOS’, ‘Android’, or ‘Windows’. This corresponds to Amplitude’s ‘os_name’ field. |
dimension |
event_properties.OS Version |
event_properties.OS Version |
The version of the operating system (OS) on which the event occurred. This corresponds to Amplitude’s ‘os_version’ field. |
dimension |
event_properties.Page_Domain |
event_properties.Page_Domain |
The domain of the page where the event was recorded. |
dimension |
event_properties.Page_Location |
event_properties.Page_Location |
The full URL of the page where the event was recorded. |
dimension |
event_properties.Page_Path |
event_properties.Page_Path |
The path of the URL (excluding domain and query parameters) of the page where the event occurred. |
dimension |
event_properties.Page_Referrer |
event_properties.Page_Referrer |
The full URL of the page that referred the user to the current page. |
dimension |
event_properties.Page_Title |
event_properties.Page_Title |
The title of the HTML page where the event was recorded. |
dimension |
event_properties.Page_URL |
event_properties.Page_URL |
The full URL of the page where the event was recorded, similar to Page_Location. |
dimension |
event_properties.active_engagement_hit |
event_properties.active_engagement_hit |
Indicates if the event signifies an active engagement hit, typically used in web analytics to measure meaningful interactions. |
dimension |
event_properties.active_engagement_hit_model |
event_properties.active_engagement_hit_model |
dimension |
|
event_properties.active_engagement_hit_type |
event_properties.active_engagement_hit_type |
dimension |
|
event_properties.ad_personalisation_setting |
event_properties.ad_personalisation_setting |
The user’s setting regarding ad personalization. |
dimension |
event_properties.allow_ad_personalization_signals |
event_properties.allow_ad_personalization_signals |
Indicates whether the user has allowed signals for ad personalization. |
dimension |
event_properties.application |
event_properties.application |
The name of the application where the event occurred. |
dimension |
event_properties.botName |
event_properties.botName |
The identified name of a bot if the user agent is detected as a bot. |
dimension |
event_properties.botUrl |
event_properties.botUrl |
The URL associated with the bot if the user agent is detected as a bot. |
dimension |
event_properties.browserName |
event_properties.browserName |
The name of the browser used by the user (alternative casing). |
dimension |
event_properties.browserVersion |
event_properties.browserVersion |
The version of the browser used by the user (alternative casing). |
dimension |
event_properties.click_classes |
event_properties.click_classes |
CSS classes of the element that was clicked. |
dimension |
event_properties.click_id |
event_properties.click_id |
The unique ID of the clicked element. |
dimension |
event_properties.click_name |
event_properties.click_name |
The name or text content of the clicked element. |
dimension |
event_properties.click_url |
event_properties.click_url |
The URL associated with the clicked element (e.g., href attribute). |
dimension |
event_properties.consent_management_platform_(cmp) |
event_properties.consent_management_platform_(cmp) |
The name of the Consent Management Platform (CMP) used for user consent. |
dimension |
event_properties.consent_status |
event_properties.consent_status |
The current consent status of the user for data collection. |
dimension |
event_properties.content_group_1 |
event_properties.content_group_1 |
A categorization of content, often used for organizing and analyzing content on a website or app. |
dimension |
event_properties.content_group_2 |
event_properties.content_group_2 |
A secondary categorization of content, useful for granular analysis. |
dimension |
event_properties.content_group_3 |
event_properties.content_group_3 |
A tertiary categorization of content. |
dimension |
event_properties.content_group_4 |
event_properties.content_group_4 |
A fourth level of content categorization. |
dimension |
event_properties.content_group_5 |
event_properties.content_group_5 |
A fifth level of content categorization. |
dimension |
event_properties.currency |
event_properties.currency |
Custom property representing the currency associated with an event, such as a purchase. |
dimension |
event_properties.currency_code |
event_properties.currency_code |
The currency code (e.g., USD, EUR) relevant to the event, typically for financial transactions. |
dimension |
event_properties.data_tracking_id |
event_properties.data_tracking_id |
A unique identifier for tracking a specific data point or session. |
dimension |
event_properties.debug data.info.attribution updated |
event_properties.debug data.info.attribution updated |
dimension |
|
event_properties.debug data.info.channel - event |
event_properties.debug data.info.channel - event |
dimension |
|
event_properties.deviceModel |
event_properties.deviceModel |
The specific model of the device on which the event occurred (alternative casing). |
dimension |
event_properties.deviceType |
event_properties.deviceType |
The category of the device used (alternative casing), such as ‘mobile’, ‘tablet’, or ‘desktop’. |
dimension |
event_properties.deviceVendor |
event_properties.deviceVendor |
The manufacturer or vendor of the device used (alternative casing). |
dimension |
event_properties.event_action |
event_properties.event_action |
The action that triggered the event, typically used for categorizing user interactions. |
dimension |
event_properties.event_category |
event_properties.event_category |
A broad category that the event belongs to (e.g., ‘Videos’, ‘Downloads’). |
dimension |
event_properties.event_label |
event_properties.event_label |
A descriptive label for the event, providing additional detail (e.g., ‘Summer Campaign’). |
dimension |
event_properties.event_pagecategory |
event_properties.event_pagecategory |
A category specific to the page where the event occurred. |
dimension |
event_properties.event_value |
event_properties.event_value |
A numerical value associated with the event, such as revenue or a score. |
metric |
event_properties.hit_referrer |
event_properties.hit_referrer |
The referrer URL for the specific hit or event. |
dimension |
event_properties.initial_referrer |
event_properties.initial_referrer |
The very first referrer URL that brought the user to the site/app during their first session. |
dimension |
event_properties.initial_referring_domain |
event_properties.initial_referring_domain |
The domain of the very first referrer that brought the user to the site/app. |
dimension |
event_properties.isBot |
event_properties.isBot |
A boolean indicating whether the event was triggered by a bot. |
dimension |
event_properties.is_landing_page |
event_properties.is_landing_page |
A boolean indicating whether the page where the event occurred was the user’s landing page. |
dimension |
event_properties.items |
event_properties.items |
A list of items associated with an e-commerce event, such as products in a purchase or cart. |
dimension |
event_properties.language_code |
event_properties.language_code |
The language code of the user’s device or browser (e.g., en-US). This is similar to Amplitude’s ‘language’ field. |
dimension |
event_properties.logged_in_status |
event_properties.logged_in_status |
The login status of the user when the event occurred (e.g., ‘logged in’, ‘guest’). |
dimension |
event_properties.nav_area |
event_properties.nav_area |
The section or area of the navigation where an interaction occurred. |
dimension |
event_properties.nav_component |
event_properties.nav_component |
The specific navigation component that was interacted with. |
dimension |
event_properties.nav_group |
event_properties.nav_group |
A grouping of navigation components or areas. |
dimension |
event_properties.navigator_language |
event_properties.navigator_language |
The language preferred by the user as reported by their browser’s navigator object. |
dimension |
event_properties.new_tab_open |
event_properties.new_tab_open |
A boolean indicating if a new browser tab was opened as a result of the event. |
dimension |
event_properties.non_interaction |
event_properties.non_interaction |
A boolean indicating if the event should not be used in bounce rate calculations, typically for events that don’t involve active user engagement. |
dimension |
event_properties.order_date |
event_properties.order_date |
The date when an order or transaction occurred. |
dimension |
event_properties.order_id |
event_properties.order_id |
The unique identifier for an order or transaction. |
dimension |
event_properties.order_payment_method |
event_properties.order_payment_method |
The payment method used for an order. |
dimension |
event_properties.osName |
event_properties.osName |
The name of the operating system (OS) on which the event occurred (alternative casing). |
dimension |
event_properties.osVersion |
event_properties.osVersion |
The version of the operating system (OS) on which the event occurred (alternative casing). |
dimension |
event_properties.page_location |
event_properties.page_location |
The full URL of the page where the event was recorded (alternative casing). |
dimension |
event_properties.page_referrer |
event_properties.page_referrer |
The full URL of the page that referred the user to the current page (alternative casing). |
dimension |
event_properties.page_type |
event_properties.page_type |
A classification of the page type (e.g., ‘product_page’, ‘category_page’, ‘homepage’). |
dimension |
event_properties.path |
event_properties.path |
The URL path of a web page, excluding the domain and query parameters. |
dimension |
event_properties.platform |
event_properties.platform |
The platform on which the event occurred (e.g., ‘Web’, ‘iOS’, ‘Android’). This corresponds to Amplitude’s ‘platform’ field. |
dimension |
event_properties.referrer |
event_properties.referrer |
Custom property indicating the referrer URL for the event. |
dimension |
event_properties.referring_domain |
event_properties.referring_domain |
The domain of the page that referred the user to the current page. |
dimension |
event_properties.screenSize |
event_properties.screenSize |
The screen dimensions of the device in pixels (e.g., ‘1920x1080’). |
dimension |
event_properties.search |
event_properties.search |
The search query performed by the user. |
dimension |
event_properties.search_error |
event_properties.search_error |
Indicates if an error occurred during a search operation. |
dimension |
event_properties.search_num_results |
event_properties.search_num_results |
The number of results returned for a user’s search query. |
dimension |
event_properties.search_term |
event_properties.search_term |
The specific term or query entered by the user in a search. |
dimension |
event_properties.search_type |
event_properties.search_type |
The type or category of search performed (e.g., ‘product_search’, ‘site_search’). |
dimension |
event_properties.shipping |
event_properties.shipping |
The shipping cost associated with a transaction or order. |
metric |
event_properties.site_section |
event_properties.site_section |
The section of the website or application where the event occurred. |
dimension |
event_properties.tab_url |
event_properties.tab_url |
The URL of the current browser tab. |
dimension |
event_properties.tax |
event_properties.tax |
The tax amount applied to an e-commerce transaction. |
metric |
event_properties.title |
event_properties.title |
The title of a page, content, or item. |
dimension |
event_properties.url |
event_properties.url |
The full URL of the current page where the event occurred. |
dimension |
event_properties.userAgent |
event_properties.userAgent |
The user agent string from the user’s browser, containing information about the browser, OS, and device. |
dimension |
event_properties.value |
event_properties.value |
A generic numerical value associated with an event, often used for monetary amounts or scores. |
metric |
event_properties.windowHeight |
event_properties.windowHeight |
The height of the browser window in pixels. |
metric |
event_properties.windowWidth |
event_properties.windowWidth |
The width of the browser window in pixels. |
metric |
event_properties.window_history_length |
event_properties.window_history_length |
The number of entries in the browser’s session history. |
metric |
event_time |
event_time |
UTC ISO-8601 formatted timestamp indicating when the event occurred. |
dimension |
event_type |
event_type |
The name or type of the event. |
dimension |
idfa |
idfa |
The Identifier for Advertisers (IDFA) for iOS devices, used for tracking and attribution. |
dimension |
ip_address |
ip_address |
The IP address of the user when the event occurred. |
dimension |
is_attribution_event |
is_attribution_event |
A boolean indicating whether the event is an attribution event. |
dimension |
language |
language |
The language setting of the user’s device or browser. |
dimension |
library |
library |
The name of the Amplitude SDK library used to send the event. |
dimension |
location_lat |
location_lat |
The latitude coordinate of the user’s location. |
dimension |
location_lng |
location_lng |
The longitude coordinate of the user’s location. |
dimension |
os_name |
os_name |
The name of the operating system (e.g., iOS, Android, Windows). |
dimension |
os_version |
os_version |
The version of the operating system. |
dimension |
paying |
paying |
Indicates if the user is a paying user. |
dimension |
platform |
platform |
The platform where the event occurred (e.g., Web, iOS, Android). |
dimension |
processed_time |
processed_time |
UTC ISO-8601 formatted timestamp indicating when the event was processed by Amplitude. |
dimension |
region |
region |
The region or state where the event occurred, derived from the user’s IP address. |
dimension |
server_received_time |
server_received_time |
UTC ISO-8601 formatted timestamp indicating when Amplitude servers received the event. |
dimension |
server_upload_time |
server_upload_time |
UTC ISO-8601 formatted timestamp indicating when the event data was uploaded to Amplitude servers. |
dimension |
session_id |
session_id |
A unique identifier for the user’s session. |
dimension |
start_version |
start_version |
The version of the application or product when the user’s session started. |
dimension |
user_creation_time |
user_creation_time |
UTC ISO-8601 formatted timestamp indicating when the user was first identified. |
dimension |
user_id |
user_id |
A unique identifier for the user. |
dimension |
user_properties.initial_referrer |
user_properties.initial_referrer |
User property representing the initial referrer URL at the start of a user’s journey. |
dimension |
user_properties.initial_referring_domain |
user_properties.initial_referring_domain |
The domain of the very first referrer that brought the user to the site/app, captured as a user property. |
dimension |
user_properties.userAgent |
user_properties.userAgent |
The user agent string from the user’s browser, captured as a user property. |
dimension |
user_properties.utm_campaign |
user_properties.utm_campaign |
User property representing the UTM campaign parameter. |
dimension |
user_properties.utm_channel |
user_properties.utm_channel |
The marketing channel from which the user originated, based on UTM parameters. |
dimension |
user_properties.utm_content |
user_properties.utm_content |
Used to differentiate similar content, or links within the same ad, associated with a user. This is a standard UTM parameter tracked as a user property for marketing attribution. |
dimension |
user_properties.utm_id |
user_properties.utm_id |
The unique ID of the marketing campaign that referred the user, based on UTM parameters. |
dimension |
user_properties.utm_medium |
user_properties.utm_medium |
User property representing the UTM medium parameter. |
dimension |
user_properties.utm_name |
user_properties.utm_name |
The name of the marketing campaign that referred the user, based on UTM parameters. |
dimension |
user_properties.utm_source |
user_properties.utm_source |
User property representing the UTM source parameter. |
dimension |
user_properties.utm_term |
user_properties.utm_term |
User property representing the UTM term parameter. |
dimension |
uuid |
uuid |
A universally unique identifier for the event. |
dimension |
version_name |
version_name |
The version name of the application or product. |
dimension |