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.

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

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 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 @.
Espaço em branco Remover espaços em branco à esquerda, à direita e intermediários.
Hash Gerar hash usando o algoritmo SHA-256. Codificar os bytes de hash usando a codificação hexadecimal ou Base64.
phone_number
Formato
string
Usar o formato E.164.
Incluir 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 Remover espaços em branco à esquerda e à direita.
Hash Gerar hash usando o algoritmo SHA-256. Codificar 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 Remover espaços em branco à esquerda e à direita.
Hash Gerar hash usando o algoritmo SHA-256. Codificar 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 Remover espaços em branco à esquerda e à direita.
Hash Gerar hash usando o algoritmo SHA-256. Codificar 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 Remover 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. Usar 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 Remover espaços em branco à esquerda e à direita.
Hash Não gere hash de postal_code.

Requisitos de PairData

Preencha o campo pair_ids de um objeto PairData com uma lista de IDs. Formate cada elemento na 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:

Anterior
Configurar destinos e cabeçalhos
Avançar
Criptografe os dados do usuário