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.
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
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 |
|
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
|
| 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. |
|
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. |
|
Preencha o campo pair_ids de um objeto PairData com uma lista de IDs.
Formate cada elemento da lista seguindo estas etapas:
- Gere o hash dos dados de PII fornecidos pela clean room usando o algoritmo SHA-256.
- Criptografe os bytes de hash com uma cifra comutativa EC usando a chave do editor para a lista de usuários do PAIR.
- Codifique os dados criptografados usando a codificação hexadecimal ou Base64.
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.
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: 1754683124nanos: 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.
