# Dimensions and metrics ## Dimensions The following dimensions can be requested in reports ### General dimensions | Name | Title | Description | | ---------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | Activity type | See [User activity object](https://developer.mediarithmics.io/user-points/user-activities#user-activity-object) for a list of all activity types. | | `date_time` | Date + time | The combined value of date and time of the activity in timestamp format | | `channel_id` | Channel ID | The ID of the channel on which the activity was registered | | `session_duration` | Session duration | Duration of the session in seconds | | `segment_id` | Segment ID |

IDs of the segments in which the user was when doing the activity.

Note : querying this dimension can throw an error if date ranges of the query are too big.

| | `date_yyyymmdd` | Date | Date in the `YYYYMMDD` format | | `date_yyyymmddhh` | Date + Hour | Date in the `YYYYMMDDHH` format | | `date_yyyy_mm_dd` | Date | Date in the `YYYY_MM_DD` format | | `date_yyyy_mm_dd_hh_mm` | Date + Hour + minutes | Date in the `YYYY_MM_DD_HH_mm` format | | `has_conversion` | Has conversion | Boolean. If a `$conversion` event happened during the activity. For more information, see [Predefined event names](https://developer.mediarithmics.io/user-points/user-activities#predefined-event-names). | | `goal_id` | Goal ID | IDs of the goals triggered during the activity | | `has_bounced` | Has bounced | Boolean. If the user only visited one page during the activity. | | `transaction_amount` | Transaction amount | Amount spent by the user during the activity. | | `number_of_user_events` | Number of events |

Total number of User events the user triggered during the activity.

All events (custom and predefined) are counted in this total, except : $conversion $ad\_click $ad\_view $email\_view $email\_click $email\_sent $email\_delivered $email\_soft\_bounce $email\_hard\_bounce $email\_unsubscribe $email\_complaint $set\_user\_profile\_properties $set\_user\_consent $content\_correction $quit\_while\_running $cleaned\_referrer

| | `number_of_ad_views` | Number of `$ad_view` events | Total number of [User events](https://developer.mediarithmics.io/user-points/user-activities#user-events-object) named `$ad_view` during the activity. | | `number_of_ad_clicks` | Number of `$ad_click` events | Total number of [User events](https://developer.mediarithmics.io/user-points/user-activities#user-events-object) named `$ad_click` during the activity. | | `number_of_email_views` | Number of `$email_view` events | Total number of [User events](https://developer.mediarithmics.io/user-points/user-activities#user-events-object) named `$email_view` during the activity. | | `number_of_email_clicks` | Number of `$email_click` events | Total number of [User events](https://developer.mediarithmics.io/user-points/user-activities#user-events-object) named `$email_click` during the activity. | | `number_of_confirmed_transactions` | Number of `$transaction_confirmed` events | Total number of [User events](https://developer.mediarithmics.io/user-points/user-activities#user-events-object) named `$transaction_confirmed` during the activity | ### Event dimensions You can query dimensions specific to the events that happened during each activity. {% hint style="info" %} Only specific predefined events are registered at the moment. See [Event transformations](https://developer.mediarithmics.io/data-streams/data-ingestion/activities-analytics#event-transformations) to integrate your events in these dimensions. {% endhint %} | `event_type` | Event type. Only `$transaction_confirmed` `$item_view` `$list_item_view` `$basket_view` events are stored at the moment | | ------------ | ----------------------------------------------------------------------------------------------------------------------- | | `brand` | Brands of items related to the events | | `category1` | Category 1 of items related to the events | | `category2` | Category 2 of items related to the events | | `category3` | Category 3 of items related to the events | | `category4` | Category 4 of items related to the events | ### Device dimensions Informations about the device used during each activity. | `device_form_factor` | Type of device : `PERSONAL_COMPUTER` `SMART_TV` `GAME_CONSOLE` `SMARTPHONE` `TABLET` `WEARABLE_COMPUTER` `OTHE` | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `device_os_family` | OS of the device : `WINDOWS` `MAC_OS` `LINUX` `ANDROID` `IOS` `OTHER` | | `device_os_versions` | Version of the OS, for example `Windows 8` `ios10` | | `device_browser_family` | Browser used during the activity : `CHROME` `IE` `FIREFOX` `OPERA` `STOCK_ANDROID` `BOT` `EMAIL_CLIENT` `MICROSO_EDGE` `OTHER` | | `device_browser_version` | Browser's version. For example `10.3.4`, `2.2` | | `device_brand` | Device brand. For example `Acer` `Free` | | `device_model` | Device model. For example `10 plus` `4K Ultraslim` | | `device_agent_type` | Agent type : `MOBILE_APP` `WEB_BROWSER` | ### Origin dimensions The following dimensions are populated by the [Activity origin](https://developer.mediarithmics.io/user-points/user-activities#activity-origin) : * `origin_campaign_name` / `origin_campaign_technical_name` / `origin_campaign_id` * `origin_sub_campaign_technical_name` / `origin_sub_campaign_id` * `origin_message_id` / `origin_message_technical_name` * `origin_keywords` * `origin_creative_name` / `origin_creative_technical_name` / `origin_creative_id` * `origin_engagement_content_id` * `origin_social_network` * `origin_referral_path` ### Location dimensions The following dimensions are populated by the [Activity location](https://developer.mediarithmics.io/user-points/user-activities#activity-location) : * `location_source` * `location_country` * `location_region` * `location_iso_region` * `location_city` * `location_iso_city` * `location_latitude` * `location_longitude` ## Metrics The following metrics can be displayed in reports. | Name | Title | Description | | ------------------------------------------ | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `users` | Active users | The number of distinct active users | | `sessions` | Activities / Sessions | The number of activities / sessions | | `conversion_rate` | Conversion rate | Calculated with (Number of activities with conversions / Total number of activities) | | `avg_number_of_sessions_per_user_point` | Average number of sessions per UserPoint |

Calculated from the number of sessions and the number of UserPoint.

Note : this metric cannot be used with other metrics

| | `avg_revenue_per_user_point` | Average revenue per UserPoint |

Revenue divided by the number of distinct UserPoint

Note : this metric cannot be used with other metrics

| | `avg_number_of_transactions_per_user_poit` | Average number of transactions per UserPoint |

Number of transactions devided by the number of distinct UserPoint

Note : this metric cannot be used with other metrics

| | `avg_session_duration` | Average session duration | Calculated by doing an average of the `session_duration` dimension. | | `revenue` | Revenue | Sum of `transaction_amount` dimension | | `avg_transaction_amount` | Average transaction amount per activity |

Sum of transaction\_amount dimension divided by the number of transactions.

Note : this metric cannot be used with other metrics

| | `avg_number_of_user_events` | Average number of user events per activity | Sum of `number_of_user_events` dimension divided by the number of activities. | | `number_of_user_events` | Total number of user events | Sum of `number_of_user_events` dimension |