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

Requisitos de nome e conteúdo para arquivos de sincronização de ID name-and-content-requirements-for-id-synchronization-files

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

Descreve os campos obrigatórios, a sintaxe e as convenções de nomenclatura usadas para a sincronização de ID com base em arquivos. Nomeie e organize o conteúdo do arquivo de acordo com essas especificações.

NOTE
Estilos de texto (monospaced text, itálico, colchetes [ ] ( ) etc.) neste documento indique elementos e opções de código. Consulte Convenções de estilo para código e elementos de texto para obter mais informações.

Sintaxe de nome de arquivo e exemplos file-name-syntax

Os nomes de arquivo de ID contêm os seguintes elementos obrigatórios e opcionais:

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Parâmetro
Descrição
adobe_id
Um prefixo estático que identifica o arquivo como um arquivo de sincronização de ID. Use esse prefixo ao corresponder IDs de dispositivo a outras IDs de dispositivo ou IDs de cliente (DPUUIDs).
c2c_id
Um prefixo estático que identifica o arquivo como um arquivo de sincronização de ID para Destinos com base em pessoas. Use esse prefixo ao corresponder IDs do cliente (DPUUIDs) a endereços de email com hash para Destinos com base em pessoas.
MASTERDPID

A ID do provedor de dados mestre é a ID pai das DPIDs no nome do arquivo. Além disso, a primeira ID de usuário no arquivo de dados corresponde à ID mestre. As DPIDs subsequentes são outros identificadores que pertencem ao principal. A sincronização mapeia DPIDs no nome do arquivo para UUIDs no arquivo.

Essa DPID deve conter somente IDs de dispositivo, como UUID AAM, GAID, IDFA e assim por diante. Ele não pode conter DPUUIDs. Isso pode resultar na sincronização incorreta.

DPID

IDs de provedores de dados. Essas IDs representam entidades ou fontes de dados associadas à DPID principal. A sincronização mapeia DPIDs no nome do arquivo para UUIDs no arquivo.

O número de DPIDs no nome do arquivo deve corresponder ao número de UUIDs no arquivo de dados. Por exemplo, considere que o nome do arquivo contém uma DPID mestre e 3 DPIDs. Seu arquivo de dados deve incluir quatro colunas correspondentes de UUIDs, formatadas conforme descrito na seção de conteúdo do arquivo abaixo.

timestamp
Um carimbo de data e hora UNIX de 10 dígitos em segundos. O carimbo de data e hora ajuda a tornar cada nome de arquivo exclusivo.
.sync
Indica uma sincronização normal e completa.
[.SPLIT_NUMBER]
Um inteiro. Usado quando você divide arquivos grandes em vários arquivos menores. Isso ajuda a melhorar os tempos de processamento. O número indica em qual parte do arquivo original você está enviando. Consulte os exemplos de nome de arquivo abaixo.
[.gz]
Especifica que o arquivo é compactado com compactação gzip opcional.

Exemplos de nome de arquivo

Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Os nomes dos arquivos podem ser semelhantes.

  • adobe_id_111_222_333_444_1454442149.sync
  • adobe_id_123_898_456_1454442149.sync.1.gz
  • adobe_id_123_898_456_1454442149.sync.2.gz
  • c2c_id_123_898_1454442149.sync.gz
NOTE
Para obter a nomenclatura do arquivo de sincronização de ID (prefixo c2c) para Destinos com Base em Pessoas, consulte Fluxo de trabalho A - Personalization com base em todas as atividades online combinadas com dados offline ou Fluxo de trabalho B - Personalization com base em dados somente offline.

Sintaxe de conteúdo de arquivo e exemplos file-content-syntax

O conteúdo de um arquivo de ID inclui os seguintes elementos:

UUID <tab>UUID<tab>UUID<tab>UUID

O arquivo contém IDs de usuário (UUID). Em cada linha, separe as IDs com uma guia. O exemplo a seguir mostra um arquivo de ID formatado corretamente. Seu conteúdo pode ser semelhante.

abc123 def456 ghi789 xyz987

Considerações sobre o conteúdo do arquivo considerations

Ao criar seus arquivos de entrada, verifique se a primeira coluna é preenchida apenas com IDs de dispositivo, como AAM UUID, GAID, IDFA e assim por diante. Consulte Índice de IDs no Audience Manager para obter uma explicação detalhada das IDs suportadas pelo Audience Manager.

IMPORTANT
Não use DPUUIDs na primeira coluna. Isso pode resultar na sincronização incorreta.

A sincronização corresponde DPUUIDs a UUIDs sync-matches-dpuuids-uuids

A finalidade de um arquivo de sincronização de ID é sincronizar os DPUUIDs das suas próprias Fontes de Dados com os Audience Manager UUIDs. A sincronização mapeia o DPUUIDs do DPID principal e seu DPIDs relacionado ao Audience Manager UUIDs. O local em que você coloca as IDs no nome e no corpo do arquivo determina como esses identificadores são mapeados entre si. Por exemplo, use os dois arquivos de amostra mostrados aqui:

  • Arquivo 1: adobe_id_0_12345_1476312152.sync

  • Arquivo 2: adobe_id_12345_67890_1476312876.sync

Dado o nome e o conteúdo da amostra, as IDs são mapeadas em conjunto da seguinte forma:

Arquivo 1 ( Baixar arquivo de amostra)

DPID 0 = UUIDs do Adobe Audience Manager
DPID 12345
68079982765673198504052656074456196039
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Etapa 1: o processo de sincronização de ID sincronizará o DPUUIDs de DPID 12345 com o Audience Manager UUIDs na coluna da esquerda. Observe que DPID "0" no nome do arquivo representa Audience Manager UUIDs.

Arquivo 2 ( Baixar arquivo de amostra)

DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763

Etapa 2: os DPUUIDs de DPID 12345 foram sincronizados na etapa 1 com o Audience Manager UUIDs. O que esta sincronização de ID fará é sincronizar o DPUUIDs do DPID 67890 com o Audience Manager UUIDs da etapa 1.

Outros requisitos de formato other-format-reqs

As IDs de usuário não podem:

  • Ter guias na própria ID. As guias são usadas somente para separar IDs individuais no arquivo de dados.
  • Contém informações pessoais identificáveis (PII).
  • Use a codificação URL. Transmita somente IDs não codificadas.

Quaisquer linhas que terminam com tabulações ou espaços não serão processadas ou realizadas. Como regra, mantenha o final das linhas limpo.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695