[GA4] Додавання фрагмента коду на вебсайт (gtag.js)

Ця функція є частиною загальнодоступної бета-версії і може бути змінена.

Ці вказівки призначено для адміністраторів і редакторів, які налаштовують збирання даних, наданих користувачами, і хочуть дізнатися, як додати фрагмент коду на вебсайт за допомогою gtag.js. Оновіть код на вебсайті, щоб електронні адреси, номери телефонів і/або імена й адреси відображалися на сторінках, коли Analytics збирає дані, надані користувачами.

Огляд

Щоб оновити код вебсайту, потрібно налаштувати значення user_data разом із кожним полем даних, наданих користувачами, у межах команд event, config або set за допомогою функції gtag( ).

Якщо ви передаєте ті самі дані за допомогою двох або більше типів команд (наприклад, event і config), то команда event перевизначає команду config, а команда config – команду set. Докладніше про пріоритетність параметрів тегу Google.

Вам потрібно оновити код на всіх сторінках, на яких ви збираєте дані, надані користувачами (наприклад, на сторінці реєстрації, сторінці залучення зацікавлених клієнтів, сторінці оформлення замовлення тощо). Дані можна надсилати кілька разів за сеанс, щоб гарантовано передати їх в Analytics.

Перш ніж почати

Щоб виконати ці вказівки, ви повинні:

мати доступ до вихідного коду вебсайту;
увімкнути збирання й використання даних, наданих користувачами;

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]’
Email address	`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’
Phone number	`sha256_phone_number`	Hashed user phone number. Example: ‘e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1’
First name	`address.first_name`	User first name. Example: 'John'
First name	`address.sha256_first_name`	Hashed user first name. Example: ‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’
Surname	`address.last_name`	User last name. Example: 'Doe'
Surname	`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", оновіть фрагмент відповідно, додавши назву змінної замість значення вашаЗміннаЕлектронноїАдреси.

Також можна задавати значення для потрібного поля безпосередньо в коді скрипта або використовувати функцію замість змінних.

// Implement

Указуйте номери телефонів у форматі E.164: 11–15 цифр, зокрема префікс "плюс" (+) і код країни без дефісів, дужок і пробілів.

Вилучення порожніх полів

Якщо ви не збираєте певний тип інформації з наведеного вище зразка коду, повністю вилучіть відповідні поля, а не залишайте їх пустими. Нижче показано код вебсайту, який збирає інформацію лише про електронні адреси й номери телефонів.

// Implement
<script>
gtag('set', 'user_data', {
"email": {{ вашаЗміннаЕлектронноїАдреси }},
"phone_number": {{ вашаЗміннаНомераТелефону }}
});
</script>

Додавання кількох значень

Можна вказати кілька значень (до 3 номерів телефонів і електронних адрес, а також до 2 адрес) за допомогою масиву. Якщо ви отримаєте кілька значень, імовірність збігу підвищиться.

first_name: вашаЗміннаІмені,

last_name: вашаЗміннаПрізвища,

street: вашаЗміннаНазвиВулиці,

city: вашаЗміннаНазвиМіста,

region: вашаЗміннаНазвиОбласті,

postal_code: вашаЗміннаПоштовогоІндексу

},
{

first_name: вашаЗміннаІмені,

last_name: вашаЗміннаПрізвища,

street: вашаЗміннаНазвиВулиці,

city: вашаЗміннаНазвиМіста2,

region: вашаЗміннаНазвиОбласті2,

postal_code: вашаЗміннаПоштовогоІндексу2

}
]
});
</script>

Чи корисна ця інформація?

Як можна її покращити?