Requisitos de nome e conteúdo para arquivos de sincronização de ID

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.

OBSERVAÇÃO

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

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 principais é a ID principal das DPIDs no nome do arquivo. Além disso, a primeira ID de usuário no arquivo de dados corresponde à ID principal. Os 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 principal 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
OBSERVAÇÃO

Para obter a nomenclatura do arquivo de sincronização de ID (prefixo c2c) para Destinos com base em pessoas, consulte Fluxo de trabalho A - Personalização com base em toda a Atividade online combinada com dados offline ou Fluxo de trabalho B - Personalização com base em dados somente offline.

Sintaxe de conteúdo de arquivo e exemplos

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

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

IMPORTANTE

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

A sincronização corresponde DPUUIDs a UUIDs

A finalidade de um arquivo de sincronização de ID é sincronizar o DPUUIDs de suas próprias Fontes de dados com Audience Manager UUIDs A sincronização mapeia a DPUUIDs do principal DPID e seus relacionados DPIDs para o Audience Manager UUIDs. Onde 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 à 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: a DPUUIDs de DPID 12345 foram sincronizados na etapa 1 com o Audience Manager UUIDs. O que essa sincronização de ID fará é sincronizar o DPUUIDs de DPID 67890 com o Audience Manager UUIDs da etapa 1.


Outros requisitos de formato

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.
  • Conter informações de identificação pessoal (PII).
  • Uso URL codificação. 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.

Nesta página