Send user IDs

The User-ID feature lets you associate your own identifiers with individual users so you can connect their behavior across different sessions and on various devices and platforms.

This article describes how to send user IDs from your website once you've generated the user IDs. To learn more about the User-ID feature, see Measure activity across platforms. To learn how to set a user ID for an app, see Set a user ID instead.

Google tag Tag Manager

Before you begin

This guide assumes that you've done the following:

• Create a Google Analytics 4 account and property
• Create a web data stream for your website
• Place the Tag Manager snippets on your website
• Install the Google tag in Tag Manager

It also assumes that you have the following:

• Access to the Tag Manager container for the website
• The Editor (or above) role to the Google Analytics account

Send user IDs

Step 1: Update your data layer

Before you send user IDs to Analytics, make the user_id available in your data layer on your website.

dataLayer.push({
  'user_id': 'USER_ID'
});

Step 2: Create a data layer variable

1. In Google Tag

   Manager, click Variables.

2. In the User-Defined Variables section, click New.

3. Click Variable Configuration > Data Layer Variable.

4. Enter a name for the variable at the top.

5. In the Data Layer Variable Name field, enter a name for your user ID variable (such as "user_id").

6. Click Save.

Step 3: Modify your Google tag

Finally, modify the Configuration tag so all events associated with the tag use the Data Layer variable:

1. In Tag Manager, click Tags.
2. Select your Google tag.
3. Under Configuration settings section, add a new row with the following parameters:
   • Parameter: user_id
   • Value: Select the Data Layer variable you created.
4. Click Save.
5. Click Submit to publish the changes.