Cross-domain tracking<\/a>, in Google Analytics<\/a>, is the process of passing information stored in browser cookies from one domain to another. Due to web browsers\u2019 same-origin policy<\/a>, a browser cookie is only available to the domain it is written on and all its subdomains (by default). Since Google Analytics uses cookies to persist the Client ID<\/a>, once the user moves from domain to domain it\u2019s important to somehow pass this Client ID, too.<\/p>\n Cross-domain tracking isn\u2019t the easiest thing to implement, though. At its easiest, especially if you use Google Tag Manager<\/a>, it\u2019s a question of configuring a couple of fields in your Google Analytics trackers and snippets. However, issues typically arise when your website uses unconventional link redirects, or when you want to persist the Client ID in an iframe<\/a> loaded from another domain.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n In this article, I thought I\u2019d provide a short checklist<\/strong> to go through when issues with cross-domain tracking arise.<\/p>\n \n \n Subscribe to the Simmer newsletter<\/a> to get the latest news and content from Simo Ahava into your email inbox!\n <\/p>\n <\/span><\/p>\n If cross-domain tracking is working<\/strong>, all traffic from one domain to another should be part of the same session, and thus attributed to the same Source \/ Medium<\/strong> dimensions.<\/p>\n You should not use Google Analytics\u2019 Real Time Reports to analyze the cross-domain pattern!<\/strong> Real Time Reports show each hit only with the dimensions and parameters carried by the hit itself. This means that you won\u2019t be able to debug session-scoped stuff like Source and Medium using only what you see in the Real Time Reports.<\/p>\n In other words, you\u2019ll need to wait for the hits to populate in the standard reports.<\/p>\n The easiest way to verify if cross-domain tracking is working in Google Analytics, is to browse to the first domain using custom UTM parameters<\/a>, for example:<\/p>\n www.domainA.com\/?utm_source=xdom_test&utm_medium=xdom_test&utm_campaign=xdom_test<\/a><\/strong><\/p>\n Then, while still browsing the first domain, click a link or open a page with the iframe to the second domain.<\/p>\n After this is done, in the Google Analytics View which shows data from both domains, you can apply a segment to only include your custom campaign traffic:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Once the data hits the Google Analytics reports, you should find your single session when applying the segment. After that, go to the Behavior > Site Content > All Pages<\/strong> report. If cross-domain tracking is working properly, you should see both the pageview(s) from the source domain and the pageview(s) from the target domain in the report.<\/p>\n If cross-domain tracking isn\u2019t working, you\u2019ll only see the pageview(s) from the source domain. The following checklist should help in this case.<\/p>\n For cross-domain tracking to work on your website and Google Analytics Property, the following things need to all be in place.<\/p>\n All domains included in cross-domain tracking must collect data to the same Google Analytics Property<\/strong> – Jump to details<\/p>\n<\/li>\n All domains that are the source<\/em> of cross-domain traffic, i.e. the traffic departs from<\/em> these domains, need to be in the Referral Exclusion List<\/strong> of the Google Analytics Property settings – Jump to details<\/p>\n<\/li>\n When entering the target domain via a link in the source domain or an iframe, the URL of the page loaded in the web browser must have the _ga=1.234567.234567.234567<\/strong> URL query parameter in place – Jump to details<\/p>\n<\/li>\n Any Google Analytics trackers or tags firing on the target domain need to have the allowLinker<\/strong> field set to true<\/strong> – Jump to details<\/p>\n<\/li>\n<\/ol>\n These are the four basic steps you need to make cross-domain tracking work on your site. Note that steps (3) and (4) have complicated workarounds for when query parameters or the linker plugin<\/a> won\u2019t work, but in the majority of cases these four steps are enough.<\/p>\n In the following chapters, I\u2019ll examine each step in more detail.<\/p>\n A Property<\/a> in Google Analytics is a tracking configuration that collects data from your digital applications such as your website. Each Property in Google Analytics has a unique identifier, known as the Tracking ID:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Every Property has its own table of data, which comprises all the hits that are sent to that particular Property. Thus, each Property has its own users, sessions, and aggregation buckets, and these data sets are unique to each Property.<\/p>\n Because of this, it\u2019s important that when you collect cross-domain traffic across two separate domains, both domains will need to collect data to the same Google Analytics Property<\/strong>. There is no such thing as cross-domain traffic across Google Analytics properties<\/em>, and the only way to even approach something like that would be to utilize the Roll-up Reporting<\/a> feature of Google Analytics Premium.<\/p>\n Universal Analytics starts a new session whenever a new referral is detected as a traffic source. Thus, if you first enter a site via Google\u2019s organic search (google \/ organic<\/strong>), and then follow a cross-domain link from the source domain to the target domain, the target domain hit would be recorded as having originated from sourceDomain.com \/ referral<\/strong>, marking the start of a new session. And this is even if you have cross-domain tracking otherwise in place!<\/p>\n By utilizing the Referral Exclusion List, you\u2019re telling Google Analytics to disregard referral traffic from the source domain, and to treat it as Direct traffic instead. Universal Analytics relies on Direct traffic for campaign attribution as well as session stitching. Each hit in the session, after the initial acquisition, is actually a \u201cDirect\u201d hit, and this is how Google Analytics knows that the session should still be kept alive.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n So, Referral Exclusion List keeps the traffic from the source domain to the target domain part of the same session, which is crucial for you to make sense of cross-domain traffic. Thus make sure that you have all the possible source domains, i.e. domains that send traffic to other domains, in the Referral Exclusion List of your Google Analytics property settings.<\/p>\n As I said in the very beginning of this article, Google Analytics relies on the Client ID to assign hits to specific sessions and users. The Client ID is stored in a browser cookie named _ga<\/strong>, which is, by default, written on the highest possible domain name the website has access to. On my website, for example, the _ga<\/strong> cookie would be written on simoahava.com<\/strong>, and thus it is available to simoahava.com and all its possible subdomains.<\/p>\n When you move from domain to domain, this Client ID needs to somehow travel with the user, but due to the restrictions of the web browsers\u2019 same-origin policy, the target domain cannot simply fetch the cookie written on the source domain.<\/p>\n For this reason, Google Analytics has introduced the linker<\/a> plugin. When you invoke the plugin, it returns a URL query parameter which includes the Client ID as well as a signature<\/strong> which is valid for 2 minutes<\/strong>. So, if you visit a different domain URL with the query parameter within the two minute window, cross-domain traffic could be setup between the two domains.<\/p>\n The two minute window exists to prevent linker parameters from persisting in shared links and browser history entries. Otherwise every time someone would follow a link with the linker parameter in place, they would be considered the original user who created the link. This would lead into a horrible mess, as it would be almost impossible to distinguish users from each other.<\/p>\n A typical way of loading the linker plugin is by using the autoLink<\/a><\/strong> feature of the plugin. When you use autoLink, you provide it with domain names that you want to automatically decorate with the linker parameters. Then when the user clicks a link or invokes a form redirection that has the given domain name as its target, autoLink automatically decorates the URL with the linker parameters.<\/p>\n In Google Tag Manager, you\u2019d edit the Auto Link Domains field:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n You\u2019ll know its working when you see the _ga=1.234567.234567.234567<\/strong> query parameter in the URL.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n If you don\u2019t see the parameter in the URL, it means that for some reason the autoLink plugin failed. Instead, you\u2019ll need to manually decorate the URLs. This is particularly the case when working with iframes<\/strong>, as the iframe must be loaded with the linker parameters<\/a> in its To manually decorate the URLs, you or your web developer needs to write a piece of code which takes the linker parameter and appends it to the URL<\/a> of the link or the iframe just before the document is loaded.<\/p>\n So, remember that for a basic cross-domain setup to work, the URL of the target page, whether opened by a link, redirected by a form, or loaded in an iframe, needs to have the linker parameter _ga=1.234567.234567.234567<\/strong> in the URL.<\/p>\n Now you\u2019ve got the URL query parameters in place, the Referral Exclusion List has all the necessary source domains, and you\u2019re collecting data from both the source and target domain to the same Google Analytics Property.<\/p>\n Just one thing missing.<\/p>\n For the trackers in the target domain to respect the _ga=1.234567.234567.234567<\/strong> linker parameter in the URL, you need to tell the trackers to allow the linker parameter to reset the Client ID on the target domain.<\/p>\n You do this by configuring the allowLinker field in the tracker object<\/a>. In GTM, you\u2019d simply add a new field:<\/p>\n![\"cross](\"https:\/\/www.simoahava.com\/images\/2016\/08\/cross-domain-tracking-checklist.jpg#ZgotmplZ\"){kind=tracking}
<\/p>\n
\n X<\/span><\/p>\n
\n The Simmer Newsletter<\/strong>\n <\/p>\nHow to test if cross-domain tracking is working<\/h2>\n
![\"Cross-domain](\"https:\/\/www.simoahava.com\/images\/2016\/08\/custom-segment.jpg#ZgotmplZ\")
<\/p>\nThe Checklist<\/h2>\n
\n
1. Collect all data to the same Google Analytics Property<\/h2>\n
![\"Google](\"https:\/\/www.simoahava.com\/images\/2016\/08\/tracking-id.jpg#ZgotmplZ\"){kind=tracking}
<\/p>\n2. Domains in the Referral Exclusion List<\/h2>\n
![\"Referral](\"https:\/\/www.simoahava.com\/images\/2016\/08\/referral-exclusion-list.jpg#ZgotmplZ\")
<\/p>\n3. Linker parameter in the URL<\/h2>\n
![\"Auto](\"https:\/\/www.simoahava.com\/images\/2016\/08\/gtm-auto-link-domains.jpg#ZgotmplZ\")
<\/p>\n![\"linker](\"https:\/\/www.simoahava.com\/images\/2016\/08\/url-parameter.jpg#ZgotmplZ\")
<\/p>\nsrc<\/code> attribute, if you want cross-domain traffic to work between the parent page and the framed document.<\/p>\n4. allowLinker in the target domain<\/h2>\n
![\"allowLinker](\"https:\/\/www.simoahava.com\/images\/2016\/08\/allowlinker.jpg#ZgotmplZ\")
<\/p>\n![\"Network](\"https:\/\/www.simoahava.com\/images\/2016\/08\/network-debugger.jpg#ZgotmplZ\")
<\/p>\n