L'API Data Manager permet d'importer plusieurs types de données utilisateur. Respectez les exigences de mise en forme, de hachage et d'encodage pour chaque élément de données afin que vos données soient reçues et traitées correctement.
Un objet UserData est une collection d'objets UserIdentifier. Chaque UserIdentifier possède exactement l'un des attributs du tableau suivant.
| UserIdentifier |
email_address |
| Format |
string
- Convertissez le texte en minuscules.
- Si l'adresse e-mail comporte le domaine
gmail.com ou googlemail.com :
- Supprimez tous les points (
.) avant le symbole @.
- Supprimez le signe plus (
+) de la partie locale et tous les caractères qui le suivent.
- Exemple :
cloudy.sanfrancisco+shopping@gmail.com →
cloudysanfrancisco@gmail.com
- Si l'adresse e-mail comporte un domaine autre que
gmail.com ou googlemail.com, ne supprimez pas les points ni les signes Plus.
- Exemple :
user.name+NYC@Example.com →
user.name+nyc@example.com
|
| Espace blanc |
Supprime les espaces blancs de début, de fin et intermédiaires. |
| Hachage |
Hachez les données à l'aide de l'algorithme SHA-256.
Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
|
|
phone_number |
| Format |
string
Incluez le signe plus (+) et le code pays. Tous les caractères après le signe plus doivent être des chiffres.
Par exemple, le numéro de téléphone américain
(800)555-0100
doit être mis au format et normalisé en +18005550100.
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Hachez les données à l'aide de l'algorithme SHA-256.
Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
|
|
address |
|
Suivez les consignes de mise en forme ci-dessous pour créer l'attribut address d'un UserIdentifier.
| AddressInfo |
given_name |
| Format |
string
Convertissez le texte en minuscules.
N'incluez pas de préfixes tels que Mrs..
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Hachez les données à l'aide de l'algorithme SHA-256.
Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
|
|
family_name |
| Format |
string
Convertissez le texte en minuscules.
N'incluez pas de suffixe tel que Jr..
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Hachez les données à l'aide de l'algorithme SHA-256.
Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
|
|
region_code |
| Format |
string
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Ne hachez pas region_code. |
|
postal_code |
| Format |
string
Les codes postaux internationaux et ceux des États-Unis sont acceptés.
Pour les adresses aux États-Unis, utilisez cinq chiffres ou cinq chiffres suivis d'une extension à quatre chiffres. L'utilisation d'une extension à quatre chiffres peut améliorer votre taux de correspondance.
Pour tous les autres pays, n'utilisez pas d'extensions de code postal.
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Ne hachez pas postal_code. |
|
address_line |
| Format |
string
Utilisé uniquement pour Google Analytics.
Rue et numéro de l'adresse de l'utilisateur.
Convertissez le texte en minuscules.
Supprimez les caractères symboliques.
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Hachez les données à l'aide de l'algorithme SHA-256.
Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
|
|
city |
| Format |
string
Utilisé uniquement pour Google Analytics.
Ville de l'adresse de l'utilisateur.
Convertissez le texte en minuscules.
Supprimez les caractères symboliques.
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Ne hachez pas city. |
|
administrative_area |
| Format |
string
Utilisé uniquement pour Google Analytics.
Région administrative (État ou province) de l'adresse de l'utilisateur.
Utilisez l'abréviation à deux lettres (par exemple, ca) ou le nom complet (par exemple, california).
Convertissez le texte en minuscules.
Supprimez les caractères symboliques.
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Ne hachez pas administrative_area. |
|
Un objet IpData comporte les attributs suivants.
| IpData |
ip_address |
| Format |
string
Adresse IPv4 ou IPv6.
Pour les adresses IPv6, la casse n'a pas d'importance (majuscules ou minuscules).
|
| Espace blanc |
Supprime les espaces blancs de début et de fin. |
| Hachage |
Ne hachez pas ip_address. |
|
Renseignez le champ pair_ids d'un objet PairData avec une liste d'ID.
Mettez en forme chaque élément de la liste en procédant comme suit :
- Hachez les données permettant d'identifier personnellement l'utilisateur fournies par la salle blanche à l'aide de l'algorithme SHA-256.
- Chiffrez les octets de hachage avec un chiffrement commutatif EC à l'aide de la clé de l'éditeur pour la liste des utilisateurs PAIR.
- Encodez les données chiffrées à l'aide de l'encodage hexadécimal ou Base64.
Renseignez le champ mobile_ids d'un objet MobileData avec une liste d'ID mobiles. Ne hachez pas les ID mobiles.
Si vous utilisez le format JSON pour les champs Timestamp, comme timestamp et last_updated_timestamp de Event, utilisez le format RFC 3339. Voici quelques exemples de l'heure UTC du 8 août 2025 à 17:18:44.291 au format RFC 3339 et dans différents fuseaux horaires :
- Fuseau horaire UTC :
2025-08-08T17:18:44.291Z
- Fuseau horaire EDT, qui était à l'époque 4 heures avant UTC :
2025-08-08T13:18:44.291-04:00
- Fuseau horaire PDT, qui était à l'époque 7 heures avant UTC :
2025-08-08T10:18:44.291-07:00
- Fuseau horaire de Tokyo, au Japon, qui est 9 heures en avance sur l'heure UTC et qui n'observe pas l'heure d'été :
2025-08-08T22:18:44.291+09:00
Si vous utilisez le format de tampon de protocole, définissez seconds et, éventuellement, nanos lors de la construction de Timestamp. Voici les valeurs seconds et nanos pour l'heure UTC du 8 août 2025 à 17:18:44.291 :
seconds : 1754683124nanos : 291000000
Encodage
Tenez compte des points suivants lorsque vous encodez des données :
- La casse de la sortie d'encodage n'a pas d'importance lorsque vous utilisez l'encodage hexadécimal (hex).
- La casse de la sortie d'encodage a de l'importance lorsque vous utilisez l'encodage Base64.
