Descreve os campos obrigatórios, a sintaxe e as convenções usadas para nomear um arquivo de dados externo.
Os elementos de estilo (monospaced text
, italics, 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.
Nomes de arquivos de saída contêm os seguintes elementos. Todos os elementos abaixo são opcionais.
[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]
A tabela define os elementos em um nome de arquivo de dados de saída.
Elemento de nome de arquivo | Descrição |
---|---|
|
Refere-se aos métodos de transferência de dados. Os métodos de transferência incluem:
|
|
ID de destino. Em Audience Manager , um destino é a instância da integração onde você pode mapear seus segmentos direcionáveis. Os clientes podem ter vários destinos, dependendo das necessidades dos negócios. |
|
ID do provedor de dados ou da fonte de dados. Essa ID identifica o tipo de ID de usuário presente no conteúdo do arquivo. As chaves mais comuns da ID de usuário são:
Consulte Fontes de dados globais para obter mais detalhes. |
|
O identificador do cliente da plataforma de terceiros. |
|
O modo de sincronização é um espaço reservado para macro que adiciona um rótulo ao nome do arquivo com base no tipo de sincronização. Os tipos de sincronização incluem completo e incremental. Eles aparecerão no nome do arquivo como
|
|
Um carimbo de data e hora UNIX de 13 dígitos em milissegundos, no fuso horário UTC. |
|
Um número inteiro. Identifica parte de um arquivo que foi dividida em várias partes para melhorar o tempo de processamento. O número indica a qual parte do arquivo original os dados pertencem. O número inteiro deve ter pelo menos 3 dígitos, precedido de zeros, se o tamanho da divisão for inferior a 100 partes. O arquivo original não terá nenhum número dividido. O primeiro arquivo dividido terminará com 001. Consulte os exemplos abaixo. |
|
Compactação GZIP. |
Arquivos enviados para um local Amazon S3, com PID_ALIAS="XYZCustomer"
e Google Advertiser IDs no conteúdo do arquivo.
Por exemplo, arquivos incrementais:
S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz
Por exemplo, arquivos completos:
S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz
Arquivos enviados para o local FTP, sem PID_ALIAS
e com Apple Advertiser IDs no conteúdo do arquivo:
Por exemplo, arquivos incrementais:
ftp_1234_20915_iter_1486140843000.sync.gz
ftp_1234_20915_iter_1486140843000001.sync.gz
Por exemplo, arquivos completos:
ftp_1234_20915_full_1486140843000.sync.gz
ftp_1234_20915_full_1486140843000001.sync.gz
Cenário 3: Arquivos enviados para o FTP local, com PID_ALIAS="XYZCustomer"
e com ID de usuário de terceiros no conteúdo do arquivo ( Vendor ID=45454
):
Por exemplo, arquivos incrementais:
ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
Por exemplo, arquivos completos:
ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz
Descreve os campos obrigatórios, a sintaxe e as convenções usadas para organizar as informações em um arquivo de dados externo. Formate seus dados de acordo com essas especificações.
Os elementos de estilo (monospaced text
, italics, 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 campos no arquivo de dados são exibidos nesta ordem:
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...
A tabela lista variáveis que definem o conteúdo de um arquivo de dados.
Parâmetro | Descrição |
---|---|
|
Uma ID de usuário exclusiva atribuída por Audience Manager . |
|
Separe o UUID e os dados do segmento com um espaço |
|
A ID de segmento à qual um visitante pertence. Separe vários segmentos com uma vírgula. |
|
A ID de segmento da qual o usuário foi desqualificado. Separe vários segmentos com uma vírgula. Com uma sincronização completa, você pode ignorar os segmentos removidos porque o arquivo de dados conterá a lista completa dos segmentos atuais para o usuário. Geralmente, você deseja saber sobre segmentos aos quais um usuário pertence e não aqueles dos quais ele foi removido. Consulte também Nome do arquivo de dados de saída: Sintaxe e exemplos . |
Um arquivo de dados corretamente formatado pode ser semelhante à amostra a seguir. Essa entrada de arquivo indica que um usuário se qualifica para os segmentos 24, 26 e 27. Conforme necessário, um espaço separa as UUID
e as IDs de segmento. Outro espaço separa os conjuntos de IDs de segmento. Neste exemplo, um usuário pertence aos segmentos 24, 26 e 27. Eles foram removidos dos segmentos 25 e 28.
59767559181262060060278870901087098252 24,26,27 25,28