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