Configuring Analytics

On the settings page, there’s a subsection in the Developers section for Analytics. From here, you can supply a URL and, optionally, authorization token for Explo to send information to and select the set of actions you want reported.

Note that the url must be formatted as a valid url with http:// or https://.

If you’d like to receive a Javascript Event when an Analytics Event is sent, set up an event listener for analyticsEventFired. Read about javascript events.

Analytics Data

When, for example, your dashboard is viewed from a Share link, Explo will send a request to the supplied URL with the following shape.

FieldTypeDescription
user_idstringId of the user who triggered the event
namestringThe type of event triggered
propertiesjsonMetadata about the event
custom_propertiesjsonCustom metadata passed in to embedded web component

For javascript events, the metadata described above will be contained in the detail of the event message.

Event Types

Shared Event Types

Name
Portal Dashboard Page Viewed
Data Panel PDF Downloaded
CSV Downloaded
Table Sorted
Table Paged
Table Filtered
Dropdown Selected
Multiselect Selected
Datepicker Selected

Explore Specific Event Types

Name
Dashboard Page Viewed
Shared Dashboard Page Viewed
Shared Chart Viewed
Share Button Clicked

Metadata Properties

Shared Properties

FieldType
team_idint
team_namestring
customer_idint
customer_namestring
customer_provided_idstring
customer_is_demoboolean

Explore Properties

FieldType
dashboard_template_idint
dashboard_template_namestring

Page View Event Additional Properties

FieldTypeDescription
is_productionbooltrue if this is a production dashboard
environmentstringthe environment tag supplied when the dashboard was embedded
is_strictboolwhether the dashboard was embedded in strict mode
embed_sourcestringshare or iframe, depending on how the dashboard was embedded

Internally, we use Beeceptor to test these endpoints. It ensures the requests are sending and that the request body is structured as expected. All you need to do is launch a mock server and use that generated endpoint, like garytesting.free.beeceptor.com, in the URL field in the Explo app.

Then, open your embedded dashboard and fire some events to see it flow to Beeceptor.