Adding the Magiq File to your site

To make Magiq work you have to make just one change to your site to include the Magiq File - this should be the last change you ever need to make - all Magiq's products need this same file, so it's a one-shot fix.

(...and in fact this change can be made at the load balancers/web servers - so you might not need to change the content at all!)

Sorry, this next part is a bit technical :-(  - but there is a video

Suggestion:Perhaps you can send a link to this page to your web site manager who can help you make this one change :-)

How does this all work?

When we open your Magiq account we will e-mail you the link to your Magiq home page (this is located in your Magiq 'Instance').

You download your Magiq file (and the Magiq Management App) from this home page. Your Magiq file will be unique to your site - don't give it to other people or install someone else's (otherwise they will be able to change your site!).

You have to make the Magiq file available from your Web Server, so that your pages can call it, (putting it in the root directory of the site is often the simplest plan). Then you need to get the pages on your site call this file (using the script listed below in red).

The file is not dependant on the technology you use to build your site or the type of web server, it will work with any HTML  pages, no matter how they are built or managed.

How do I do that?

You add a line of HTML at the end of all your web pages which will look like this example:

<script type="text/javascript" src="/MagiqFile.js"></script>

Add this statement just before the </body> tag in the page.

This statement is the ONLY change you make, no variables to set, the same HTML on every page, it never changes (honest)... If you look at the HTML for this page you will find a very similar command lurking at the end of the page content.

It is really important you put it in exactly like this - if (for example) you include the content of the Magiq File into the page (instead of using the line above), or include the file using a "server-side include" your site will run slower and the Gnomes will not work so well (if at all)!

If the HTML you add does not point to the place where you save the file nothing will work. Please don't point it to our site's Magiq file (as that won't work either!).

Here is a video discussing this whole topic.

If you don't understand what is written above, talk to the person who manages or built your site - they will be able to help - or contact us.

What pages need the Magiq file included?

Well, usually the simplest thing is to put it on every page - as this means we have the best chance of getting the data we need, and you will be able to set Gnomes to work on any page in your site in the future without any further work. (and because you only pay for the work you set the gnomes to do it does not cost you any more to have the file on every page).

Typically, amending the "footer" template in your Content Management Systems to include the "insert" is simplest way to do this.

Note: If you want you can also get the technical folk to include the insert via a proxy (like Squid or ICAP Proxy) or web server or load balancer - this avoids changing the site at all!

Many people are tempted to only put the file into the landing and other pages where they want Magiq to work. Generally this is a bad idea because Magiq will wind up with an incomplete view of your visitors' behavior and (for example) Retain and Prospect will give you the wrong answers and not have all the data it needs.

So just put the Magiq file everywhere now, and forget about the whole issue... ;-)