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

Última atualização: 20 de julho de 2024
  • Tópicos:

Descreve os campos obrigatórios, a sintaxe e as convenções usadas para nomear um arquivo de dados de saída.

NOTE
Os elementos de estilo (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.

Elementos de sintaxe e nome de arquivo

Os nomes de arquivo 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 do nome do arquivoDescrição
SYNC_TYPE

Consulte os métodos de transferência de dados. Os métodos de transferência incluem:

  • FTP - Transferir usando SFTP
  • Amazon S3 - Transferir para Amazon AWS
DID

ID de destino.

No Audience Manager , um destino é a instância da integração em que você pode mapear seus segmentos direcionáveis. Os clientes podem ter vários destinos, dependendo da necessidade do negócio.

MASTER_DPID

Provedor de dados ou ID da fonte de dados. Essa ID identifica o tipo de ID de usuário presente no conteúdo do arquivo. As chaves de ID de usuário mais comuns são:

  • 20914 - ID do Anunciante do Google (bruto, sem hash)
  • 20915 - Apple ID 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_ALIASO 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 completa 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 somente novos dados coletados desde a última sincronização.
  • full : indica uma sincronização "completa". Um arquivo totalmente sincronizado contém dados antigos e quaisquer dados novos coletados desde a última sincronização.
TIMESTAMPUm carimbo de data e hora UNIX de 13 dígitos em milissegundos, no fuso horário UTC.
SPLITNUM

Um inteiro. Identifica a parte de um arquivo que foi dividida em várias partes para melhorar os tempos de processamento. O número indica a qual parte do arquivo original os dados pertencem.

O inteiro deve ter pelo menos 3 dígitos, precedido por zeros, se o tamanho da divisão for inferior a 100 partes.

O arquivo original não terá um número de divisão. O primeiro arquivo dividido terminará com 001. Veja 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 local FTP, com PID_ALIAS="XYZCustomer" e 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, a sintaxe e as convenções necessários usados para organizar as informações em um arquivo de dados de saída. Formate os dados de acordo com essas especificações.

NOTE
Os elementos de estilo (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.

Sintaxe

Os campos no arquivo de dados aparecem nesta ordem:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parâmetros

A tabela lista as variáveis que definem o conteúdo de um arquivo de dados.

ParâmetroDescrição
UUIDUma ID de usuário exclusiva atribuída por Audience Manager .
<SPACE>Separe a UUID e segmente os dados com um espaço
SEGMENT_NA ID de segmento à qual um visitante pertence. Separe vários segmentos com uma vírgula.
REMOVED_SEGMENT_NA 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 de segmentos atuais para o usuário. Normalmente, você deseja saber sobre os segmentos aos quais um usuário pertence em vez daqueles dos quais foram removidos. Consulte também Nome do Arquivo de Dados de Saída: Sintaxe e Exemplos.