Skip to main content

Integrating other analytics platforms

You can add third-party analytics to your Shorthand stories in two ways: across every story that uses your theme, or story by story. This guide covers both, plus how to set up Mixpanel, which works a little differently.

​Google Tag Manager & Analytics

Across all stories that use your theme

Contact our team to install either of the following into your custom branded theme:

  1. A tag manager, such as Google Tag Manager — manage your third-party analytics deployment through the tag manager, and it will apply to every story that uses that theme.

  2. Your analytics code snippet — the tracking code is included in every published story that uses that theme.

The advantage of the first method is that you can make changes to your installation at any time plus add additional trackers, conversion events, marketing pixels, and cookie consent managers without needing Shorthand to do these changes for you, resulting in quicker implementation.

Both methods are part of a custom branded theme, available on Business plans and above. If you currently do not have a hand-built Shorthand theme, please contact us at any time to discuss your requirements.

For individual stories

Beyond Google Analytics and Google Tag Manager, you can add tracking code to a single story using the custom JavaScript feature (available on select plans).

Alternatively, if you are publishing using one of our export methods, you can insert the necessary code post-export. When given the choice, we advise adding the code within Shorthand, to save time if re-exporting is necessary further down the line.

Implementing a third-party analytics platform (Example)

Mixpanel

Mixpanel is a third-party analytics platform which is built specifically for tracking how your readers are interacting with your Shorthand Stories and webpages. However, unlike Google Analytics & Google Tag Manager, this requires implementation using the Custom Javascript they provide within the Head Tag of your Stories or Projects.

Adding Mixpanel to a single Shorthand Story

  1. Open your Shorthand story in the story editor

  2. Select SETTINGS tab in the top bar and scroll down to "Allow custom HTML in the page head":

  3. Paste your Mixpanel Javascript snippet they have provided you into this area, ensuring you have added YOUR_PROJECT_TOKEN correctly and that it does include <script></script> around the code, for example:

    <script type="text/javascript">
    // Create an instance of the Mixpanel object
    mixpanel.init("YOUR_PROJECT_TOKEN", {
    autocapture: true,
    track_pageview: true,
    record_sessions_percent: 100, //records 100% of all sessions
    record_heatmap_data: true,
    });
    </script>

Adding Mixpanel to a Shorthand Project (Multiple Shorthand Stories)

  1. Open your Shorthand Project Settings

  2. Navigate to the SETTINGS tab

  3. Paste your Mixpanel Javascript snippet they have provided you into "Custom Head":

    1. Ensure you have added YOUR_PROJECT_TOKEN correctly and that it does include <script></script> around the code, for example:

      <script type="text/javascript">
      // Create an instance of the Mixpanel object
      mixpanel.init("YOUR_PROJECT_TOKEN", {
      autocapture: true,
      track_pageview: true,
      record_sessions_percent: 100, //records 100% of all sessions
      record_heatmap_data: true,
      });
      </script>
Did this answer your question?