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

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now