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 de 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 letras minúsculas.
  • Se o endereço de e-mail tiver o gmail.com ou googlemail.com domínio:
    • Remova todos os pontos (.) antes do @ símbolo.
    • Remova o sinal de adição (+) da parte local e todos os caracteres que o seguem.
    • 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 Remova os espaços em branco à esquerda, à direita e intermediários.
Hash Use 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 após o 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 Remova os espaços em branco à esquerda e à direita.
Hash Use 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 letras minúsculas.
Não inclua prefixos como Mrs.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Use o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
family_name
Formato
string
Converter em letras minúsculas.
Não inclua sufixos como Jr.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Use 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 duas letras.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Não gere hash de region_code.
postal_code
Formato
string
São permitidos códigos postais internacionais e ZIP codes dos EUA.
Para endereços dos EUA, use 5 dígitos ou 5 dígitos seguidos por uma extensão de 4 dígitos. O uso de uma extensão de 4 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 gere hash de postal_code.
address_line
Formato
string
Usado apenas no Google Analytics.
O nome da rua e o número do endereço do usuário.
Converter em letras minúsculas.
Remova caracteres de símbolo.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Use o algoritmo SHA-256. Codifique os bytes de hash usando a codificação hexadecimal ou Base64.
city
Formato
string
Usado apenas no Google Analytics.
A cidade do endereço do usuário.
Converter em letras minúsculas.
Remova caracteres de símbolo.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Não gere hash de city.
administrative_area
Formato
string
Usado apenas no 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 letras minúsculas.
Remova caracteres de símbolo.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Não gere hash de administrative_area.

Requisitos de IpData

Um IpData objeto tem os seguintes atributos.

IpData
ip_address
Formato
string
Endereço IPv4 ou IPv6.
Para endereços IPv6, a capitalização não importa (maiúsculas ou minúsculas podem ser usadas).
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Não gere hash de ip_address.

Requisitos de 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 o 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 do PAIR.
  3. Codifique os dados criptografados usando a codificação hexadecimal ou Base64.

Requisitos de MobileData

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

Formato do carimbo de data/hora

Se você estiver usando o formato JSON para Timestamp campos, 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 17h18min44s291, 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 naquele momento: 2025-08-08T13:18:44.291-04:00
  • Fuso horário PDT, que era 7 horas antes do UTC naquele momento: 2025-08-08T10:18:44.291-07:00
  • Fuso horário de Tóquio, Japão, que era 9 horas à frente do UTC e não observa 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 os seconds e, opcionalmente, os nanos ao criar o Timestamp. Confira os valores de seconds e nanos para o horário UTC de 8 de agosto de 2025, às 17h18min44s291:

  • seconds: 1754683124
  • nanos: 291000000

Codificação

Considere o seguinte ao codificar dados:

  • A capitalização da saída de codificação não importa ao usar a codificação hexadecimal (hex).
  • A capitalização da saída de codificação importa ao usar a codificação Base64.
Anterior
Configurar destinos e cabeçalhos
Avançar
Criptografe os dados do usuário