Descreve os campos obrigatórios, a sintaxe e as convenções de nomenclatura usadas para a 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 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 principal do provedor de dados é 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 à principal. A sincronização mapeia DPIDs no nome do arquivo para UUIDs no arquivo. Essa DPID deve conter somente IDs de dispositivo, como AAM UUID, GAID, IDFA e assim por diante. Ele não pode conter DPUUIDs. Isso pode resultar em sincronização incorreta. |
|
IDs do provedor 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, digamos que o nome do arquivo contenha uma 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 exclusivo. |
|
Indica uma sincronização normal e completa. |
|
Um 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. Os 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 nomear o 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 corretamente formatado. Seu conteúdo pode ser semelhante.
abc123 def456 ghi789 xyz987
Ao criar seus arquivos de entrada, verifique se a primeira coluna é preenchida apenas com IDs de dispositivo, como AAM UUID, GAID, IDFA, e assim por diante. Consulte Índice de IDs no Audience Manager para obter uma explicação detalhada das IDs suportadas pelo Audience Manager.
Não use DPUUIDs na primeira coluna. Isso pode resultar em sincronização incorreta.
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 DPID principal e seus DPIDs 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 uns para os outros. 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 da seguinte forma:
Arquivo 1 ( Baixar arquivo de amostra)
DPID 0 = UUIDs do Adobe Audience Manager | DPID 12345 |
---|---|
6807998276567319850405265607456196039 | XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38 |
674126820834119957255387043620307584 | XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 |
8915902479676034373311707646026765593 | XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYIwd0A2OlM |
66552757407517449462805881945288602094 | XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M |
6618477822667870903738139438735041506 | XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw |
Etapa 1: o processo de sincronização de ID sincronizará os 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-Trj6E4njaMR38 | 4598060374 |
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 | 4581274262 |
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYIwd0A2OlM | 439243426 |
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 essa sincronização de ID fará é sincronizar os DPUUIDs de DPID 67890 com o Audience Manager UUIDs da etapa 1.
As IDs de usuário não podem:
As linhas que terminarem com guias ou espaços não serão processadas ou realizadas. Como regra, mantenha o final das linhas limpo.