DocumentaçãoAudience ManagerGuia do usuário do Audience Manager

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

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

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, 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.

NOTE
Temos um limite de 200 linhas que podemos processar 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á bom porque está enviando três 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.
code language-none 
<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 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.

Variável
Descrição
User ID

Uma ID de usuário pode ser:

  • Uma ID de usuário exclusiva atribuída por Audience Manager ( Audience Manager UUID).
  • Uma ID de usuário exclusiva atribuída em seu sistema CRM ( DPUUID, no Audience Manager).
  • Uma ID de dispositivo Android ou iOS móvel 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 do Android: as IDs devem estar em minúsculas e não com 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 tabulação.
trait ID

A ID de característica do 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 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.

Formatando 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 os arquivos de exemplo para obter exemplos.

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

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

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

ic=

As regras de característicaspermitem que você defina 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 simples formatada com vírgula.

Por exemplo, considere criar essas 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 ter esta aparência:

                 user ID <TAB> 123,456,789

Pares de valor-chave

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 somente 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 use dois pontos codificados ( %3A ) ou o símbolo de dois pontos não codificado ( : ) em DPUUIDs.
Mobile iOS (IDFA) ou ID de dispositivo Android

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 do Android: as IDs devem estar em minúsculas e não com 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:

Caractere
Requisito
Caractere de aspas (")

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"

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 TAB em vez de valores vazios em pares de valores chave. Use TAB somente 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 ) em chaves ou valores.

Exemplos de arquivos de dados data-file-examples

Formato de 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 da característica 28 e 29.

59767559181262060060278870901087098252  d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

Nota:

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

Com ic==

Essas características foram adicionadas a uma regra de característica com o prefixo ic . 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. O prefixo ic não é necessário no arquivo.

IDs numéricas

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

IDs de Cadeia de Caracteres

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

Com pares de valor-chave

Estes dados de arquivo usam pares de valores chave para enviar dados para o Audience Manager .

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

Baixe o arquivo de dados de exemplo se precisar de exemplos adicionais. O arquivo baixado tem uma extensão de arquivo .overwrite. 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 do tipo de IDs e do método pelo qual você deseja adicionar traits aos perfis.

Tipo de ID / Operação
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 chave-valor para adicionar características a um perfil do usuário
Usar o prefixo ic para adicionar características a um perfil do usuário
UUID do Audience Manager
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 example-1

Use trait IDs para enviar informações de qualificação de trait para Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Exemplo 2 example-2

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

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"

Exemplo 4 example-4

Use o prefixo ic para enviar informações de qualificação de trait para Audience Manager UUIDs.

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

ou

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Exemplo 5 example-5

Use trait IDs para enviar informações de qualificação de trait para Android dispositivos.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Exemplo 6 example-6

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

Envie pares de valores chave para adicionar informações de qualificação de trait 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 prefixo ic para enviar informações de qualificação de 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

Exemplo 9 example-9

Use trait IDs para enviar informações de qualificação de trait para iOS dispositivos.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Exemplo 10 example-10

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

Envie pares de valores chave para adicionar informações de qualificação de trait 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 prefixo ic para enviar informações de qualificação de 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

Exemplo 13 example-13

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Exemplo 14 example-14

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

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"

Exemplo 16 example-16

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

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

ou

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695