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.

OBSERVAÇÃO

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.

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.

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.

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 - ID de anunciante do Google (bruto, sem hash)
  • 2015 - ID da Apple para anunciantes (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 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

Cenário 2

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

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 as informações em um arquivo de dados externo. Formate seus dados de acordo com essas especificações.

OBSERVAÇÃO

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.

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

Nesta página