[GA4] Set up cross-domain measurement

This article is for website owners who need unified measurement across more than one domain, e.g. across a customer website and a separate shopping cart domain. This article pertains to Google Analytics 4 properties; if you are using Universal Analytics, read this article instead.

Cross-domain measurement allows activity to be accurately attributed to a single user as they cross domains. Outbound clicks that would ordinarily trigger an event via enhanced measurement are ignored when the outbound link leads to a domain that you've listed as part of cross-domain measurement.

Video overview

Cookies and cross-domain measurement

When there is consent, Analytics uses first-party cookies to set IDs for each unique user and each unique session.

  • Without cross-domain measurement, new cookies with new IDs are created for each domain a user visits. As a result, a single user visiting different root domains (e.g. www.example.com and www.anotherexample.com) on the same device will be identified separately (two users and two sessions instead of one user and one session).
  • With cross-domain measurement, the cookies retain the same IDs as they are passed from one domain to another via a URL parameter (_gl) when the user navigates between domains through a link or a form. As a result, Analytics identifies just one user and one session.
Note: This setup is not required for subdomains because they share the same cookies with the root domain (except when you changed the default cookie domain configuration).

If you also have a Universal Analytics property

For your Universal Analytics property, you configured cross-domain measurement via code (either in the source code through analytics.js or gtag.js, or via Google Tag Manager). For your Google Analytics 4 property, you'll do this via the Admin page. Follow the instructions below to add the same domains you've identified in your Universal Analytics page code.

If you have an existing configuration in the Google tag for your Universal Analytics property, it will be applied to your Google Analytics 4 property as well. Any domains you've specified in the code or via the Admin will apply to your Google Analytics 4 property. However, we recommend that you configure in the Admin only.

Set up cross-domain measurement via Admin

You need the Editor role to set up cross-domain measurement, and you can create up to 100 conditions.

Check your tag (e.g. the Google tag on each of your HTML pages) for each domain that you want to include in your cross-domain measurement. The tag on each page must use the same tag ID (i.e., the same "G-" ID) from the same web data stream.

  1. In Admin, under Data collection and modification, click Data streams.
  2. Click Web, then click a web data stream.
  3. In the web stream details, click Configure tag settings (at the bottom).
  4. In the Settings section, click Configure your domains.
  5. If you use the same Google tag across domains, they are automatically detected and show up in the Recommendations section. To accept a recommendation, click Add.
    To manually add a domain, click Add condition under Include domains that match the following conditions:
    • Choose a match type.
    • Under Domain, enter the identifier for the domain you want to match (e.g., example.com).
    • Add each domain you want to include in cross-domain measurement.
    Conditions are evaluated using OR logic.
  6. Click Save.

Manual setup

The recommended approach is to configure cross-domain measurement via the Analytics interface. However, there might be scenarios where you need to implement a custom solution via the measurement code. In these cases, you can set it up manually by using the get and set commands of the gtag.js API to persist IDs across domains. Learn more about setting up cross-domain measurement manually.

Example

To retrieve a client ID on the source domain, you use the get method:

  
gtag('get', 'TAG_ID', 'client_id', (client_id) => {
  // Store the client ID in a variable.
});
gtag('get', 'TAG_ID', 'session_id', (session_id) => {
  // Store the session ID in a variable.
});

  

Once you have the client and session IDs, add them to the link that points to the destination domain:

<a href="https://example.com/?clientId=XXXXX&sessionId=YYYYY">example.com</a>

 

On the destination page, read the IDs from the URL and set them with the config command:


gtag('config','TAG_ID', {
'client_id': getClientIdFromUrl(),
'session_id': getSessionIdFromUrl()
});
  

Verify that cross-domain measurement is working properly

Cross-domain measurement works by appending parameters to the URLs on your website. In rare cases, your web server might run into an error, such as returning a 5xx error response code or failing to start a download.

To verify cross-domain measurement works:

  1. Open a page of your site that contains a link or a form that points to a domain you configured for cross-domain measurement.
  2. Click the link or submit the form to navigate to the destination domain.
  3. Verify that the page loads correctly.
  4. Verify that the URL in the destination domain contains the linker parameter _gl. For example: https://www.example.com/?_gl=1*abcde5*.
  5. If your website provides any downloads: Navigate to a page with the linking parameter in the URL and start a download. Verify that the download starts successfully.

If you encounter an error, try Troubleshooting cross-domain measurement.

Troubleshooting

If you can't confirm the presence of the parameter _gl in the URL of the destination domain per the steps above, double check that the domain you configured in the interface matches the domain your site is pointing to.

It's also possible that your website is configured in a way that prevents cross-domain measurement from working correctly. With the help of an experienced web developer, investigate whether your website is being affected by the following issues.

URL redirects

If the destination page redirects or doesn't support arbitrary query parameters, the parameter _gl may end up being removed from the URL even if it was appended by Analytics in the previous page. (This usually happens too quickly to observe by eye.) To confirm if this is happening to your site, check the network requests made by the previous page using the Chrome Developer Tools. To fix this issue, configure your site to preserve the parameter _gl in redirects.

Conflicts with other scripts

Cross-domain measurement works by creating an event listener on the document node of a page. When users click a link, the click event bubbles up to the document node and the parameter _gl is added to the link URL. This process cannot work properly in the following scenarios:

  • When the navigation is triggered by JavaScript as opposed to a direct response to a user action.
  • When competing scripts in the page stop the event propagation before it reaches the document node; for example, when Event.stopPropagation() is used.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
16168965228618152831
true
Search Help Center
true
true
true
true
true
69256
false
false