Skip to content

Narrowcasting dashboard

Permissions

The public_api role is required to use this feature, as it is used to authorize access to the narrowcasting dashboard.

The narrowcasting dashboard allows users to display a non-interactive view of only the data visualizations and graphs shown on the ZEM dashboard, without the need for the user to log in via the web UI. This is useful for displaying the dashboard on a TV screen or projector in a public space.

The narrowcasting dashboard refreshes automatically and the session is kept active as long as the browser window is open.

Enabling narrowcasting

To enable narrowcasting, navigate to the "My account" section of the settings in the ZEM web UI. In the "Narrowcasting dashboard" subsection, click the "Generate link" button.

Narrowcasting dashboard settings {width="902px"}

This will create a "Narrowcasting" API key for your account and display the URL to access the narrowcasting dashboard with this API key.

Narrowcasting dashboard link generated {width="869px"}

Click the "Copy" icon to copy the link or access the dashboard directly via the provided link. The token is automatically included in the link but cannot be viewed again after creation, for security reasons. If the API key is compromised or lost, you can click the "Regenerate" button to create a new dashboard link and invalidate the previous one. This also means that any existing narrowcasting dashboard links will no longer work, and active sessions will be terminated.

Manually constructing the narrowcasting dashboard

To display the narrowcasting dashboard, use the following URL format:

http(s)://<your-domain>/narrowcasting/dashboard?token=API_KEY

The URL has one required property: - token: This is the API key associated with the account that has narrowcasting enabled, or the "Narrowcasting" API key generated in the "My account" section of the settings.

The URL has one optional property: - range: This specifies the time range for the data displayed on the dashboard. It can be set to one of the following values: - past-60-minutes, today, past-24-hours, past-7-days, past-30-days, all. If not specified, the default value is past-7-days.

An example of a complete URL to access the narrowcasting dashboard is as follows:

https://app.zem.com/narrowcasting/dashboard?token=3zThUvzTlgfOJIJcclbGh6gEns30Vsjn5rTX0jGLr30026WXlUmsaTSDqlBYlr41&range=past-24-hours