Formatar dados do usuário

A API Data Manager oferece suporte ao upload de vários tipos de dados do usuário. Siga os requisitos de formatação, hash e codificação para cada elemento de dados para garantir que seus dados sejam recebidos e processados.

• UserData: dados fornecidos pelo usuário, como um endereço de e-mail ou número de telefone.
• PairData: IDs de Reconciliação de dados de identificação entre editores e anunciantes (PAIR, na sigla em inglês).
• MobileData: dados que identificam um dispositivo móvel.

Requisitos do UserData

Um objeto UserData é uma coleção de objetos UserIdentifier. Cada UserIdentifier tem exatamente um dos atributos na tabela a seguir.

UserIdentifier
email_address	Formato string Converte para letras minúsculas. Espaço em branco Cortar espaços em branco iniciais, finais e intermediários. Hash Gerar hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
phone_number	Formato string Use o formato E.164. Inclua o sinal de adição + e o código do país. Espaço em branco Remova os espaços em branco à esquerda e à direita. Hash Gerar hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
address	Objeto AddressInfo Consulte a especificação de formato AddressInfo.

Formato AddressInfo

Use as diretrizes de formatação a seguir para criar o atributo address de um UserIdentifier.

AddressInfo
given_name	Formato string Converte em letras minúsculas. Não inclua prefixos, como Mrs.. Espaço em branco Remova os espaços em branco à esquerda e à direita. Hash Gerar hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
family_name	Formato string Converte para letras minúsculas. Não inclua sufixos como Jr. Espaço em branco Remova os espaços em branco à esquerda e à direita. Hash Gerar hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
region_code	Formato string Um código ISO-3166-1 alfa-2 de dois caracteres. Espaço em branco Remova os espaços em branco à esquerda e à direita. Hash Não faça hash de region_code.
postal_code	Formato string São permitidos CEPs e códigos postais internacionais e dos EUA. Para endereços nos EUA, use cinco dígitos ou cinco dígitos seguidos de uma extensão de quatro dígitos. O uso de uma extensão de quatro dígitos pode melhorar sua taxa de correspondência. Para todos os outros países, não use extensões de código postal. Espaço em branco Remova os espaços em branco à esquerda e à direita. Hash Não faça hash de postal_code.

Requisitos do PairData

Preencha o campo pair_ids de um objeto PairData com uma lista de IDs. Formate cada elemento da lista seguindo estas etapas:

1. Gere hash dos dados de PII fornecidos pelo cleanroom usando o algoritmo SHA-256.
2. Criptografe os bytes de hash com uma cifra comutativa EC usando a chave do editor para a lista de usuários do PAIR.
3. Codifique os dados criptografados usando a codificação hexadecimal ou Base64.

Requisitos do MobileData

Preencha o campo mobile_ids de um objeto MobileData com uma lista de IDs de dispositivos móveis. Não faça hash de IDs de dispositivos móveis.

Próximas etapas

• Saiba como criptografar dados do usuário.