Here you'll find all the definitions and calculations of data fields used in the Mobile channel dashboard. The Mobile data dictionary is a compilation of mobile events, application state events, and application action events.
Dimensions
| Reporting field name | Type | Definition |
|---|---|---|
| Action taken | string | The way the user interacted with the notification they viewed. 'dial', 'app', 'url', 'inbox' or 'read' |
| Action value | string | The action that was taken resulted in the app being opened. |
| Application activity event types | string | Event associated with application activities. appPushDisabled, appPushEnabled, appInstalled, and appUninstalled. |
| Application session key | string | Mobile application key assigned by Campaign. |
| Custom data 1 | string | Customer-defined event data. |
| Custom data 2 | string | Customer-defined event data. |
| Custom data 3 | string | Customer-defined event data. |
| Custom data other | string | Customer-defined event data. |
| Event Date | datetime | The datetime of an event. |
| Event category | string | Event category. |
| Event DateTime | string | Converts the month to an abbreviated month. Includes other datetime elements of the event, i.e. Apr 04, 2022, 02:18 PM. |
| Event details | string | Details for this event. |
| Event type | string | Type of the email event. |
| Message Date | datetime | Message send date. |
| Message DateTime | string | Converts the month to an abbreviated month. Includes other datetime elements of the Event, i.e. Apr 04, 2022, 02:18 PM. |
| Mobile action message ID | string | ID of the message as referenced in the
Mobile action performance Explore. |
| Mobile message campaign name | string | Name of the associated campaign, free-form text. |
| Mobile message key | string | Mobile application key assigned by Campaign. |
| Mobile message ID | string | ID of the message as referenced in the
Mobile message performance Explore. |
| Message occurrence ID | string | ID that is based on the message_id and changes per occurrence of this message_id. |
| Mobile message type | string | Type of notifications: Simple, Inbox, InApp, and Data. |
| Push certified | boolean | Push delivery status, enabled or not. |
| Push origin | string | Push delivery origin: [ PROVIDER, SYNC ]. |
| Push state | string | State of push: displayed, expired, silent, disabled, dropped, failed. |
| Push type | string | Type of notifications: simple, inbox, inApp, watch. |
| Event Date | datetime | The datetime of an event. |
| Sent Datetime | string | Converts the month to an abbreviated month. Includes other datetime elements of Message, i.e. Apr 04, 2022, 02:18 PM. |
| Session End Date | datetime | Time the session ended. |
| Session End DateTime | string | Converts the month to an abbreviated month. Includes other datetime elements of the Message, i.e. Apr 04, 2022, 02:18 PM. |
| Session Start Date | datetime | Time the session began. |
| Session Start DateTime | string | Converts the month to an abbreviated month. Includes other datetime elements of the Message, i.e. Apr 04, 2022, 02:18 PM. |
Measures
| Reporting field name | Type | Definition | Calculations |
|---|---|---|---|
| Actions gross | count | The total number of actions taken as a result of push notifications. | Count of events with an event_type: 'appNotificationOpen'. |
| App opens unique | count_distinct | The unique number of times a user opened an app on their device. | Count of unique customer_ids by action_taken: 'read' and event_type: 'appNotificationOpen'. |
| Count | count | Total number of events | Count of event_id records. |
| Customer ID unique | count_distinct | Count of unique customer_ids. | Count of unique customer_ids. |
| Custom data 1 unique | count_distinct | Unique number of Customer defined event data | Total number of unique custom_data_1 inputs. |
| Custom data 2 unique | count_distinct | Unique number of Customer defined event data | Total number of unique custom_data_2 inputs. |
| Custom data 3 unique | count_distinct | Unique number of Customer defined event data | Total number of unique custom_data_3 inputs. |
| InApp messages opens unique | count_distinct | The unique number of times an InApp message was opened | Count of unique customer_ids by action_taken: 'app', event_type: 'appNotificationOpen'. |
| Inbox messages opens unique | count_distinct | The unique number of times an Inbox message was opened | Count of unique customer_ids by action_taken: 'inbox', event_type: 'appNotificationOpen'. |
| Installed unique | count_distinct | The unique number of times a user installed the mobile app on their device. | Unique count of events with event_type: 'appInstalled'. |
| Mobile clicks | count_distinct | The total number of times a recipient clicked a link within a mobile message. | Count of events with action_taken: 'url'. |
| Mobile message dropped gross | count | The number of mobile messages not delivered due to recipient actions, such as unsubscribing or reporting the sender as spam. | The total number of events with event_type: pushDelivery and pushState = ‘dropped’. |
| Mobile message dropped rate | count | The percentage of mobile messages that were not delivered due to recipient actions, such as unsubscribing or reporting the sender as spam, out of all sends. | The total number of events with event_type: pushDelivery and pushState = ‘dropped’, out of the total number of events with event_type: mobilePushSend. |
| Mobile message failed gross | count | The number of failed sends in a marketing campaign due to issues on the sender's side, such as network or system errors. | The total number of events with event_type: pushDelivery and pushState = ‘failed’. |
| Mobile message failed rate | count | The percentage of failed sends in a marketing campaign due to issues on the sender's side, out of all sends. | The total number of events with event_type: pushDelivery and pushState = ‘failed’, out of the total number of events with event_type: mobilePushSend. |
| Mobile message send attempt | count | The number of attempted sends in a marketing campaign, including failed and undelivered. | The total number of sends events without dropped and failed events. |
| Mobile message sent gross | count | The number of times a mobile message is sent to a recipient in a marketing campaign, excluding undelivered and failed messages. | The total number of events with event_type: mobilePushSend. |
| Mobile message undeliverable gross | count | The number of undeliverable sends in a marketing campaign, including both dropped and failed sends. | The sum of dropped and failed events. |
| Mobile message undeliverable rate | count | The percentage of undeliverable messages in a marketing campaign, including both dropped and failed sends, out of all sends. | The sum of dropped and failed events, out of the total number of events with event_type: mobilePushSend. |
| Mobile session unique count | count_distinct | The number of unique mobile application sessions. | Count of all unique customer_ids by application_ids with an appSessionClose event. |
| Mobile opens | count_distinct | The total number of times a recipient opened a mobile message. | Count of events with action_taken: 'read, inbox, app, dial'. |
| Phone number clicks unique | count_distinct | The total number of times push notifications were enabled on a device. | Count of unique customer_ids by action_taken: 'dial', event_type: 'appNotifcationOpen'. |
| Push enabled | count_distinct | The total number of times push notifications were enabled on a device. | Count of events with event_type: 'appPushEnabled'. |
| Push disabled | count_distinct | The total number of times push notifications were disabled on a device. | Count of events with event_type: 'appPushDisabled'. |
| Sent | count | The total number of times a mobile message is sent to a recipient in a marketing campaign. | Count of events with event_type: 'mobilePushSend'. |
| Session count gross | count | The number of mobile application sessions, including multiple installations by the same recipient. | The total number of events with event_type: appSessionClose. |
| Session count unique | count_distinct | The number of unique mobile application sessions. | Count of all unique customer_ids by application_ids with an appSessionClose event. |
| Session max duration | count | The longest duration of a mobile application session. | The maximum session length in minutes by Application key. |
| Session min duration | count | The shortest duration of a mobile application session. | The minimum session length in minutes by Application key. |
| Session total duration | count | The sum of all mobile application session durations. | The total sum of all session lengths in minutes by Application key. |
| URL clicks unique | count_distinct | The unique number of times a recipient clicked a link | Count of unique customer_ids by action_taken: 'url' and event_type: 'appNotificationOpen'. |