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 sincronização de ID com base em arquivo. 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 os elementos de código e as opções. 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 Baseados em Pessoas. Use esse prefixo ao corresponder IDs de cliente (DPUUIDs) a endereços de email com hash para Destinos baseados em pessoas.

MASTERDPID A ID principal do provedor de dados é a ID pai dos 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.

DPID

IDs do provedor de dados. Essas IDs representam entidades ou fontes de dados associadas ao 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, digamos que seu nome de arquivo contenha um DPID principal e 3 DPIDs. Seu arquivo de dados deve incluir 4 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 único.

.sync

Indica uma sincronização normal e completa.

[.SPLIT_NUMBER]

Um número inteiro. Usado ao dividir arquivos grandes em vários arquivos menores. Isso ajuda a melhorar os tempos de processamento. O número indica qual parte do arquivo original você está enviando. Consulte os exemplos de nome de arquivo abaixo.

[.gz]

Especifica que seu arquivo é compactado com compactação gzip opcional.

Exemplos de nome de arquivo

Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Seus nomes de arquivo 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 a nomeação de arquivos de sincronização de ID (prefixo c2c) para Destinos baseados em pessoas, consulte Fluxo de trabalho A - Personalização baseada em toda a Atividade online combinada com dados offline ou Fluxo de trabalho B - Personalização baseada 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 parecer semelhante.

abc123 def456 ghi789 xyz987

A sincronização corresponde DPUUIDs a UUIDs

A finalidade de um arquivo de sincronização de ID é sincronizar as DPUUIDs de suas próprias Fontes de Dados com Audience Manager UUIDs. A sincronização mapeia os DPUUIDs do principal DPID e seus DPIDs relacionados aos Audience Manager UUIDs. Quando você coloca as IDs no nome e no corpo do arquivo, determina como esses identificadores são mapeados entre si. Por exemplo, pegue 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 juntas desta forma:

Arquivo 1 ( Baixar arquivo de amostra)

DPID 0 = Adobe Audience Manager UUIDs DPID 12345
6807998276567319850405265607456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR.38
67412682083411995725538770443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
6618477822667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Etapa 1: o processo de sincronização de ID sincronizará DPUUIDs de DPID 12345 com os 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-Trj6E4njaMR.38 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 DPUUIDs de DPID 67890 com o Audience Manager UUIDs da etapa 1.


Outros requisitos de formato

As IDs de usuário não podem:

  • Tem guias na própria ID. As guias são usadas somente para separar IDs individuais no arquivo de dados.
  • Contém informações de identificação pessoal (PII).
  • Use a codificação URL. Passe somente IDs não codificadas.

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

Nesta página