Cross-domain visitor tracking in iPaper

If you’re tracking to an existing Google Analytics property and you would like to be able to follow your visitors from flipbook to website, or the other way around. There are a few extra steps you need to take to enable this excellent feature.

Important note: 

If you're using a branded domain, and you are serving your iPaper publications from a sub-domain (Example: catalogs.YourDomain.com), you can skip this guide entirely.

This is because Google Analytics tracks sessions across sub-domains out of the box if you're using their default tracking script.

1. Add the domain you want to share visitor data with.

For cross-domain tracking to work, we need to know what domains you want to share visitor data with. This is a security measure set in place by Google, so only domains that trust each other, share data with each other. The domain or domains we need to know about are the domains that are tracked to the same property as the iPaper publications.

2. Enable Cross-domain on your website.

Out of the box, Google Analytics doesn’t have Cross-domain tracking enabled, but with the official plugin linker from Google, we can enable this functionally.

To enable Cross-domain tracking support on your domain you need to tweak your  tracking script a bit. If you’re comfortable with this yourself, that’s awesome, and if not, you probably want to forward this guide to the person who normally handles your tracking scripts updates.

Here's what needs to change in the Google Analytics code found on your website.

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['viewer.ipaper.io']);

Let's break down this snippet so we know what's happening:

Line 1: ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});

Here we tell the Analytics script that we want it to look for a  clientID in the URL, and use it if it's present.

Line 2: ga('require', 'linker');

Here we load the linker plugin, which is required for this to work.

Line 3: ga('linker:autoLink', ['viewer.ipaper.io']);

And lastly, we tell the script to tag all flipbooks links with a client-ID. This is required so we, in the flipbook, can identify the user and continue his session in the flipbook.

To read more about the linker plugin and what it does,  go to the official linker documentation

If you're having trouble getting the script to load correctly, please contact us at support@ipaper.io and we'll assist however we can.

3. Exclude the iPaper viewer domain from referrers

All domains that are part of the cross-domain setup should be excluded as a referrer, as not doing this, will cause a discrepancy between you sessions and referrers.

To do this follow the official guide by Google, and return here once it’s done.  https://support.google.com/analytics/answer/2795830

With this in place, you will see that visitors on your flipbooks will be tracked across the domains, and will be seen as the same visitor when they hit your domain.

We hope you found this helpful :)

Did this answer your question?