TÓPICOS×

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 baseada em arquivo. Nomeie e organize o conteúdo do arquivo de acordo com essas especificações.

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.

Processo de transferência de dados em lote

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 do provedor de dados mestre é a ID pai dos DPIDs no nome do arquivo. Além disso, a primeira ID de usuário no arquivo de dados corresponde à ID mestre. Os DPIDs subsequentes são outros identificadores que pertencem ao mestre. 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 mestre. 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 mestre 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

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 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 parecer semelhante.

abc123 def456 ghi789 xyz987

A sincronização corresponde DPUUIDs a UUIDs

A finalidade de um arquivo de sincronização de ID é sincronizar os DPUUIDs de suas próprias Fontes de Dados com Audience Manager UUIDs. A sincronização mapeia os DPUUIDs do mestre DPID e DPIDdos relacionados para os 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, 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 = UUIDs do Adobe Audience Manager	DPID 12345
68079982765673198504052656074456196039	XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR.38
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á os DPUUIDs de DPID 12345 com os Audience Manager s na coluna UUIDesquerda. Observe que o 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 do DPID 12345 foram sincronizados na etapa 1 com os Audience Manager UUIDs. O que essa sincronização de ID fará é sincronizar os DPUUIDs de DPID 67890 com os 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 URL codificação. 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.