TÓPICOS×
Conteúdo do arquivo de dados de entrada: Sintaxe, caracteres inválidos, variáveis e exemplos
Campos obrigatórios, sintaxe e regras que você deve seguir ao formatar um arquivo de dados de característica de entrada.
Sintaxe de conteúdo de arquivo
Os campos no arquivo de dados de entrada devem aparecer na ordem mostrada abaixo. Neste exemplo, os
<
>
símbolos foram adicionados para ajudar a separar cada elemento visualmente. Não é necessário incluí-los no arquivo de dados.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Para obter outros formatos de conteúdo de arquivo aceitos, consulte Integrações
Integrações personalizadas de parceiros
personalizadas de parceiros.
Temos um limite de 200 linhas que podem ser processadas para cada ID de usuário enviada no arquivo de dados de entrada. Por exemplo, se você enviar 300 linhas para uma ID de usuário, as primeiras 200 linhas serão mantidas e as 100 linhas adicionais serão descartadas. No exemplo abaixo, você está bem porque está enviando 3 linhas cada para a ID de usuário 1 e a ID de usuário 2. Não impomos um limite no número de características ou pares de valores chave que você inclui em uma linha.
<user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID>
Variáveis de arquivo definidas
A tabela lista e define as variáveis usadas em um arquivo de dados de entrada corretamente formatado.
Itálico
indica um marcador de posição variável.
Variável | Descrição |
---|---|
User ID
| Uma ID de usuário pode ser:
Para IDs móveis:
|
TAB
| Separe a ID de usuário e as IDs de característica com um único delimitador de guia.
|
trait ID
| A ID de característica do
Audience Manager
. Solicitamos 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
de API de características
.
|
Formatação de IDs de características
A tabela a seguir descreve os prefixos que identificam nomes de características ou IDs em um arquivo de dados de entrada. Consulte os arquivos
de
amostra para obter exemplos.
Prefixo | Descrição |
---|---|
d_sid=
| O
d_sid
prefixo informa ao sistema que a ID é uma ID de
característica do Audience Manager. Essa é a mesma ID mostrada na interface do usuário. Você também pode retornar IDs de características com o
GET
método da API. Consulte Métodos
da API de características
.
|
d_unsid=
| O prefixo de dados com
d_unsid
remove os usuários dessa característica. O
d_unsid
prefixo é ignorado em um
overwrite
arquivo.
O
d_unsid=
prefixo informa ao sistema que a ID é uma ID de
característica do Audience Manager. Essa é a mesma ID mostrada na interface do usuário. Você também pode retornar IDs de características com o
GET
método da API. Consulte Métodos
da API de características
.
|
ic=
| As regras de características
permitem definir critérios para a qualificação de características. Se formatar uma regra de característica como
ic == trait ID
, você poderá enviar características em uma lista formatada por vírgula simples.
Por exemplo, digamos que você crie estas três regras de características:
Essas características estão associadas à
ic
chave. Isso permite criar uma lista de características mais simples no arquivo de dados. E não é necessário incluir o
ic
prefixo. Como resultado, o conteúdo do arquivo de dados pode ser semelhante a:
user ID
<TAB> 123,456,789
|
Pares de valor-chave
| Os dados de características podem ser formatados como pares de valores chave usando strings alfanuméricas. Há várias maneiras de formatar pares de valores chave, como mostrado abaixo:
|
Caracteres inválidos em IDs de características, IDs de usuário e pares de valores-chave
IDs de características
As IDs de características consistem apenas em caracteres numéricos. Solicitamos 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.
IDs de usuário
Tipo de ID | Requisito |
---|---|
DPUUID
| Não
utilize dois pontos codificados (
%3A
) ou dois pontos não codificados ( : ) em DPUUIDs.
|
ID do dispositivo móvel iOS (IDFA) ou Android
| As IDs de dispositivo móvel devem ser formatadas rigorosamente conforme mostrado aqui:
|
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 valores chave:
Caractere | Requisito |
---|---|
Caractere de citação (")
| Você pode usar o caractere de aspas na chave e na parte de valor do par de valor chave, como segue:
|
Caractere traço (-)
| Ignoramos sinais de travessão no início das chaves. Por exemplo,
-product = camera
é interpretado como
product = camera
.
|
TAB
| Não
use valores vazios
TAB
em pares de valores chave. Use apenas
TAB
para separar variáveis no arquivo de dados de entrada.
|
\n, \t
| Não use os novos caracteres de linha ou tabulação (
\n, \t
) em teclas ou valores.
|
Exemplos de arquivos de dados
Formato de arquivo de dados | Descrição e exemplo |
---|---|
Com
d_sid
ou
d_unsid
| Este 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 de usuário usando a seguinte sintaxe:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
|
Com
ic==
| Essas características foram adicionadas a uma regra de característica com o
ic
prefixo. Dessa forma, é possível adicioná-los ao arquivo de dados separado por vírgulas, conforme mostrado. Uma guia separa o UUID e as IDs de características. O
ic
prefixo não é necessário no arquivo.
IDs numéricas
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
IDs de string
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
|
Com pares de valor chave
| Esses dados de arquivo usam pares de valores chave para passar os dados para o
Audience Manager
.
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
|
Baixe
o arquivo de dados de amostra se precisar de exemplos adicionais. O arquivo de download tem uma extensão
.overwrite
de arquivo. É possível abri-lo com um editor de texto simples.
Matriz de exemplos
O gráfico abaixo mostra exemplos da maneira correta de formatar seus arquivos de entrada, dependendo do
tipo de IDs
e do método pelo qual você deseja adicionar características aos perfis.
Tipo/operação de ID | Usar d_sid para adicionar características a um perfil de usuário | Usar d_unsid para remover características de um perfil de usuário | Enviar pares de valores chave para adicionar características a um perfil de usuário | Use o prefixo ic para adicionar características a um perfil de usuário |
---|---|---|---|---|
UUID do Audience Manager
| ||||
ID de publicidade do Google para dispositivos Android
| ||||
Apple IDFA para dispositivos iOS
| ||||
Sua própria ID do CRM (DPUUID)
|
Exemplo 1
Use IDs de características para enviar informações de qualificação de características para UUIDs do Audience Manager.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Exemplo 2
Use IDs de características para enviar informações de desqualificação de características para UUIDs do Audience Manager.
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
Example 3
Envie pares de valor chave para adicionar informações de qualificação de característica para UUIDs do Audience Manager.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
ou
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Example 4
Use o prefixo ic para enviar informações de qualificação de característica para UUIDs do Audience Manager.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
ou
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Example 5
Use IDs de características para enviar informações de qualificação de características para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Example 6
Use as IDs de características para enviar informações de desqualificação de características para dispositivos Android.
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
Example 7
Envie pares de valor chave para adicionar informações de qualificação de característica para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Example 8
Use o prefixo ic para enviar informações de qualificação de característica para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Example 9
Use IDs de características para enviar informações de qualificação de características para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Example 10
Use as IDs de características para enviar informações de desqualificação de características para dispositivos iOS.
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
Example 11
Envie pares de valor chave para adicionar informações de qualificação de característica para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Example 12
Use o prefixo ic para enviar informações de qualificação de características para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Example 13
Use IDs de características para enviar informações de qualificação de características para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Example 14
Use IDs características para enviar informações de desqualificação de características 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
Example 15
Envie pares de valor chave para adicionar informações de qualificação de característica para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Example 16
Use o prefixo ic para enviar informações de qualificação de característica para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55