Mettre en forme les données utilisateur

L'API Data Manager permet d'importer plusieurs types de données utilisateur. Suivez 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.

Configuration requise pour UserData

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
  • Convertir 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 et encodez les octets de hachage.
phone_number
Format
string
Utilisez le format E.164.
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 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 et encodez les octets de hachage.
address

Format AddressInfo

Suivez les consignes de mise en forme ci-dessous pour créer l'attribut address d'un UserIdentifier.

AddressInfo
given_name
Format
string
Convertir 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 et encodez les octets de hachage.
family_name
Format
string
Convertir en minuscules.
N'incluez pas de suffixes tels 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 et encodez les octets de hachage.
region_code
Format
string
Code ISO-3166-1 alpha-2 à deux caractères.
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. Utiliser 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.
La rue et le numéro de l'adresse de l'utilisateur.
Convertir en minuscules.
Supprimez les symboles.
Espace blanc Supprime les espaces blancs de début et de fin.
Hachage Hachez les données à l'aide de l'algorithme SHA-256 et encodez les octets de hachage.
city
Format
string
Utilisé uniquement pour Google Analytics.
Ville de l'adresse de l'utilisateur.
Convertir en minuscules.
Supprimez les symboles.
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).
Convertir en minuscules.
Supprimez les symboles.
Espace blanc Supprime les espaces blancs de début et de fin.
Hachage Ne hachez pas administrative_area.

IpData exigences

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 (vous pouvez utiliser des majuscules ou des minuscules).
Espace blanc Supprime les espaces blancs de début et de fin.
Hachage Ne hachez pas ip_address.

Configuration requise pour PairData

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 :

  1. Hachez les données permettant d'identifier personnellement l'utilisateur fournies par la salle blanche à l'aide de l'algorithme SHA-256.

  2. Chiffrez les octets de hachage avec un chiffrement commutatif EC à l'aide de la clé de l'éditeur pour la liste d'utilisateurs PAIR.

  3. Encodez les données chiffrées à l'aide de l'encodage hexadécimal ou Base64.

MobileData exigences

Renseignez le champ mobile_ids d'un objet MobileData avec une liste d'ID mobiles. Ne hachez pas les ID d'appareils mobiles.

Format de code temporel

Si vous utilisez le format JSON pour les champs Timestamp, tels que 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 à UTC-4 à ce moment-là : 2025-08-08T13:18:44.291-04:00

  • Fuseau horaire PDT, qui était de sept heures avant l'heure UTC à ce moment-là : 2025-08-08T10:18:44.291-07:00

  • Fuseau horaire de Tokyo, au Japon, qui est en avance de neuf heures par rapport à l'heure UTC et 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 : 1754683124

  • nanos : 291000000

Encodage

Les exigences d'encodage diffèrent selon que vous chiffrez ou non les données utilisateur :

Workflows d'encodage

  • Données utilisateur non chiffrées : encodez les octets de hachage SHA-256 à l'aide de l'encodage hexadécimal (hex) ou de l'encodage Base64.

  • Données utilisateur chiffrées : si vous chiffrez les données utilisateur, vous devez encoder les octets de hachage bruts en base64 avant le chiffrement. L'encodage hexadécimal n'est pas compatible avec le hachage de pré-chiffrement. Vous pouvez ensuite encoder le texte chiffré obtenu à l'aide de l'encodage hexadécimal ou Base64.

Précédent
Configurer les destinations et les en-têtes
Suivant
Chiffrer les données utilisateur