These instructions are for administrators and editors who have activated user-provided data collection and want to start sending user-provided data from a website using Google Tag Manager.
Before you begin
You must turn on user-provided data collection in Google Analytics.
Choose how to set up data collection
Choose how you want to set up user-provided data collection in Tag Manager:
| Option | Description |
|---|---|
| Automatic collection | Google Analytics inspects your web pages for strings that match the pattern for an email address. Phone numbers and addresses are excluded from the option. We recommend supplementing the option with the following options. Learn more about this option |
| Manual configuration | Select the types of user-provided data you want to collect, such as email addresses or phone numbers. For each type of data, select how you want to identify the data on the page — either a CSS selector or global JavaScript variable. Learn more about this option This method is more precise than automatically detecting user-provided data, but not as reliable as adding a code snippet to your website. If you frequently change your website code, in particular the formatting or CSS selectors on the collection page, you may want to consider adding a code snippet to your website. |
| Code | Add JavaScript code to your web pages to collect email addresses, phone numbers, and/or names and addresses. Then, set the user_data parameter for each event on the page. Learn more about this option |
Fields to set
The following table describes each field you can set. The key name shows how you must reference the field in your code. You must pass the data as a String type. When defining name and address, make sure to define each component as an individual variable (for example, first name, last name, and so on).
Note: If you want to send unhashed data and let Google normalize and hash the data, use the first key name for each data field. For example, email in the Email address data field below. If you want to send hashed data, use the key name that begins with sha256_.
email
User email.
Example: ‘jdoe@example.com’
sha256_email_address
Hashed user email.
Example:
‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’
phone_number
User phone number. Must be in E.164 format , which means it must be 11 to 15 digits including a plus sign (+) prefix and country code with no dashes, parentheses, or spaces.
Example: ‘+11231234567’
sha256_phone_number
Hashed user phone number.
Example:
‘e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1’
address.first_name
User first name.
Example: 'John'
address.sha256_first_name
Hashed user first name.
Example:
‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’
address.last_name
User last name.
Example: 'Doe'
address.sha256_last_name
Hashed user last name.
Example:
‘799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f’
address.street
address.city
address.region
address.postal_code
address.country
