This feature is part of an open beta. Keep in mind that the feature is subject to change.
Настоящите инструкции са за администратори и редактори, които искат да научат как да настроят фрагмента от код за събиране на предоставени от потребителя данни на уебсайта си чрез Мениджър на маркери на Google.
Ако актуализирате кода си, в сравнение с другите опции за конфигуриране, ще имате по-голяма сигурност, че имейл адресите, телефонните номера и/или имената и адресите са налице на страницата, когато Анализ събира предоставени от потребителя данни.
Общ преглед
За да настроите фрагмента от код с помощта на Мениджър на маркери на Google, изпълнете следните стъпки:
- Идентифицирайте и дефинирайте полетата за предоставени от потребителя данни в кода на уебсайта.
- Предайте на всяко поле за предоставени от потребителя данни в персонализирана променлива на JavaScript към Google Анализ.
Забележка: Можете да изпращате хеширани или нехеширани данни за клиентите към Google Анализ. Когато изпращате нехеширани данни, Google ги хешира вместо Вас, преди да ги съхрани на сървърите си. Можете също да хеширате данните при себе си, преди да ги изпратите до Google.
Преди да започнете
В настоящите инструкции се приема, че разполагате със следното:
- достъп до изходния код на уебсайта Ви;
- Събирането на предоставени от потребителя данни е активирано и възможностите за предоставени от потребителя данни са разрешени.
- настроен маркер „Google Анализ: Събитие в GA4“ в контейнера в Мениджър на маркери на Google;
- ролята Администратор в собствеността в 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: ‘jdoe@example.com’ |
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. |
Актуализиране на маркера за събитие с персонализирана променлива на JavaScript
Преди да актуализирате контейнера си в Мениджър на маркери, прочетете как да актуализирате персонализирания код на JavaScript, който ще добавите към контейнера си.
- Влезте в профила си в Мениджър на маркери на Google.
- В раздела Работно пространство кликнете върху Маркери вляво.
- Отворете маркера Google Анализ: Събитие в GA4, където събирате данни за клиентите. Маркерът за събитие трябва да използва ID на измерването за потока от мрежата, където се събират потребителските данни.
- Изберете Включване на предоставени от потребителя данни от уебсайта Ви.
- В падащото меню Потребителски данни изберете или създайте променлива за предоставените от потребителя данни.
- Ако създавате нова променлива, в променливата за предоставени от потребителя данни изберете Код.
- В падащото меню Източник на данни кликнете върху Нова променлива....
- Кликнете върху Конфигуриране на променлива > Персонализиран JavaScript.
- Въведете име за персонализираната променлива в JavaScript в горната част на страницата.
- В текстовото поле Персонализиран JavaScript въведете фрагмента от код. Научете как.
- Запазете новите променливи и запазете маркера за събитие.
- Горе вдясно кликнете върху Изпращане, за да публикувате промените.
Създаване на фрагмента от код за събиране на предоставени от потребителя данни
Можете да използвате следния код, когато настройвате персонализираната променлива в JavaScript в стъпка 10:
function () {
return {
"email": yourEmailVariable , // заменете yourEmailVariable с името на променливата, която съдържа имейл адреса на потребителя
"phone_number": yourPhoneVariable , // повторете това за yourPhoneVariable и другите имена на променливи по-долу
"address": {
"first_name": yourFirstNameVariable ,
"last_name": yourLastNameVariable ,
"street": yourStreetAddressVariable ,
"city": yourCityVariable ,
"region": yourRegionVariable ,
"postal_code": yourPostalCodeVariable ,
"country": yourCountryVariable
}
}
}
Друга възможност е да използвате твърдо програмиране за полето с низ или да използвате функция вместо променливи.
// Внедряване
<script>
gtag('set', 'user_data', {"sha256_email_address": yourNormalizedandHashedEmailVariable,"sha256_phone_number": yourNormalizedandHashedPhoneVariable,"address": {"address.sha256_first_name": yourNormalizedandHashedFirstNameVariable,"address.sha256_last_name": yourNormalizedandHashedLastNameVariable,"city": yourCityVariable,"region": yourRegionVariable,"postal_code": yourPostalCodeVariable,"country": yourCountryVariable}
});
</script>Ако искате да предоставите хеширани стойности на потребителските данни, можете да използвате следния примерен фрагмент:
async function processUserData() {
const userData = {'sha256_email_address': await hashEmail(email.trim()),'sha256_phone_number': await hashPhoneNumber(phoneNumber),'address': {'address.sha256_first_name': await hashName(firstName),'address.sha256_last_name': await hashName(lastName),'city': city,'region': region,'postal_code': postalCode,'country': country,},
};
return userData;Телефонният номер трябва да е във формат E.164, което означава, че трябва да е с дължина от 11 до 15 цифри, включително знак плюс (+) и код на държавата без тирета, скоби или интервали.
Next steps
Validate that user-provided data collection is set up correctly. Show me how.