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.
  • IpData: dados de IP, como um endereço IP e carimbos de data/hora associados.
  • PairData: IDs de reconciliação de identidade de anunciante do editor (PAIR).
  • 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.
    • 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 Gere o 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 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 Gere o 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 Remova os espaços em branco à esquerda e à direita.
Hash Gere o 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 Remova os espaços em branco à esquerda e à direita.
Hash Gere o 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 ISO-3166-1 alfa-2 de dois caracteres.
Espaço em branco Remova os espaços em branco à esquerda e à direita.
Hash Não gere hash para 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 para postal_code.

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 para ip_address.

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 para 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