Campos obrigatórios, sintaxe e regras que você deve seguir ao formatar um arquivo de dados de característica de entrada.
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 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.
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 incluídos 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>
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 |
---|---|
|
Uma ID de usuário pode ser:
Para IDs móveis:
|
|
Separe a ID de usuário e as IDs de característica com um único delimitador de guia. |
|
A ID de característica 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 de GET que retorna detalhes sobre todas as suas características. Para obter mais informações, consulte Métodos da API de características . |
A tabela a seguir descreve os prefixos que identificam trait nomes ou IDs em um arquivo de dados de entrada. Consulte arquivos de amostra para obter exemplos.
Prefixo | Descrição |
---|---|
|
O prefixo |
|
O prefixo de dados com O prefixo |
|
As regras de características permitem definir critérios para a qualificação de características. Se formatar uma regra de característica como Por exemplo, digamos que você crie estas três regras de características:
Essas características estão associadas à chave
|
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:
"age"="32" , "gender"=m , model = "pickup truck" product = tablet são todos exemplos de pares de valores chave formatados corretamente. |
Trait IDs consistem apenas em caracteres numéricos. Solicitamos que você inclua somenteonboarded traits nos arquivos de dados de entrada. Não processamos nenhum outro tipo trait na transferência de dados de entrada.
Tipo de ID | Requisito |
---|---|
DPUUID |
Não codifique dois pontos ( |
ID do dispositivo móvel iOS (IDFA) ou Android |
As IDs de dispositivo móvel devem ser formatadas rigorosamente conforme mostrado aqui:
|
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 start das chaves. Por exemplo, |
|
Não use valores vazios |
|
Não use os novos caracteres de linha ou tabulação ( |
Formato de arquivo de dados | Descrição e exemplo |
---|---|
Com |
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.
Observação: Em vez de usar d_unsid, também é possível remover características de perfis do usuário usando a seguinte sintaxe:
|
Com |
Essas características foram adicionadas a uma regra de característica com o prefixo IDs numéricas
IDs de string
|
Com pares de valor chave |
Esses dados de arquivo usam pares de valor chave para passar os dados para Audience Manager .
|
[] (assets/ftp_dpm_1234_1445374061.overwrite) Baixe o arquivo de dados de amostra se precisar de outros exemplos. O arquivo de download tem uma extensão de arquivo .overwrite
. É possível abri-lo com um editor de texto simples.
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 traits aos perfis.
Tipo/operação de ID | Use d_sid para adicionar características a um perfil do 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 do usuário |
---|---|---|---|---|
Audience Manager UUID |
||||
ID de publicidade do Google para dispositivos Android |
||||
Apple IDFA para dispositivos iOS |
||||
Sua própria ID do CRM (DPUUID) |
Use 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
Use 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
Envie 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"
Use o prefixo ic
para enviar informações de qualificação trait para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
ou
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Use trait IDs para enviar trait informações de qualificação para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Use trait IDs para enviar trait informações de desqualificação 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
Envie pares de valor chave para adicionar trait informações de qualificação para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
ou
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Use o prefixo ic
para enviar informações de qualificação trait 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
Use trait IDs para enviar trait informações de qualificação para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Use trait IDs para enviar trait informações de desqualificação 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
Envie pares de valor chave para adicionar trait informações de qualificação para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
ou
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Use o prefixo ic
para enviar informações de qualificação trait 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
Use trait IDs para enviar trait informações de qualificação para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Use 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
Envie 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"
Use o prefixo ic
para enviar informações de qualificação trait para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
ou
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55