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.

Processo de transferência de dados em lote

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: Uma ID de usuário exclusiva atribuída pelo Audience Manager ( Audience Manager UUUID ). Uma ID de usuário exclusiva atribuída no sistema CRM ( DPUUID, no Audience Manager ). Uma ID de dispositivo Android ou iOS móvel em sua forma original e não modificada, como exposta pelo sistema operacional móvel. Para IDs móveis: Formato IDFA: As IDs devem estar em maiúsculas e não em hash. Por exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC Formato Android: As IDs devem estar em minúsculas e não devem ter hash. Por exemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
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 .

Variável

Descrição

User ID

Uma ID de usuário pode ser:

Uma ID de usuário exclusiva atribuída pelo Audience Manager ( Audience Manager UUUID ).
Uma ID de usuário exclusiva atribuída no sistema CRM ( DPUUID, no Audience Manager ).
Uma ID de dispositivo Android ou iOS móvel em sua forma original e não modificada, como exposta pelo sistema operacional móvel.

Para IDs móveis:

Formato IDFA: As IDs devem estar em maiúsculas e não em hash. Por exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
Formato Android: As IDs devem estar em minúsculas e não devem ter hash. Por exemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

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: ic == "123" ic == "456" ic == "789" 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: 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 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: Formato IDFA: As IDs devem estar em maiúsculas e não em hash. Por exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC Formato Android: As IDs devem estar em minúsculas e não devem ter 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 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: d_city = "New York", d_city = "San Francisco" "d_city" = "New York", "d_city" = "San Francisco"
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	Exemplo 1	Exemplo 2	Exemplo 3	Exemplo 4
ID de publicidade do Google para dispositivos Android	Exemplo 5	Exemplo 6	Exemplo 7	Exemplo 8
Apple IDFA para dispositivos iOS	Exemplo 9	Exemplo 10	Exemplo 11	Exemplo 12
Sua própria ID do CRM (DPUUID)	Exemplo 13	Exemplo 14	Exemplo 15	Exemplo 16

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

59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0

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

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

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

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0

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

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

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

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0

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

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

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0

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

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

Construtor de perfil

Título da Guia