User-ID for cross-platform analysis

This help center article is part of the App + Web Property Beta.

App + Web properties are not currently supported in the Analytics app.

The User-ID feature lets Analytics present a cross-platform, cross-device view of your users' behavior.

To use this feature, you have to be able to generate your own unique, persistent IDs, consistently assign those IDs to your users, and include the IDs along with the data you send to Analytics.

Analytics creates a single user journey from all the data that is associated with the same user ID.

The earliest date from which you can see User-ID data is July 16, 2019.

Reporting identity

You can choose one of two methods to identify user data for reporting:

  • By User-ID and device: this method uses the more accurate User-ID if it is collected to identify a user and unify all related events in reporting and analysis. If no User-ID is collected, then Analytics uses a device ID, either the Analytics cookie for websites or the App-Instance ID for apps, to identify a user.
  • By device: this method uses only the device ID, either the Analytics cookie for websites or the App-Instance ID for apps, to identify a user, and ignores any User-IDs that were collected.

You can find these options in Analytics Admin under Default Reporting Identity (see below).

The option you choose does not affect data collection or processing. You can switch between the options at any time without making any permanent impact on data.


You implement User-ID first in your site or app, and then in Analytics Admin.

In your site or app

To implement User-ID on your website via the global site tag, follow these instructions.

To implement User-ID in your app via the SDK, follow the instructions for iOS or Android.

In Analytics Admin

After you update your site or app to collect user IDs, you can update your property configuration in Analytics Admin to change the reporting identity you want to use.

  1. Sign in to Google Analytics.
  2. Click Admin, and navigate to the property you want to edit.
  3. In the Property column, click Default Reporting Identity.
  4. Select either By User-ID and device (default setting) or By device only.
  5. Click Save.

Report filters

After you implement User-ID in your site/app and confirm the settings of your Analytics property, you can filter your reports to include only signed-in data.

Without that filter applied, you see all signed-in and signed-out data together.

When you include only signed-in users, you may notice some differences in your data since Analytics is deduplicating those users:

  • Lower user counts
  • Higher per-user values

You'll also see additional data like how many of those users engaged with your business on multiple platforms.


Limits and guidelines

Learn more about the limits to User-ID and the guidelines you need to observe.

Was this helpful?
How can we improve it?