Conteúdo do arquivo de dados de entrada: Sintaxe, caracteres inválidos, variáveis e exemplos inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Campos, sintaxe e regras obrigatórios que devem ser seguidos ao formatar um arquivo de dados de características de entrada.
Sintaxe de conteúdo do arquivo file-content-syntax
Os campos no arquivo de dados de entrada devem aparecer na ordem mostrada abaixo. Neste exemplo, a variável <
>
símbolos foram adicionados para ajudar a separar visualmente cada elemento. Não é necessário incluí-los no arquivo de dados.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Para outros formatos de conteúdo de arquivo aceitos, consulte Integrações personalizadas de parceiros.
code language-none |
---|
|
Variáveis de arquivo definidas file-variables-defined
A tabela lista e define as variáveis usadas em um arquivo de dados de entrada formatado corretamente. Itálico indica um marcador de posição variável.
User ID
Uma ID de usuário pode ser:
- Uma ID de usuário exclusiva atribuída pelo Audience Manager ( UUID do Audience Manager).
- Uma ID de usuário exclusiva atribuída em seu sistema CRM ( DPUUID, no Audience Manager).
- Uma ID de dispositivo móvel Android ou iOS em sua forma original, não modificada, conforme exposta pelo sistema operacional móvel.
Para IDs móveis:
- Formato IDFA: as IDs devem estar em maiúsculas e não com hash. Por exemplo,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: as IDs devem estar em minúsculas e sem hash. Por exemplo,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
A variável Audience Manager ID da característica. Pedimos que você inclua somente características integradas em arquivos de dados de entrada. Não processamos nenhum outro tipo de característica na transferência de dados de entrada.
Observação: a ID de característica pode ser encontrada usando o método GET que retorna detalhes sobre todas as suas características. Para obter mais informações, consulte Métodos da API de características.
Formatação Trait IDs formatting-trait-ids
A tabela a seguir descreve os prefixos que identificam trait nomes ou IDs em um arquivo de dados de entrada. Consulte a arquivos de exemplo para obter exemplos.
d_sid=
d_sid
informa ao sistema que a ID é um Audience Manager ID da característica. Essa é a mesma ID mostrada na interface do usuário. Também é possível retornar IDs de características com a API GET
método. Consulte Métodos da API de características.d_unsid=
Dados com prefixo d_unsid
O remove usuários dessa característica. A variável d_unsid
O prefixo é ignorado em um overwrite
arquivo.
A variável d_unsid=
informa ao sistema que a ID é um Audience Manager ID da característica. Essa é a mesma ID mostrada na interface do usuário. Também é possível retornar IDs de características com a API GET
método. Consulte Métodos da API de características.
ic=
Regras de característicapermitem definir critérios para a qualificação de características. Se você formatar uma regra de característica como ic == trait ID
, você pode enviar características em uma lista simples formatada com vírgulas.
Por exemplo, considere criar essas três regras de características:
ic == "123"
ic == "456"
ic == "789"
Essas características estão associadas à variável ic
chave. Isso permite criar uma lista de características mais simples no arquivo de dados. E não é necessário incluir a variável ic
prefixo. Como resultado, o conteúdo do arquivo de dados pode ter esta aparência:
user ID <TAB> 123,456,789
Os dados de característica podem ser formatados como pares de valores chave usando sequências alfanuméricas. Há várias maneiras de formatar pares de valores chave, conforme mostrado abaixo:
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
, "gender"=m
, model = "pickup truck"
, product = tablet
são exemplos de pares de valores chave formatados corretamente.
Caracteres inválidos em Trait IDs, User IDs e pares de valor-chave invalid-chars
Trait IDs
Trait IDs consiste apenas em caracteres numéricos. Pedimos que você inclua somenteonboarded traits em arquivos de dados de entrada. Não processamos nenhum outro trait tipos na transferência de dados de entrada.
User IDs
%3A
) ou o símbolo de dois pontos ( : ) não codificado em DPUUIDs.As IDs de dispositivos móveis devem ser estritamente formatadas, conforme mostrado aqui:
- Formato IDFA: as IDs devem estar em maiúsculas e não com hash. Por exemplo,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: as IDs devem estar em minúsculas e sem hash. Por exemplo,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Pares de valor-chave
Nomes de valores formatados incorretamente em um par de valores chave também causam problemas. Siga estas regras ao criar ou nomear o valor em um par de valor-chave:
Você pode usar o caractere de aspas na chave e na parte do valor do par de valor-chave, da seguinte maneira:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
é interpretado como product = camera
.TAB
TAB
em vez de valores vazios em pares de valores chave. Somente uso TAB
para separar variáveis no arquivo de dados de entrada.\n, \t
\n, \t
) em chaves ou em valores.Exemplos de arquivos de dados data-file-examples
d_sid
ou d_unsid
Esse arquivo de dados mostra um usuário qualificado para as características 24, 26, 27 e foi removido da característica 28 e 29.
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Observação:
Em vez de usar d_unsid, também é possível remover características dos perfis do usuário usando a seguinte sintaxe:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Essas características foram adicionadas a uma regra de característica com o ic
prefixo. Dessa forma, você pode adicioná-los ao arquivo de dados separados por vírgulas, conforme mostrado. Uma guia separa o UUID e as IDs de característica. A variável ic
O prefixo não é necessário no arquivo.
IDs numéricas
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
IDs de string
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Esses dados de arquivo usam pares de valores chave para enviar dados para o Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
Baixar o arquivo de dados de amostra se precisar de exemplos adicionais. O arquivo de download tem um .overwrite
extensão de arquivo. Você pode abri-lo com um editor de texto simples.
Matriz de exemplos examples-matrix
O gráfico abaixo mostra exemplos da maneira correta de formatar seus arquivos de Entrada, dependendo da tipo de IDs e o método pelo qual você deseja adicionar traits para perfis.
Exemplo 1 example-1
Uso trait IDs para enviar trait informações de qualificação para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Exemplo 2 example-2
Uso trait IDs para enviar trait informações de desqualificação para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
ou
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
ou
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
Exemplo 3 example-3
Enviar em pares de valor-chave para adicionar trait informações de qualificação para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
ou
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Exemplo 4 example-4
Use o ic
prefixo a enviar trait informações de qualificação para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
ou
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Exemplo 5 example-5
Uso trait IDs para enviar trait informações de qualificação para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Exemplo 6 example-6
Uso trait IDs para enviar trait informações de desqualificação para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
Exemplo 7 example-7
Enviar em pares de valor-chave para adicionar trait informações de qualificação para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Exemplo 8 example-8
Use o ic
prefixo a enviar trait informações de qualificação para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Exemplo 9 example-9
Uso trait IDs para enviar trait informações de qualificação para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Exemplo 10 example-10
Uso trait IDs para enviar trait informações de desqualificação para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
Exemplo 11 example-11
Enviar em pares de valor-chave para adicionar trait informações de qualificação para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Exemplo 12 example-12
Use o ic
prefixo a enviar trait informações de qualificação para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Exemplo 13 example-13
Uso trait IDs para enviar trait informações de qualificação para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Exemplo 14 example-14
Uso trait IDs para enviar trait informações de desqualificação para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
Exemplo 15 example-15
Enviar em pares de valor-chave para adicionar trait informações de qualificação para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Exemplo 16 example-16
Use o ic
prefixo a enviar trait informações de qualificação para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55