Conteúdo do arquivo de dados de entrada: Sintaxe, caracteres inválidos, variáveis e exemplos

Campos obrigatórios, sintaxe e regras que devem ser seguidos ao formatar um arquivo de dados de características de entrada.

Sintaxe de conteúdo do 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 outros formatos de conteúdo de arquivo aceitos, consulte Integrações personalizadas de parceiros.

OBSERVAÇÃO

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>

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 por Audience Manager ( UUID do Audience Manager ).
  • Uma ID de usuário exclusiva atribuída em seu sistema CRM ( DPUUID, em Audience Manager ).
  • Uma ID de dispositivo Android ou iOS móvel em sua forma original e não modificada, conforme exposto pelo sistema operacional móvel.

Para IDs móveis:

  • Formato IDFA: As IDs devem estar em maiúsculas e não ter hash. Por exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: As IDs devem estar em letras minúsculas e não em 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 Audience Manager . 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 da 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

A tabela a seguir descreve os prefixos que identificam trait nomes ou IDs em um arquivo de dados de entrada. Consulte os arquivos de exemplo para obter exemplos.

Prefixo Descrição

d_sid=

O prefixo d_sid informa ao sistema que a ID é uma ID de característica Audience Manager . Essa é a mesma ID mostrada na interface do usuário do . Você também pode retornar IDs de características com o método API GET . Consulte Métodos da API de características .

d_unsid=

Os dados com o prefixo d_unsid removem os usuários dessa característica. O prefixo d_unsid é ignorado em um arquivo overwrite .

O prefixo d_unsid= informa ao sistema que a ID é uma ID de característica Audience Manager . Essa é a mesma ID mostrada na interface do usuário do . Você também pode retornar IDs de características com o método API GET . 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 você formatar uma regra de característica como ic == trait ID , 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 à chave ic . Isso permite criar uma lista de características mais simples no arquivo de dados. E não é necessário incluir o prefixo ic . 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, 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

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 tipo trait na transferência de dados de entrada.

User IDs

Tipo de ID Requisito

DPUUID

Não codifique dois pontos ( %3A ) ou dois pontos não codificados ( : ) em DPUUIDs.

ID de dispositivo móvel iOS (IDFA) ou Android

As IDs de dispositivo móvel devem ser formatadas rigorosamente como mostrado aqui:

  • Formato IDFA: As IDs devem estar em maiúsculas e não ter hash. Por exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: As IDs devem estar em letras minúsculas e não em 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 valores chave, da seguinte maneira:

  • d_city = "New York", d_city = "San Francisco"

  • "d_city" = "New York", "d_city" = "San Francisco"

Caractere traço (-)

Ignoramos sinais de traço no início das chaves. Por exemplo, -product = camera é interpretado como product = camera .

TAB

Não use valores em TAB vez de valores vazios em pares de valores chave. Use somente TAB para separar variáveis no arquivo de dados de entrada.

\n, \t

Não use os caracteres de nova linha ou tabulação ( \n, \t ) nas chaves ou em valores.

Exemplos de arquivo de dados

Formato do arquivo de dados Descrição e exemplo

Com d_sid ou d_unsid

Esse arquivo de dados mostra um usuário qualificado para as características 24, 26, 27 e foi removido das características 28 e 29.

59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

Observação:

Em vez de usar d_unsid, você também pode remover características dos perfis de usuário usando a seguinte sintaxe:

59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0

59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1

Com ic==

Essas características foram adicionadas a uma regra de característica com o prefixo ic . Dessa forma, é possível adicioná-los ao arquivo de dados separado por vírgulas, como mostrado. Uma guia separa a UUID e as IDs de características. O prefixo ic não é necessário no arquivo.

IDs numéricas

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626

IDs de string

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55

Com pares de valor chave

Esses dados de arquivo usam pares de valor chave para transmitir dados para Audience Manager .

59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”

[] (assets/ftp_dpm_1234_1445374061.overwrite) Baixe o arquivo de dados de amostra se precisar de mais exemplos. O arquivo de download tem uma extensão de arquivo .overwrite. Você pode abri-lo com um editor de texto simples.

Exemplos de matriz

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 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 valor 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

Audience Manager UUID

Exemplo 1

Exemplo 2

Exemplo 3

Exemplo 4

Google Advertising ID 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 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

Use trait IDs para enviar trait informações de desativaçã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

Envie pares de valores 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

Use o prefixo ic para 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 4

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

Exemplo 6

Use trait IDs para enviar trait informações de desativaçã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

Exemplo 7

Envie pares de valores 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"

Exemplo 8

Use o prefixo ic para enviar trait informações de qualificação 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

Exemplo 9

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

Exemplo 10

Use trait IDs para enviar trait informações de desativaçã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

Exemplo 11

Envie pares de valores 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"

Exemplo 12

Use o prefixo ic para enviar trait informações de qualificação 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

Exemplo 13

Use 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

Use trait IDs para enviar trait informações de desativaçã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

Envie pares de valores 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

Use o prefixo ic para enviar trait informações de qualificação para DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

ou

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

Nesta página