Block Tapped
The Block Tapped event is triggered when a user taps a block in an experience. Usually the block tapped is a button block, but it can also be an image block or any other type of block that has an action assigned to it.
Table Schema
Block Tapped events are stored in BigQuery in the experience_block_clicked table. The following is a detailed description of each column in the table grouped by data model.
Event
Properties of the Block Tapped event.
| Column | Description |
|---|---|
| event.timestamp | A UNIX timestamp (seconds since January 1st, 1970 at UTC) indicating the time the event occurred. |
| event.experience_session_id | Deprecated Use the event.attributes.experience_session_id column instead. |
| event.attributes.experience_id | The ID of the experience the tapped block belongs to. |
| event.attributes.screen_id | The ID of the screen the tapped block belongs to. |
| event.attributes.block_id | The ID of the block that was tapped. |
| event.attributes.block_action.type | The type of action that was taken when the block was tapped. The value in this column will be either “go-to-screen”, “open-url” or null if there was no action assigned to the block. |
| event.attributes.block_action.url | If the block action type was “open-url”, the value in this column will be the URL that was opened. |
| event.attributes.block_action.screen_id | If the block action type was “go-to-screen”, the value in this column will be the ID of the screen that was navigated to. |
| event.attributes.version_id | Each time an experience is published a new version is created. This column stores the ID of the specific version of the experience the tapped block belongs to. |
| event.attributes.experience_session_id | The time between when a user launches an experience and dismisses it is called a session. This column is a unique ID assigned to the session in-which the block was tapped. The session ID is useful for certain reports such as calculating the average time spent engaging with an experience. |
| event.attributes.timestamp | Deprecated Use the event.timestamp column instead. |
Experience
The experience the tapped block belongs to.
| Column | Description |
|---|---|
| experience.id | The experience’s ID. |
| experience.version_id | Each time an experience is published a new version is created. This column stores the ID of the specific version of the experience the event is associated with. |
| experience.screen_id | Deprecated Use screen.id instead |
| experience.block_id | Deprecated Use block.id instead |
| experience.block_action.type | Deprecated Use block.action.type instead |
| experience.block_action.screen_id | Deprecated Use block.action.screen_id instead |
| experience.name | The experience’s name. |
| experience.screen_ids | The IDs of the screens belonging to the experience. |
Screen
The screen the tapped block belongs to.
| Column | Description |
|---|---|
| screen.id | The screen’s ID. |
| screen.name | The screen’s name. |
| screen.row_ids | The IDs of the rows belonging to the screen. |
Row
The row the tapped block belongs to.
| Column | Description |
|---|---|
| row.id | The row’s ID. |
| row.name | The row’s name. |
| row.block_ids | The IDs of the blocks belonging to the row. |
| row.position | The numeric position the row appears in its screen, from top-to-bottom, starting at 1. |
Block
The block that was tapped.
| Column | Description |
|---|---|
| block.id | The block’s ID. |
| block.name | The block’s name. |
| block.type | The type of block – one of: “barcode-block”, “button-block”, “image-block”, “rectangle-block”, “text-block” or “webview-block”. |
| block.position | The numeric position the block appears in its row, from top-to-bottom, starting at 1. |
| block.action.type | The type of action that should be taken when the block is tapped. The value in this column will be either “go-to-screen”, “open-url” or null if there is no action assigned to the block. |
| block.action.url | If the block action type is “open-url”, the value in this column will be the URL that should be opened when tapped. |
| block.action.screen_id | If the block action type is “go-to-screen”, the value in this column will be the ID of the screen that should be navigated to. |
Device
The device that triggered the event.
| Column | Description |
|---|---|
| device.id | A unique device identifier. On iOS this is the value returned from UIDevice.identifierForVendor. On Android this is a UUID generated by the Rover SDK. |
| device.token | The token used by APNS or FCM/GCM to sent notifications to the device. |
| device.locale_lang | The language portion of device’s current locale as set in the device’s system settings. E.g. “en”. |
| device.locale_region | The region dialect portion of device’s current locale as set in the device’s system settings. E.g. “US”. |
| device.time_zone | The device’s current time zone. E.g. “America/Toronto” |
| device.sdk_version | The version of the Rover SDK the device has installed. E.g. 1.6.2 |
| device.platform | A value of “iOS” or “Android” indicates this event was created by a device through the Rover SDK in a native app. A value of “Web” means the event was triggered by a device through a web browser. Currently the only events that can be triggered through a web browser are experience events when viewing a mobile-web version of an experience. |
| device.os_name | The name of the operating system the device is running. E.g. “iOS” |
| device.os_version | The version of the operating system the device is running. E.g. 11.1.2 |
| device.model | The name of the device model. E.g. “iPhone 6 Plus” |
| device.manufacturer | The manufacturer of the device. E.g. “Samsung” |
| device.carrier | The mobile carrier the device is currently connected to. E.g. “T-Mobile” |
| device.app_identifier | The unique identifier of the app the device is running. E.g. “com.example.MyApp” |
| device.background_enabled | Deprecated No longer in use. |
| device.notifications_enabled | Deprecated Use device.notification_authorization instead. |
| device.bluetooth_enabled | Indicates whether the device currently has Bluetooth enabled. |
| device.location_monitoring_enabled | Indicates whether location monitoring is enabled. This could be turned off permanently in the system settings or by switching on airplane mode. |
| device.aid | The advertising identifier associated with the device. On iOS this is the value returned from advertisingIdentifier. |
| device.location.latitude | The latitude of the device’s last known location obtained from a location update. |
| device.location.longitude | The longitude of the device’s last known location obtained from a location update. |
| device.location.accuracy | The accuracy of the device’s last known location obtained from a location update, measured in metres. |
| device.ip | The last known IP address of the device. |
| device.notification_authorization | Indicates whether the device has authorized the app to display notifications. |
Customer
Deprecated The customer model and all of its columns are deprecated and no longer in use.