Форматировать пользовательские данные

API диспетчера данных поддерживает загрузку нескольких типов пользовательских данных. Следуйте требованиям к форматированию, хешированию и кодированию для каждого элемента данных, чтобы обеспечить успешный прием и обработку ваших данных.

Требования UserData

Объект UserData — это коллекция объектов UserIdentifier . Каждый UserIdentifier имеет ровно один из атрибутов, перечисленных в следующей таблице.

Идентификатор пользователя
email_address
Формат
string
Преобразовать в нижний регистр.
ПробелыОбрезать начальные, конечные и промежуточные пробелы.
ХешированиеХэширование с использованием алгоритма SHA-256 . Закодируйте байты хеша, используя шестнадцатеричную кодировку или кодировку Base64.
phone_number
Формат
string
Используйте формат E.164 .
Добавьте знак плюса ( + ) и код страны.
ПробелыОбрезать начальные и конечные пробелы.
ХешированиеХэширование с использованием алгоритма SHA-256 . Закодируйте байты хеша, используя шестнадцатеричную кодировку или кодировку Base64.
address
Объект AddressInfo

Формат AddressInfo

Используйте следующие рекомендации по форматированию для создания атрибута address UserIdentifier .

АдресИнформация
given_name
Формат
string
Преобразовать в нижний регистр.
Не включайте префиксы, такие как Mrs.
ПробелыОбрезать начальные и конечные пробелы.
ХешированиеХэширование с использованием алгоритма SHA-256 . Закодируйте байты хеша, используя шестнадцатеричную кодировку или кодировку Base64.
family_name
Формат
string
Преобразовать в нижний регистр.
Не включайте суффиксы, такие как Jr.
ПробелыОбрезать начальные и конечные пробелы.
ХешированиеХэширование с использованием алгоритма SHA-256 . Закодируйте байты хеша, используя шестнадцатеричную кодировку или кодировку Base64.
region_code
Формат
string
Двухсимвольный код ISO-3166-1 альфа-2 .
ПробелыОбрезать начальные и конечные пробелы.
ХешированиеНе хэшируйте region_code .
postal_code
Формат
string
Допускаются как американские, так и международные почтовые индексы.
Для адресов в США используйте либо 5 цифр, либо 5 цифр, за которыми следует 4-значное расширение. Использование 4-значного расширения может повысить коэффициент соответствия.
Для всех остальных стран не используйте расширения почтовых индексов.
ПробелыОбрезать начальные и конечные пробелы.
ХешированиеНе хэшируйте postal_code .

Требования PairData

Заполните pair_ids объекта PairData списком идентификаторов. Отформатируйте каждый элемент в списке, выполнив следующие действия:

  1. Хешируйте данные PII, предоставленные чистыми помещениями, с помощью алгоритма SHA-256 .
  2. Зашифруйте байты хеша с помощью коммутативного шифра EC, используя ключ издателя для списка пользователей PAIR.
  3. Закодируйте зашифрованные данные, используя шестнадцатеричную кодировку или кодировку Base64.

Требования MobileData

Заполните поле mobile_ids объекта MobileData списком мобильных идентификаторов . Не хэшируйте мобильные идентификаторы.

Следующие шаги