Show Menu
TÓPICOS×

Nome do arquivo de dados de saída: Sintaxe e exemplos

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

Elementos de sintaxe e nome de arquivo

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]

Parâmetros

A tabela define os elementos em um nome de arquivo de dados de saída.
Elemento de nome de arquivo Descrição
SYNC_TYPE
Refere-se aos métodos de transferência de dados. Os métodos de transferência incluem:
  • FTP - Transferir usando SFTP
  • Amazon S3 - Transferência para o Amazon AWS
DID
ID de destino.
No 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.
MASTER_DPID
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:
  • 2014 - Google Advertiser ID (bruto, sem hash)
  • 2015 - Apple ID for Advertisers (bruto, sem hash)
  • ID do fornecedor - IDs de usuário de terceiros (Web/cookie)
Consulte Fontes de dados globais para obter mais detalhes.
PID_ALIAS
O identificador do cliente da plataforma de terceiros.
SYNC_MODE
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 iter ou full .
  • iter : Indica uma sincronização "iterativa" ou incremental. Um arquivo incremental contém apenas novos dados coletados desde a última sincronização.
  • full : Indica uma sincronização "completa". Um arquivo totalmente sincronizado contém dados antigos e quaisquer novos dados coletados desde a última sincronização.
TIMESTAMP
Um carimbo de data e hora UNIX de 13 dígitos em milissegundos, no fuso horário UTC.
SPLITNUM
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.
.gz (optional)
Compactação GZIP.

Exemplos de nome de arquivo

Cenário 1

Arquivos enviados para um Amazon S3 local, com PID_ALIAS="XYZCustomer" e com Google Advertiser IDs o 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

Cenário 2

Arquivos enviados para o FTP local, sem PID_ALIAS e com Apple Advertiser IDs o 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

Conteúdo do arquivo de dados de saída: Sintaxe e parâmetros

Descreve os campos obrigatórios, a sintaxe e as convenções usadas para organizar informações em um arquivo de dados externo. Formate seus dados de acordo com essas especificações.
Os elementos de estilo ( 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

Os campos no arquivo de dados são exibidos nesta ordem:
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parâmetros

A tabela lista variáveis que definem o conteúdo de um arquivo de dados.
Parâmetro Descrição
UUID
Uma ID de usuário exclusiva atribuída pelo Audience Manager .
<SPACE>
Separe o UUID e os dados do segmento com um espaço
SEGMENT_N
A ID de segmento à qual um visitante pertence. Separe vários segmentos com uma vírgula.
REMOVED_SEGMENT_N
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 .

Exemplo: Formato básico de arquivo

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 IDs do segmento UUID e do 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