Ова функција је део отворене бета верзије и подложна је променама.
Ова упутства су за администраторе и уређиваче који подешавају прикупљање података које доставе корисници и желе да сазнају како да додају фрагмент кода на веб-сајт помоћу ознаке gtag.js. Ажурирањем кода на веб-сајту обезбеђујете да су имејл адресе, бројеви телефона и/или имена и адресе доступни на страници када Аналитика прикупља податке које доставе корисници.
Преглед
Да бисте ажурирали кôд веб-сајта, морате да подесите вредност user_data уз свако поље са подацима које доставе корисници у команди event, config или set помоћу функције gtag( ).
Ако исте податке прослеђујете у најмање два типа команди (на пример, event и config), команда event замењује команду config, а команда 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: ‘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. |
Примена поља у коду
На свакој страници на којој прикупљате податке о клијентима конфигуришите параметар user_data са сваким пољем које желите да дефинишете.
Погледајте пример
Следећи пример садржи називе променљивих за податке о клијентима. Називи променљивих у коду морају да се подударају са атрибутима на веб-сајту. На пример, ако чувате имејл у променљивој email_address, треба да ажурирате фрагмент (нпр. yourEmailVariable) називом те промењиве.
Можете и да фиксно кодирате поље помоћу стринга или да користите функцију уместо променљивих.
// Implement
<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>
Додајте више вредности
Можете да наведете више вредности (до 3 броја телефона, 3 имејл адресе и 2 адресе) помоћу низа. То повећава вероватноћу подударања ако прикупите више од једне вредности.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>