Mettre en forme les données utilisateur

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.

• UserData: données fournies par l'utilisateur, telles qu'une adresse e-mail ou un numéro de téléphone.
• IpData: données IP, telles qu'une adresse IP et les codes temporels associés.
• PairData : identifiants PAIR (Publisher Advertiser Identity Reconciliation).
• MobileData: données identifiant un appareil mobile.

Exigences concernant UserData

Un objet UserData est un ensemble d'objets UserIdentifier. Chaque UserIdentifier possède exactement l'un des attributs du tableau suivant.

UserIdentifier
email_address	Format string Convertissez en minuscules. Si l'adresse e-mail comporte le gmail.com ou googlemail.com domaine : Supprimez tous les points (.) avant le @ symbole. Supprimez le signe plus (+) de la partie locale et supprimez tous les caractères qui le suivent. Exemple: [e-mail] → [e-mail] 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 : [e-mail] → [e-mail] 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 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 [phone] doit être mis en forme et normalisé au format [phone]. 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	AddressInfo objet Consultez la AddressInfo spécification de format.

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 Convertissez 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 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. Encodez les octets de hachage à l'aide de l'encodage hexadécimal ou Base64.
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. 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 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 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 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.

Exigences concernant IpData

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.

Exigences concernant PairData

Renseignez le champ pair_ids d'un objet PairData avec une liste d'identifiants. 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é éditeur pour la liste d'utilisateurs PAIR.
3. Encodez les données chiffrées à l'aide de l'encodage hexadécimal ou Base64.

Exigences concernant MobileData

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

Format de date et d'heure

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 à 17h18min44s291 au format RFC 3339 et dans différents fuseaux horaires :

• Fuseau horaire UTC : 2025-08-08T17:18:44.291Z
• Fuseau horaire EDT, qui était 4 heures avant l'UTC à ce moment-là : 2025-08-08T13:18:44.291-04:00
• Fuseau horaire PDT, qui était 7 heures avant l'UTC à ce moment-là : 2025-08-08T10:18:44.291-07:00
• Fuseau horaire de Tokyo, au Japon, qui était 9 heures en avance sur l'UTC et ne respecte pas l'heure d'été : 2025-08-08T22:18:44.291+09:00

Si vous utilisez le format de tampon de protocole, définissez les seconds et, éventuellement, les nanos lors de la création du Timestamp. Voici les valeurs seconds et nanos pour l'heure UTC du 8 août 2025 à 17h18min44s291 :

• seconds: 1754683124
• nanos: 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 encoding.