Amplitude: Most-used fields

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