This feature is part of an open beta. Keep in mind that the feature is subject to change.
Ces instructions s'adressent aux administrateurs et aux éditeurs qui configurent la collecte des données fournies par les utilisateurs et qui souhaitent savoir comment ajouter un extrait de code à leur site Web à l'aide de gtag.js. Mettre à jour le code de votre site Web permet de vous assurer que les adresses e-mail, les numéros de téléphone, et/ou les noms et adresses, sont disponibles sur la page quand Analytics collecte les données fournies par les utilisateurs.
Présentation
Pour mettre à jour le code de votre site Web, vous devez définir la valeur "user_data" avec tous les champs de données fournies par les utilisateurs dans une commande "event", "config" ou "set" à l'aide de la fonction gtag( ).
Si vous transmettez les mêmes données dans deux types de commandes ou plus (par exemple, "event" et "config"), la commande "event" remplace la commande "config", et la commande "config" remplace la commande "set". En savoir plus sur la priorité des paramètres de la balise Google
Vous devez mettre à jour le code sur toutes les pages sur lesquelles vous collectez des données fournies par les utilisateurs (par exemple, une page d'inscription, de génération de prospects, de paiement ou similaire). Vous pouvez envoyer les données plusieurs fois au cours d'une session pour vous assurer qu'elles sont transmises à Analytics.
Avant de commencer
Ces instructions supposent que vous respectez les conditions suivantes :
- Vous avez accès au code source de votre site Web.
- Vous avez activé la collecte et autorisé l'utilisation des données fournies par les utilisateurs.
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. |
Implémenter les champs dans votre code
Sur toutes les pages sur lesquelles vous collectez des données client, configurez le paramètre "user_data" avec chaque champ que vous souhaitez définir.
Voir un exemple
L'exemple suivant inclut des noms de variables pour les données client. Assurez-vous que ceux de votre code correspondent aux attributs de votre site Web. Par exemple, si vous stockez des adresses e-mail dans une variable intitulée "email_address", vous devez mettre à jour l'extrait avec ce nom (par exemple, là où vous voyez votreVariableAdresseE-mail).
Vous pouvez aussi coder le champ en dur avec une chaîne ou utiliser une fonction au lieu de variables.
// Implement
<script>
gtag('set', 'user_data', {
"email": votreVariableAdresseE-mail, *** Remplacez votreVariableAdresseE-mail par le vrai nom de la variable JavaScript dans laquelle vous stockez l'adresse e-mail de l'utilisateur. Procédez de la même manière pour les autres variables ci-dessous. Assurez-vous que les valeurs ne sont pas hachées.
"phone_number": votreVariableNuméroDeTéléphone,
"address": {
"first_name": votreVariablePrénom,
"last_name": votreVariableNom,
"street": votreVariableAdressePostale,
"city": votreVariableVille,
"region": votreVariableRégion,
"postal_code": votreVariableCodePostal,
"country": votreVariablePays
}
});
</script>
Le numéro de téléphone doit utiliser le format E.164, c'est-à-dire comporter entre 11 et 15 chiffres précédés du signe plus (+) et du code pays, sans tirets, parenthèses, ni espaces.
Supprimer les champs vides
Si vous ne collectez pas certains champs de l'exemple de code précédent, supprimez-les entièrement du code au lieu de les laisser vides. Par exemple, voici à quoi ressemblerait le code d'un site Web qui ne collecterait que des adresses e-mail et des numéros de téléphone :
<script>
gtag('set', 'user_data', {
"email": {{ votreVariableAdresseE-mail }},
"phone_number": {{ votreVariableNuméroDeTéléphone }}
});
</script>
Ajouter plusieurs valeurs
Vous pouvez fournir plusieurs valeurs (jusqu'à trois numéros de téléphone et adresses e-mail, et deux adresses) à l'aide d'un tableau. Si vous capturez plusieurs valeurs, vous augmenterez la probabilité d'une correspondance en les fournissant toutes.
gtag('set', 'user_data', {
"email": [votreVariableAdresseE-mail1, votreVariableAdresseE-mail2],
"phone_number": [votreVariableNuméroDeTéléphone1, votreVariableNuméroDeTéléphone2],
"address": [
{
{
]
});
</script>