Analytics Connector Pack

Measuring and improving the performance of your website is a universal requirement. The Analytics Connector Pack allows you to connect third-party web analytics tools such as Adobe Analytics, Google Analytics and Matomo (Piwik) to Magnolia. Editors and marketers can build their own widgets (charts) and dashboards dynamically in the user-friendly Analytics app UI.

The typical scenario for using the Analytics Connector Pack is:

  • Track metrics such as visitors and sessions on your Magnolia site using the third-party tool of your choice.

  • Use the Analytics Connector Pack to fetch the analytics reporting data collected by the third-party tool.

  • Build and display user-friendly widgets directly in the Magnolia Analytics app.

With the Analytics Connector Pack, marketers and authors can make data-driven decisions about their content without switching tools.

Analytics connectors

Your Magnolia administrator can configure the connection details of a third-party web analytics tool, such as the URL and authentication. The Analytics framework can then retrieve the analytics data you want, typically in JSON format.

Magnolia provides out-of-the-box connectors to:

  • Adobe Analytics

  • Google Analytics

  • Matomo

Your administrator can also configure a custom connector to another third-party tool.

Analytics framework

The Analytics Connector Pack provides a generic framework to retrieve the web analytics data from the connected third-party tools.

The framework provides a default implementation to connect to the extensive amCharts data visualization library, which provides user-friendly JavaScript-based interactive charts.

Analytics app

The Analytics app enables editors and marketers to build dashboards and widgets, or charts, to view analytics related to their content within Magnolia. By having access to key analytics in the UI, you can make faster data-driven decisions about your content.

Magnolia provides an out-of-the-box dashboard of sample metrics about your Magnolia installation to illustrate what can be done. The example shows a pie, bar, line and word cloud chart. The charts look and feel like an integral part of the Magnolia user interface.

NOTE

The demo dashboard shows chart types that are not provided out-of-the-box and required additional configuration to create. The demo dashboard also shows a customized pie chart where the number of labels has been reduced.

Analytics app dashboard

The sample charts in the demo dashboard have been enhanced using light development. For example, not all chart types or customization in terms of chart colours or labelling are available using the Analytics app UI alone. See the Analytics module for light development configuration details.

Build your own dashboards and widgets

Create and update your own dashboards by adding widgets. Widgets are charts that display data from one of the out-of-the-box connectors — Adobe Analytics, Google Analytics, Matomo— or from any custom connectors to other third-party analytics data providers that your administrator has configured.

Use the Analytics app user-friendly interface to define specific charts with metrics that are important for you. You can change your dashboard layout and drag and drop widgets around your dashboard as you require.

Adding widgets in the Analytics app

Commonly used metrics out-of-the-box

To help you get started, Magnolia provides common metrics that every analytics tool (GA, Adobe, Matomo) supports ready to use in your widgets.

Adding a commonly used metric

Advanced widgets

If the commonly used metrics do not cover your use case, you can explore your data and add more metrics from the Analytics app.

Adding an advanced widget

The Add widget dialog expands to allow you to choose several additional chart types and select one or more series of dimension and metric combinations. A preview of the selected data is shown directly in the dialog as you build your widget.

In the case of internal data suppliers, such as file-based data supplier that fetches data from a JSON file, a JSONPath evaluator is also provided to help you by displaying the resulting JSON for each expression.

JSON path evaluator

Advanced widgets give you full access to your analytics data but not all customization possibilities in terms of chart types, colours or labelling for example. Developers can configure advanced custom charts using light development.

Filter your analytics data

Developers can define filters to drill down into the data displayed in the charts that are configured. When set, each filter is applied to all the charts in the dashboard simultaneously. For example, if you set a filter to display a given time range, all the charts display data for that time range.

Analytics where you need them

In addition to viewing analytics in the dedicated app, you can display them next to the content they apply to in IUX (Integrated User eXperience) slots.

IUX slots are places in the AdminCentral UI where elements from integrated applications or other Magnolia content apps can live. Analytics elements such as charts and widgets add value to the user’s workflow inside Magnolia. We pull in data from adjacent applications and content apps and display it in the right places so that users do not need to switch from application to application.

The first slot, introduced in Magnolia 6.2, is a wide horizontal slot at the top of content apps. Developers can configure this slot to show page analytics provided by the Analytics module. For example, in this screenshot, users can select a page to see common metrics from the connected analytics source directly in the Magnolia UI.

image

Feedback