Arquivos de dados de classificação (herdados)

WARNING
O importador de classificação será descontinuado em 31 de agosto de 2026. Altere para utilizar a experiência de Conjuntos de classificação e garantir o funcionamento contínuo.

O importador permite o upload em massa de dados de classificação para relatórios do Analytics em um arquivo. A importação requer um formato de arquivo específico para uploads de dados bem-sucedidos.

Para ajudá-lo a criar arquivos de dados válidos, você pode baixar um arquivo de modelo que fornece uma estrutura de arquivo na qual é possível colar os dados de classificações. Para obter mais informações, consulte Baixar modelo de classificações.

Consulte Estrutura geral do arquivo para obter mais informações sobre limites de caracteres nas classificações.

Estrutura geral do arquivo

A ilustração a seguir é um exemplo de arquivo de dados:

Um arquivo de dados deve seguir as seguintes regras de estrutura:

  • As classificações não podem ter um valor de 0 (zero).

  • A Adobe recomenda limitar a quantidade de colunas de importações e exportações para 30.

  • Os arquivos carregados devem usar UTF-8 sem codificação de caracteres BOM.

  • É possível incorporar caracteres especiais (como tabulações, novas linhas e aspas) em uma célula, desde que o formato de arquivo v2.1 seja especificado e a célula tenha o escape adequado. Os caracteres especiais incluem:

    code language-text
    \t     tab character
    \r     form feed character
    \n    newline character
    "       double quote
    

    A vírgula não é um caractere especial.

  • Os nomes de classificação não podem conter um sinal de interpolação (^), pois esse caractere é usado para indicar uma subclassificação.

  • Tenha cuidado ao usar um hífen. Por exemplo, se você usar um hífen (-) em um termo Social, o Social reconhece o hífen como um operador Not (o sinal de menos). Por exemplo, se você especificar fragrance-free como um termo usando a importação, o Social reconhece o termo como sem minus perfume e coleta as publicações que mencionam fragrance, mas não free.

  • Os limites de caracteres são aplicados para classificar dados de relatório. Por exemplo, se você fizer upload de um arquivo de texto de classificações para produtos (s.products) com nomes de produtos com mais de 100 caracteres (bytes), os produtos não serão exibidos no relatório. Os códigos de rastreamento e todas as variáveis de conversão personalizadas (eVars) permitem 255 bytes. Essa política também se estende aos valores de coluna de classificação e subclassificação, que estão sujeitos ao mesmo limite de 255 bytes.

  • Arquivos de dados delimitados por tabulação (crie o arquivo de modelo usando qualquer aplicativo de planilha ou editor de texto).

  • Arquivo de extensão .tab ou .txt.

  • Um sinal de libra (#) identifica a linha como um comentário do usuário. O Adobe ignora qualquer linha que comece com #.

  • Um sinal de dois quilos seguido por SC (## SC) identifica a linha como um comentário de cabeçalho de pré-processamento usado pelos relatórios. Não exclua essas linhas.

  • As exportações de classificação podem ter chaves duplicadas devido a caracteres de nova linha na chave. Em uma exportação de FTP ou navegador, isso pode ser resolvido ativando as cotações da conta FTP. Isso colocará aspas ao redor de cada chave com caracteres de nova linha.

  • A célula C1 na primeira linha do arquivo de importação contém um identificador de versão que determina como as classificações lidam com o uso de aspas no restante do arquivo.

    • A v2.0 ignora aspas e presume que todas fazem parte das chaves e valores especificados. Por exemplo, considere este valor: "Este é ““algum valor””. A v2.0 interpretaria isso literalmente como: "Este é ““algum valor””.
    • A v2.1 informa às classificações que as aspas fazem parte da formatação de arquivo usada em arquivos do Excel. Portanto, a v2.1 formataria o exemplo acima como: Este é “algum valor”.
    • Podem surgir problemas quando a versão 2.1 é especificada no arquivo, mas o que realmente se deseja é a versão 2.0, ou seja, quando as aspas são usadas de maneiras que são ilegais na formatação do Excel. Por exemplo, se você tiver um valor: “VP NO REPS” S/l Dress w/ Overlay. Com a v2.1, essa é uma formatação incorreta (o valor deve ser entre aspas de abertura e fechamento e as aspas que fazem parte do valor real devem ser evitadas por aspas) e as classificações não funcionarão além desse ponto.
    • Certifique-se de fazer um dos seguintes: altere o formato do arquivo para v2.0, modificando o cabeçalho (célula C1) dos arquivos enviados, OU implemente apropriadamente as aspas do Excel nos arquivos.
  • A primeira linha (sem comentário) do arquivo de dados contém os cabeçalhos de coluna usados para identificar os dados de classificação nessa coluna. O importador requer um formato específico para os títulos das colunas. Para obter mais informações, consulte Formato de cabeçalho de coluna.

  • Imediatamente após a linha de cabeçalho em um arquivo de dados, encontram-se as linhas de dados. Cada linha de dados deve conter um campo de dados para cada cabeçalho de coluna.

  • O arquivo de dados oferece suporte aos seguintes códigos de controle, que o Adobe usa para fornecer estrutura ao arquivo e importar corretamente os dados de classificação:

CÓDIGO DE CONTROLE
DESCRIÇÃO
<Nova linha>
Um novo caractere de linha é o único delimitador compatível entre as linhas/registros de dados no arquivo de dados. Normalmente, você só precisa inserir esses caracteres especificamente ao gravar um programa para gerar arquivos de dados automaticamente.
~autogen~

Solicita que o Adobe gere automaticamente uma ID exclusiva para esse elemento.

No contexto da campanha, esse valor de controle instrui o Adobe a atribuir um identificador a cada elemento criativo. Consulte Chave.

~período~
Determina que a coluna de dados representa o intervalo de datas associado ao item. Consulte Data.
Campo vazio
Representa um valor NULL para o campo atual. Use esta opção se uma determinada coluna de dados não se aplicar ao registro atual.
POR Modificadores
Determina que a coluna de dados representa um campo PER Modifier. Consulte Cabeçalhos PER Modifier.

Formato do cabeçalho de coluna

NOTE
A Adobe recomenda limitar a quantidade de colunas de importações e exportações para 30.

Os arquivos de classificação suporte os seguintes cabeçalhos de coluna:

Chave

Cada valor deve ser exclusivo em todo o sistema. O valor deste campo corresponde a um valor atribuído à variável do Analytics no beacon do JavaScript do site. Os dados desta coluna devem incluir autogen ou qualquer outro código de acompanhamento exclusivo.

Cabeçalho da coluna de classificação

NOTE
Os valores no cabeçalho da coluna Classificações devem corresponder exatamente à convenção de nomeação da classificação ou a importação não ocorrerá. Por exemplo, se o(a) admin alterar Campanhas para Nomes de campanhas internas no Gerenciador de configuração de campanhas, o cabeçalho da coluna do arquivo deverá mudar para corresponder essa alteração. “Chave” é um valor de classificação reservado (cabeçalho). Não é permitido utilizar novas classificações chamadas “Chave”.

Além disso, o arquivo de dados oferece suporte às seguintes convenções de cabeçalho adicionais para identificar subclassificações e outras colunas de dados especializadas:

Cabeçalho de subclassificação

Por exemplo, Campaigns^Owner é um cabeçalho de coluna para a coluna que contém Campaign Owner valores. Da mesma forma, Creative Elements^Size é um cabeçalho de coluna para a coluna que contém a subclassificação Size da classificação Creative Elements.

Resolução de problemas envolvendo classificações

  • Problemas comuns com o Upload: artigo de base de conhecimento que descreve problemas resultantes de formatos de arquivos incorretos e conteúdos de arquivos.
recommendation-more-help
analytics-help-components