This feature is part of an open beta. Keep in mind that the feature is subject to change.
Эти инструкции предназначены для администраторов и пользователей с правами на редактирование, которые настраивают сбор данных, предоставленных пользователями, и хотят добавить фрагмент кода на сайт с помощью gtag.js. Использование кода позволяет убедиться, что адреса электронной почты, номера телефонов и/или имена и адреса доступны на странице, когда Аналитика собирает данные, предоставленные пользователями.
Обзор
Чтобы изменить код сайта, необходимо с помощью функции gtag( ) задать значение user_data в каждом поле данных, предоставленных пользователями, в команде event, config или set.
Если вы передаете одинаковые данные с помощью двух и более типов команд (например, event и config), то команда event перезаписывает данные, полученные от команды config, а та – от команды set. Подробнее о приоритете параметров тега Google…
Вам необходимо обновить код на каждой странице, где вы собираете данные, предоставленные пользователями, например на странице регистрации, странице для привлечения потенциальных клиентов, странице оформления покупки и т. д. Чтобы данные точно были переданы в Аналитику, можете отправлять их несколько раз за сеанс.
Подготовка
В этой инструкции подразумевается, что у вас:
- есть доступ к исходному коду сайта;
- включен сбор данных, предоставленных пользователями, и настроены необходимые разрешения.
Hashing the data
You can send hashed or unhashed data from a website. If you send unhashed data, Google normalizes and hashes the data before the data reaches Google's servers. To ensure Analytics interprets the data correctly and to comply with the User-provided data policy, you must use the correct key name (in the next section).
To hash the data:
- Use hex SHA256.
To normalize the data:
- Remove leading or trailing whitespaces.
- Convert the text to lowercase.
- Format phone numbers according to the E.164 standard.
Defining the fields in your code
You must provide at least one of these fields:
- Email (preferred).
- Address (first name, last name, postal code, and country are required). You can optionally provide street address, city, and region as additional match keys.
- A phone number can also be provided along with an email or full name and address.
Make sure the data is available when the Google tag fires. If the data is collected on a previous page, make sure it’s available in your code on the current page so you can configure the field.
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_.
| Data Field | Key Name | Description |
|---|---|---|
| Email address | email |
User email. Example: ‘[email protected]’ |
sha256_email_address |
Hashed user email. Example: ‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’ |
|
| Phone number | 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’ |
|
| First name | address.first_name |
User first name. Example: 'John' |
address.sha256_first_name |
Hashed user first name. Example: ‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’ |
|
| Surname | address.last_name |
User last name. Example: 'Doe' |
address.sha256_last_name |
Hashed user last name. Example: ‘799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f’ |
|
| Street address | address.street |
User street address. Example: '123 New Rd' |
| City | address.city |
User city name. Example: `Southampton’ |
| Region | address.region |
User province, state, or region. Example: `Hampshire’ |
| Postal code | address.postal_code |
User post code. Example: 'SO99 9XX' |
| Country | address.country |
User country code. Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard. |
Как реализовать поля в коде
На каждой странице, где собираются данные клиентов, измените параметр user_data в каждом поле, которое надо определить.
Пример
Следующий пример включает названия переменных для данных клиентов. Эти названия в вашем коде должны соответствовать атрибутам на сайте. Например, если переменная для адреса электронной почты называется email_address, укажите это в коде вместо yourEmailVariable.
Вы также можете напрямую задать значение поля в коде или использовать функцию вместо переменных.
// Добавьте этот код на страницу
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***Вместо yourEmailVariable укажите название вашей переменной JavaScript, в которой хранится адрес электронной почты пользователя. Сделайте то же для остальных переменных. Значения не должны быть хешированы.
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
Номер телефона должен быть указан в формате E.164, т. е. начинаться с плюса и состоять из 11–15 цифр, включая код страны, и не содержать тире, скобок и пробелов.
Как удалить пустые поля
Если в предыдущем образце кода какие-то поля не собирали данные, не оставляйте эти поля пустыми, а удалите их из кода. Приведен пример того, как может выглядеть код для сайта, на котором собирают только адреса электронной почты и номера телефонов.
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Как добавить несколько значений
С помощью массива вы можете добавить до трех номеров телефонов и адресов электронной почты и до двух адресов. Если вы получаете несколько вариантов данных, передавайте все, чтобы повысить вероятность сопоставления.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>