Mettre en forme les données utilisateur

L'API Gestionnaire de données 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.

Conditions requises 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
Convertissez le texte en minuscules.
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.
Espace blanc Supprimez 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

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 le texte en minuscules.
N'incluez pas de préfixes tels que Mrs..
Espace blanc Supprimez 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 suffixes tels que Jr..
Espace blanc Supprimez 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 Supprimez 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 soit cinq chiffres, soit 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 Supprimez les espaces blancs de début et de fin.
Hachage Ne hachez pas postal_code.

Conditions requises 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 clean room à l'aide de l'algorithme SHA-256.
  2. Chiffrez les octets du hachage avec un chiffrement commutatif EC à l'aide de la clé de l'éditeur pour la liste des utilisateurs PAIR.
  3. Encodez les données chiffrées à l'aide de l'encodage hexadécimal ou Base64.

Conditions requises pour MobileData

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

Format de code temporel

Si vous utilisez le format JSON pour les champs Timestamp, comme timestamp et last_updated_timestamp de Event, utilisez le format RFC 3339.

Si vous utilisez le format de tampon de protocole, définissez seconds et, éventuellement, nanos lors de la construction de Timestamp.

Étapes suivantes