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 seus dados 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.
Se o endereço de e-mail tiver o domínio gmail.com ou googlemail.com, remova todos os pontos (.) antes do símbolo @.
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
Use o formato E.164.
Inclua o sinal de adição (+) e o código do país. Todos os caracteres depois do sinal de adição precisam ser dígitos.
Por exemplo, o número de telefone dos EUA (800)555-0100 precisa ser formatado e normalizado para +18005550100.
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. Confira alguns exemplos do horário UTC de 8 de agosto de 2025, às 17:18:44.291, no formato RFC 3339 e em diferentes fusos horários:

  • Fuso horário UTC: 2025-08-08T17:18:44.291Z
  • Fuso horário EDT, que era 4 horas antes do UTC na época: 2025-08-08T13:18:44.291-04:00
  • Fuso horário PDT, que era 7 horas antes do UTC na época: 2025-08-08T10:18:44.291-07:00
  • Fuso horário de Tóquio, Japão, que estava 9 horas à frente do UTC e não observava o horário de verão: 2025-08-08T22:18:44.291+09:00

Se você estiver usando o formato de buffer de protocolo, defina seconds e, opcionalmente, nanos ao construir Timestamp. Confira os valores de seconds e nanos para o horário UTC de 8 de agosto de 2025 às 17h18m44s291:

  • seconds: 1754683124
  • nanos: 291000000

Codificação

Considere o seguinte ao codificar dados:

Próximas etapas