Universal behavior events for mobile apps
Mobile app – Installed
Event type code: 89
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
channel |
Short text |
The channel that caused the UB. 'push' |
attribution |
Short text |
populated. |
Mobile app – Uninstalled
Event type code: 90
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
attribution |
Short text |
populated |
Mobile app – Started a session
Event type code: 91
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
channel |
Short text |
The channel that caused the UB. 'push' |
attribution |
Short text |
campaignName specified at the time of the push (triggered the UB). |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Mobile app – Ended a session
Event type code: 92
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
attribution |
Short text |
populated. |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
sessionLength |
Numeric |
Session length in minutes, e.g. '15'. |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Mobile app – Performed a custom event
Event type code: 95
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
attribution |
Short text |
populated. |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
pushType |
Short text |
This is either 'simple', 'in-app', or 'inbox' push types |
actionTaken |
Short text |
'dial', 'app', 'url', 'inbox' or 'read', depending on how the user interacted with the notification they viewed. |
customData1 | Short text | Undefined> Reserved for Customer use |
customData2 | Short text | Undefined. Reserved for Customer use |
customData2 | Short text | Undefined. Reserved for Customer use |
otherCustomData | Long text | Undefined> Reserved for Customer use |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Mobile app – Opened a push notification
Event type code: 94
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
attribution |
Short text |
campaignName specified at the time of the push (triggered the UB). |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
pushType |
Short text |
This is either 'simple', 'in-app', or 'inbox' push types |
actionTaken |
Short text |
'dial', 'app', 'url', 'inbox' or 'read', depending on how the user interacted with the notification they viewed. |
richContentId | Short text | When users interact with mobile app messages that contain inbox messages or in-app messages, 'richContentId' indicates which piece of content that message contained. |
actionValue | Short text | When a user takes an action on a notification, like clicking a URL or opening the phone dialer, 'actionValue' indicates which URL or phone number was involved. |
Mobile app – Been sent a push notification
Event type code: 93
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
attribution |
Short text |
Campaign name specified at the time of the push (triggered the UB). |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
pushType |
Short text |
One of the following: 'simple', 'inbox', 'inApp', or any other data/extension types. Simple with Inbox (Two UB events)
Simple with extensions 'watch' and 'car' (Three UB events)
Simple with Inbox and extensions 'watch' and 'my extension type' (Four UB events)
|
Extension | Array of elements |
Indicates which extensions (if any) were included in the push that went out.
|
Mobile app – Enabled push notifications
Event type code: 103
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
attribution |
Short text |
populated. |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
channel |
Short text |
The channel that cause the UB. "push" |
Mobile app – Disabled push notifications
Event type code: 104
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
channel |
Short text |
The channel that caused the UB. 'push' |
attribution |
Short text |
populated. |
Mobile app – Push received
Event type code: 174
Attribute name | Data type | Definition |
mobileUserId |
Short text |
Assigned to the user. 16 alphanumeric characters |
channelId |
Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
appKey |
Short text |
Mobile application key. 10 alphanumeric characters |
channel |
Short text |
The channel that caused the UB. 'push' |
attribution |
Short text |
populated. |
pushState |
Short text |
The state of the push. 'failed': The push failed to send on the server |
pushOrigin |
Short text |
The origin of the push provider, values are 'provider': push originated from the provider service (Google or APNS) 'sync': the push was certified and was displayed as a result of sync with the server |
pushCertified |
Short text |
If the push a certified push, values are 'true' 'false' |
messageId |
Numeric |
The ID of the message. |
reason |
Short text |
Provides the reason for why a push was dropped or failed. |
This event is disabled by default. Contact support if you would like to enable it for your organization. This even requires SDK version 3.8.2 and beyond.
Location – Dwelled in a beacon area
Event type code: 160
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application. 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity. |
locationState | Short text | State attribute for the parent site that contains the geofence entity. |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity. |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity. |
locationRegion | Short text | Region where the geofence belongs. |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached. |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree. |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Location – Exited a beacon area
Event type code: 159
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity |
locationState | Short text | State attribute for the parent site that contains the geofence entity |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity |
locationRegion | Short text | Region where the geofence belongs |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Location – Dwelled in a geofence
Event type code: 114
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity |
locationState | Short text | State attribute for the parent site that contains the geofence entity |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity |
locationRegion | Short text | Region where the geofence belongs |
locationRadius | Numeric | Radius of the geofence entity that triggered the event on the device |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached. |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree. |
This event is disabled by default. Contact support if you would like to enable it for your organization.
Location – Entered a beacon area
Event type code: 158
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity |
locationState | Short text | State attribute for the parent site that contains the geofence entity |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity |
locationRegion | Short text | Region where the geofence belongs |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached. |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree |
Location – Entered a geofence
Event type code: 112
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity |
locationState | Short text | State attribute for the parent site that contains the geofence entity |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity |
locationRegion | Short text | Region where the geofence belongs |
locationRadius | Numeric | Radius of the geofence entity that triggered the event on the device |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached. |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree. |
Location – Exited a geofence
Event type code: 113
Attribute name | Data type | Definition |
appKey | Short text |
Mobile application key 10 alphanumeric characters |
channelId | Short text |
Assigned to a specific installation of the application 8 alphanumeric characters |
locationCity | Short text | City attribute for the parent site that contains the geofence entity |
locationState | Short text | State attribute for the parent site that contains the geofence entity |
locationCountry | Short text | Country attribute for the parent site that contains the geofence entity |
postalCode | Short text | Postal Code attribute for the parent site that contains the geofence entity |
locationRegion | Short text | Region where the geofence belongs |
locationRadius | Numeric | Radius of the geofence entity that triggered the event on the device |
siteGroupIds | Long text | Group IDs |
siteId | Short text | Site ID of the (immediate) parent site of the geofence entity that was breached. |
locationAttributeIds | Long text | Concatenated long string of all the arbitrary attributeIds aggregated (unique) attributes in the tree. |
This event is disabled by default. Contact support if you would like to enable it for your organization.