Formatar dados do usuário

A API Data Manager permite fazer 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 que eles sejam recebidos e processados corretamente.

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
Converter para minúsculas.
Espaço em branco Corte os espaços em branco à esquerda, à direita e intermediários.
Hash Gere hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
phone_number
Formato
string
Inclua o sinal de adição (+) e o código do país.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Gere hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
address

Formato AddressInfo

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

AddressInfo
given_name
Formato
string
Converter para minúsculas.
Não inclua prefixos como Mrs.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Gere hash usando o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
family_name
Formato
string
Converter para minúsculas.
Não inclua sufixos como Jr.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Gere 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 de dois caracteres ISO-3166-1 alfa-2.
Espaço em branco Corte 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 por uma extensão de quatro dígitos. Usar 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 Corte 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 pela clean room 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 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.

Formato do carimbo de data/hora

Se você estiver usando o formato JSON para campos Timestamp, como timestamp e last_updated_timestamp de Event, use o formato RFC 3339.

Se você estiver usando o formato de buffer de protocolo, defina seconds e, opcionalmente, nanos ao construir o Timestamp.

Próximas etapas