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.
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.
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 |
---|---|
|
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). |
|
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. |
|
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. |
|
Indica uma sincronização normal e completa. |
|
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. |
|
Especifica que seu arquivo é compactado com compactação gzip opcional. |
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 baseada em toda a Atividade online combinada com dados offline ou Fluxo de trabalho B - Personalização baseada em dados somente offline.
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 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.
As IDs de usuário não podem:
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.