Upgrading to the new script

June 01, 2022 12:55

Not backward compatible

The new script (symplify) is not backward compatible with the old (sitegainer). Old projects won't be editable/previewable once the script link is exchanged on the website. To get the new script you need to create a new website in Symplify. This means you get a new unique website id and thus a new script (empty of projects).

So if you have running projects with your old script we recommend finishing these before upgrading to the new script. If you have personalizations running we recommend saving the code and settings for these in a document so that you easily can transfer these (copy/paste the code) to a new project that is created on the new website (with the new script).

Notice that if your old projects have been created through the WYSIWYG-editor (visual editor) you need to add jQuery in website settings for the new script for them to work. This also applies if you have coded your projects manually and used jQuery in your code.

We do however recommend you translate these to Javascript instead and lose the jQuery dependency. That is if you do not already have jQuery on your website.

Also notice that we do not allow having both the new and the old script implemented on the website at the same time.

Creating a new website to get the new script

To get the new script you need to create a new website in the Symplify UI. To do this click on My websites and then click the New website button. Then enter your website information and click Add website. This will create a new website that uses the new script.

Implementation

To get your unique implementation script click the website in the listing and then click Implementation script in the project menu. You will now see your unique script link that should replace the old script link.

If the “old” script link is implemented correctly in the <head> tag and works well today you just need to exchange that script link with the new one (that has a new website ID).

However, if your previous script link is not implemented optimally then it might be a good time to revise this. Please follow the instructions from the Implementation script popup (this info can also be seen in the above image).

Multiple markets on the same top domain?

We recommend having one website/script per top domain and setting the market (for example domain.se, domain.dk, domain.no, etc) with Audience instead of having different script implementations for each of these.

The advantage of this is that you can set up a project that runs on multiple markets instead of having to set up a new project for each market.

Push goals and/or Tracking code

If you have old Push goals implemented on your website and/or the Tracking code implemented on the website you also need to update the function call(s) for these.

Push goals will need to be set up again through the new Goal editor. If you previously have these set up as website goals (goals that should register on all projects) you need to set these as Standard goals (once set up in the first project)

The Tracking code
If you have a tracking code implemented for the previous script this needs to be replaced by a Push goal Read more about the new Tracking code.

Website settings before creating the first project

With the new script, there are a couple of decisions and settings you need to make before creating the first project.

All these settings are of course editable even after creating a project, but the changes will only apply to new projects.

You can also change Audience mode and Google Analytics sync on a project level in the Editor.

We suggest checking out the documentation for the new Audience and Goal setup as these have a whole new UI.

For further information regarding the new script please check our documentation, starting with the get started guide.