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.
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.
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 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. |
|
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. |
|
Indica uma sincronização normal e completa. |
|
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. |
|
Especifica que o arquivo é compactado com compactação gzip opcional. |
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
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.
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
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.
Não usar DPUUIDs na primeira coluna. Isso pode resultar na sincronização incorreta.
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.
As IDs de usuário não podem:
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.