DocumentaçãoAnalyticsGuia de componentes

Arquivos de dados de classificação

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Administrador

O importador permite que você faça upload em massa de dados de classificação para relatórios de análise em um arquivo. A importação exige um formato de arquivo específico para fazer upload de dados de maneira bem-sucedida.

Para ajudá-lo a criar arquivos de dados válidos, é possível baixar um arquivo de modelo que oferece uma estrutura de arquivo no qual você pode 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 atender às seguintes regras de estrutura:

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

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

  • Os arquivos enviados devem usar UTF-8 sem a 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. 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.

  • As classificações não podem conter um caractere (^) já que ele é usado para indicar uma subclassificação.

  • Tenha cuidado ao usar 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 número (#) identifica a linha como um comentário do usuário. A Adobe ignora qualquer linha que começa com #.

  • Um sinal de número duplo seguido de SC (##SC) identifica a linha como um comentário do cabeçalho de pré-processamento utilizado pelo relatório. Não exclua estas linhas.

  • Exportações de classificação podem ter chaves duplicadas devido às quebras de linha na chave. No caso de uma exportação FTP ou de navegador, isso pode ser resolvido ao habilitar aspas para a conta FTP. Isso incluirá aspas em todas as chaves com quebras de linha.

  • A célula C1 na primeira linha do arquivo de importação contém um identificador de versão que determina como a classificação lida com o uso de orçamentos no resto do arquivo.

    • v2.0 ignora os orçamentos e considera que todos são parte das chaves e dos valores especificados. Por exemplo, considere este valor: "Este é ""algum valor""". v2.0 interpretaria isso literalmente como: "Este é ""algum valor""".
    • v2.1 faz com que as classificações considerem os orçamentos como parte da formatação de arquivo utilizada nos arquivos Excel. Portanto, v2.1 formataria o exemplo acima como: Este é "algum valor".
    • Os problemas podem surgir quando v2.1 é especificado no arquivo, mas o que é necessário é v2.0; ou seja, quando aspas são utilizadas de forma ilegal na formatação do Excel. Por exemplo, se você tem um valor: "VP NO REPS" S/l Dress w/ Overlay. Com v2.1, esta formatação está incorreta (o valor deve ser cercado por aspas, e as aspas que fazem parte do valor real devem estar entre aspas) e as classificações não funcionarão além deste 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 (não 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 exige um formato de arquivo específico para fazer upload de dados de maneira bem-sucedida. Para obter mais informações, consulte Formato de cabeçalho de coluna.

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

  • O arquivo de dados oferece suporte para os seguintes códigos de controle, os quais a Adobe usa para fornecer estrutura para o arquivo e importar os dados de classificações corretamente:

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

Exige que a Adobe gere automaticamente uma id única para este elemento.

No contexto de campanha, este valor de controle instrui a Adobe a atribuir um identificador para cada elemento criativo. Consulte Chave.

~period~
Determina que a coluna de dados representa o intervalo de dias associado ao item. Consulte Data.
Campo vazio
Representa um valor NULO para o campo atual. Use este controle se uma coluna de dados específica não se aplicar ao registro atual.
PER Modifiers
Determina que a coluna de dados representa um campo PER Modifier. Consulte Cabeçalhos PER Modifier.
Related Articles

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 adicionais de cabeçalho para identificar subclassificações e outras colunas de dados especializadas:

Cabeçalho de subclassificação

Por exemplo, Campanhas^Proprietário é um cabeçalho de coluna para a coluna que contém valores de Proprietário da campanha. Da mesma forma, Elementos Criativos^Tamanho é um cabeçalho de coluna para a coluna que contém a subclassificação Tamanho da classificação Elementos Criativos.

Cabeçalhos de métrica de classificação

Por exemplo, Campanhas^~Custo refere-se à métrica Custo na classificação Campanhas.

Cabeçalho PER modifier

Os cabeçalhos Per Modifier são indicados adicionando ~per ao cabeçalho de métrica de classificação. Por exemplo, se o cabeçalho Metric for Campaigns^~Cost, o cabeçalho modificador PER será Campaigns^~Cost~per. A Adobe oferece suporte às seguintes palavras-chave PER Modifier:

Esses caracteres têm um significado especial em um arquivo de dados. Sempre que possível, evite o uso dessas palavras em nomes e dados de atributos.

FIXO: valor fixo. Não executa qualquer escala.

DIA: Multiplica o valor pelo número de dias no relatório.

ORDEM: Multiplica o valor pelo número de ordens para o item da linha no relatório.

CHECKOUT: Multiplica o valor pelo número de checkouts para o item da linha no relatório.

UNIDADE: Multiplica o valor pelo número de unidades para o item da linha no relatório.

RECEITA: Multiplica o valor pela receita para o item da linha no relatório.

SCADD: Multiplica o valor pelo número de vezes que o evento Adição ao carrinho de compras foi chamado por item da linha no relatório.

SCREMOVE: Multiplica o valor pelo número de vezes que o evento Remoção do carrinho de compras foi chamado por item da linha no relatório.

INSTÂNCIA: Multiplica o valor pelo número de instâncias para o item da linha no relatório.

CLIQUE: Multiplica o valor pelo número de cliques para o item da linha no relatório.

EVENTO: Multiplica o valor pelo número de vezes que um evento personalizado especificado ocorreu por item da linha no relatório.

Exemplo: se a Campanha A custa USD$ 10.000, a coluna Campanhas^~Custo contém um valor de 10.000 e a coluna Campanhas^Custoper contém FIXO. Ao exibir o custo para a Campanha A nos relatórios, você notará $10.000 como o valor fixo para a Campanha A para o intervalo de datas do relatório.

Exemplo: Se a Campanha B custa aproximadamente USD$ 2 por clique, a coluna Campanhas^~Custo contém 2 e a coluna Campanhas^Custopor contém CLIQUE. Ao exibir o custo para a Campanha B nos relatórios, a Adobe calcula (2 vezes * [ número de cliques ]) imediatamente para o intervalo de datas do relatório. Isso dá a você um cálculo do custo total com base no número de cliques realizados na Campanha B.

Data

As datas das campanhas são normalmente intervalos (datas inicial e final) associados a campanhas individuais. As datas devem aparecer no formato AAAA/MM/DD. Por exemplo, 2013/06/15-2013/06/30.

Para obter mais informações, consulte Classificações de conversão.

NOTE
Na Versão de manutenção do Analytics de 10 de maio de 2018, a Adobe começou a limitar a funcionalidade de classificações numéricas e habilitadas por data. Esses tipos de classificações foram removidos das interfaces Admin e Importador de classificações. Nenhuma classificação numérica ou habilitada por data pode ser adicionada. As classificações existentes ainda podem ser gerenciadas (atualizadas, excluídas) por meio do fluxo de trabalho de classificação padrão, e continuarão disponíveis nos relatórios.

Uso de datas junto a classificações section_966A07B228CD4643B258E73FB8BA150A

As classificações podem ser usadas para atribuir intervalos de datas para suas campanhas ou outras classificações de conversão, o que permite uma medição de campanha mais precisa. Após especificar um intervalo de datas, qualquer valor correspondente que ocorrer fora do intervalo de datas não será classificado. Isso é útil para uma medição de campanha que deseja utilizar as datas exatas em que uma campanha estava Disponível, e não todos os hits que correspondem a campanha propriamente dita. Para classificar com sucesso um valor com intervalo de datas, as seguintes condições devem ser atendidas:

  • A classificação deve ser baseada em um variável de conversão.
  • A classificação usada deve ser definida como Date-Enabled ou Numeric 2.
  • O intervalo de datas envolvido deve conter uma data de início e uma data de término (opcional).

Para classificar campanhas baseadas em intervalo de datas:

IMPORTANT
Essa opção não está disponível para conjuntos de relatórios habilitados para a Nova arquitetura de classificação.

  1. Faça logon em Analytics Admin > Classificações.

  2. Clique na guia Exportação de navegador, certifique-se de que as configurações da sua classificação habilitada para data estão corretas e, em seguida, clique em Exportar arquivo.

  3. Abra esse arquivo no Microsoft Excel ou outro editor de planilhas.

  4. Uma das colunas terminará com

    ^período
    que é a coluna em que o intervalo de datas deve ser inserido.

  5. Nessa coluna, insira o intervalo de datas de cada valor no seguinte formato:

    YYYY/MM/DD - YYYY/MM/DD. Não deixe de:

    • Colocar espaços em ambos os lados do travessão.
    • Usar um hífen (-) para separar os intervalos, e não um traço ou um travessão.
    • Colocar um zero antes de meses com um só dígito.
    • Colocar um data de início para o intervalo de datas; a data de término é opcional.

  6. Salve o arquivo e faça upload no Analytics acessando Admin| Classificações | Importar arquivo.

NOTE
Um valor de chave específico não pode ter mais de um intervalo de datas.

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
46b8682c-fda6-4669-9355-1a44923e549e