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

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

• UserData : данные, предоставленные пользователем, такие как адрес электронной почты или номер телефона.
• PairData : идентификаторы сверки идентификаторов издателя и рекламодателя (PAIR).
• MobileData : данные, идентифицирующие мобильное устройство.

Требования UserData

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

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

Формат AddressInfo

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

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

Требования PairData

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

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

Требования MobileData

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

Формат временной метки

При использовании формата JSON для полей Timestamp , таких как timestamp и last_updated_timestamp для Event , используйте формат RFC 3339 .

При использовании формата буфера протокола задайте seconds и, при необходимости, nanos при построении Timestamp .

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

• Узнайте, как шифровать данные пользователя .