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 em 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 @.
    • Remova o sinal de adição (+) da parte local e todos os caracteres que vêm depois dele.
    • Exemplo: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • Se o endereço de e-mail tiver um domínio diferente de gmail.com ou googlemail.com, não remova pontos ou sinais de adição.
    • Exemplo: user.name+NYC@Example.com → user.name+nyc@example.com
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 em 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 em 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 códigos postais internacionais e ZIP codes 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.
address_line
Formato
string
Usado apenas para o Google Analytics.
Nome da rua e número do endereço do usuário.
Converter em minúsculas.
Remova caracteres de símbolo.
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.
city
Formato
string
Usado apenas para o Google Analytics.
A cidade do endereço do usuário.
Converter em minúsculas.
Remova caracteres de símbolo.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Não faça hash de city.
administrative_area
Formato
string
Usado apenas para o Google Analytics.
A área político-administrativa (estado ou província) do endereço do usuário.
Use a abreviação de duas letras (por exemplo, ca) ou o nome completo (por exemplo, california).
Converter em minúsculas.
Remova caracteres de símbolo.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Não faça hash de administrative_area.

Requisitos do IpData

Um objeto IpData tem os seguintes atributos.

IpData
ip_address
Formato
string
Endereço IPv4 ou IPv6.
Para endereços IPv6, não faz diferença se as letras são maiúsculas ou minúsculas.
Espaço em branco Corte os espaços em branco à esquerda e à direita.
Hash Não faça hash de ip_address.

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 o 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:

  • O uso de letras maiúsculas ou minúsculas na saída da codificação não importa ao usar a codificação hexadecimal (hex).
  • O uso de letras maiúsculas e minúsculas na saída da codificação é importante ao usar a codificação Base64.
Anterior
Configurar destinos e cabeçalhos
Avançar
Criptografe os dados do usuário