BySide Integration into CoreMedia

Last updated 4 minutes ago

How to integrate BySide in CAE or Headless Server using Tag Management

LightbulbWhat you'll learn

  • Integrating CoreMedia BySide into your website

Person reading a bookPrerequisites

  • CoreMedia system with CAE and/or Headless Server
  • Basic knowledge of CoreMedia Studio and BySide
  • A BySide Webcare account with a Webcare ID

WristwatchTime matters

Reading time: 5 minutes

Person in front of a laptopShould I read this?

This guide is for Developers and administators.

This how-to describes the integration of the BySide active tag in the CAE or Headless Server. Currently, BySide’s management system provides analytics tags, personalized URL address file loading, and custom HTML/Javacript code. By using tags, you can make accurate analysis of your visitors, and allows you to create different marketing actions for better retention and client conversion.


To integrate BySide into the CoreMedia system, you need to have a BySide account. If you don’t have an account, contact BySide at to get one.

Integrating BySide Active Tag

To enable features of CoreMedia BySide, you need to add a JavaScript tag to your website, which contains your BySide Webcare ID and the URL to the BySide JavaScript. The JavaScript tag is provided by BySide and contains the necessary code to load the BySide JavaScript.

Getting your BySide Tag

Log into your BySide Backoffice and open the Scripts list.


Here, you find the script snippet that you need to add to your website. It contains your Webcare ID and the URL to the JavaScript. Copy the code.


Adding BySide Tags to the CAE

CoreMedia supports Tag management by offering a simple way to add tags to your website as described in Tag Management. With the user interface of CoreMedia Studio, it is easy to dynamically set up tag management systems during runtime.

To do so, open the TagManagement content item in Studio and add the code that you have copied from BySide to the "head" struct :

var bysideWebcare_webcare_id = "<your webcare id>";
var bysideWebcare_lang = "<the locale of the site>";

<script src="" type="text/javascript"></script>

Now for every page of your website, the BySide integration is enabled.

Adding BySide Tags to the Headless Server

To enable features of CoreMedia BySide, you need to add the BySide active tag to all pages. The Spark app has a built-in support since release 2310.0.0 (see the Spark App documentation) All you need to do, is to add your Webcare ID and optionally the URL to your script file to the environment variables. The language will be configured automatically based on the given site.

To enable the BySide active tag in the Spark app, add the following environment variable to the .env file and add the values from the snippet that you have copied from your BySide account.


If you’re not using the default script URL, add your custom URL as another environment variable.

Copyright © 2024 CoreMedia GmbH, CoreMedia Corporation. All Rights Reserved.