Usar o carregador de arquivos
O Adobe Commerce Intelligence é poderoso não apenas por causa de seus recursos de visualização, mas também porque oferece a capacidade de colocar todos os seus dados em uma única Data Warehouse. Mesmo dados que estão fora de seus bancos de dados e integrações podem ser trazidos para o Commerce Intelligence usando a ferramenta Upload de Arquivo no Gerenciador de Datas Warehouse.
Use campanhas publicitárias como exemplo. Se você estiver executando campanhas online e offline, não poderá obter o quadro completo se estiver analisando apenas dados de uma integração online. Fazer o upload de uma planilha com os dados de campanha offline permite analisar ambos os conjuntos de dados e obter uma compreensão mais robusta do desempenho da campanha.
Restrições e requisitos require
-
O único formato suportado para os carregamentos de arquivos é
CSV
oucomma separated values
. Se estiver trabalhando no Excel, você pode usar a função Salvar como para salvar o arquivo no formato.csv
. -
CSV
arquivos devem usarUTF-8 encoding
. Na maioria das vezes, isso não é um problema. Se você encontrar este erro ao carregar um arquivo, consulte este artigo de suporte. -
Os arquivos não podem ter mais de 100 MB. Se o arquivo for maior que isso, separe a tabela em partes e salve-as como arquivos individuais. Você pode anexar os dados depois que o arquivo inicial for carregado.
-
Todas as tabelas devem ter um
primary key
. Deve haver pelo menos uma coluna na tabela que possa ser usada comoprimary key
ou um identificador exclusivo para cada linha na tabela. Qualquer coluna designada comoprimary key
pode never ser nula. Umprimary key
pode ser tão simples quanto adicionar uma coluna que forneça um número para cada linha, ou pode ser duas colunas concatenadas para criar uma coluna de valores únicos (por exemplo,campaign name
edate
).Se uma coluna (ou colunas) for designada como exclusiva, mas houver duplicatas, as linhas duplicadas não serão importadas.
Formatação de dados para upload formatting
Antes de carregar seus dados no Commerce Intelligence, verifique se eles estão formatados de acordo com as diretrizes desta seção.
Linha de cabeçalho header
Para garantir que as colunas sejam rotuladas e importadas corretamente, verifique se a primeira linha da planilha é um cabeçalho que descreve os dados em cada coluna.
Os nomes das colunas devem ser exclusivos e conter apenas letras, números, espaços e estes símbolos: $ % # /
. Se um nome de coluna contiver uma vírgula, ele será dividido em duas colunas quando o arquivo for carregado. Além disso, a Adobe recomenda que haja menos de 85 colunas no arquivo para otimizar a velocidade de atualização.
Dados com vírgulas commas
Como os arquivos devem estar no formato CSV
, o uso de vírgulas pode causar problemas com o carregamento de dados. CSV
arquivos usam vírgulas para indicar novos valores, portanto, uma coluna com um nome como Campaigns
, August
é lida como duas colunas (Campaigns
e August
) em vez de uma, deslocando todos os seus dados por uma linha. Adobe recomenda evitar vírgulas sempre que possível. Você pode usar o Data Preview
para ver se os dados são exibidos corretamente após a conclusão de uma atualização.
Datas
Qualquer conjunto de dados que inclua datas deve usar o formato de data padrão YYYY-MM-DD HH:MM:SS
ou MM/DD/YYYY
.
Caracteres especiais
Alguns caracteres especiais não são aceitos. Por exemplo, o símbolo de barra vertical & # 1 2 4
é interpretado como a criação de uma coluna e causa erros ao carregar um arquivo.
Números Decimais
Os valores de moeda devem ter o tipo de dados Decimal Number
selecionado e essas colunas são arredondadas automaticamente para duas casas decimais na Data Warehouse. Se você não quiser arredondar seus números decimais ou tiver um grau de precisão maior que este, você deve selecionar o tipo de dados Non-Currency Decimal Number
.
Porcentagens
As porcentagens devem ser inseridas como decimais. Por exemplo:
.05
5%
.23
23
Valores com zeros iniciais e/ou finais zeroes
Alguns valores no arquivo, como códigos postais e IDs, podem começar ou terminar com zeros. Para garantir que os zeros sejam mantidos e carregados corretamente, você pode alterar o tipo de formatação (por exemplo, de número para texto) ou impor a formatação de número.
Use US ZIP codes
como exemplo de como alterar a formatação de números. Em Excel, realce a coluna que contém ZIP codes
e altere o formato do número para ZIP code
. Você também pode selecionar um formato de número personalizado e, na janela Type
, inserir 00000
. Lembre-se que este método pode apresentar problemas se alguns códigos estiverem formatados como 00000
e outros como 00000-0000
.
O Type
pode ser formatado de forma diferente para acomodar outros tipos de dados, como IDs. Se um ID
tiver nove dígitos, por exemplo, Type
poderia ser 000000000
ou 000-000-000
. Isso mudaria 123456
para 000-123-456
.
Para os recursos Google Docs e Apple Numbers, consulte a lista Relacionados na parte inferior desta página.
Upload de dados uploading
Agora que sua planilha está formatada corretamente e é compatível com o Commerce Intelligence, adicione-a à Data Warehouse.
-
Para começar, acesse Data > File Uploads.
-
Clique na guia Upload to New Table.
-
Clique em Choose File e selecione o arquivo. Clique em Open para iniciar o carregamento.
Depois que o carregamento for concluído, uma lista das colunas Commerce Intelligence encontradas em seu arquivo será exibida.
-
Verifique se os nomes das colunas e os tipos de dados estão corretos. Especificamente, verifique se qualquer coluna de data está sendo lida como datas, não como números.
note note NOTE O datatype
é importante, portanto, não ignore esta etapa! -
Selecione a(s) coluna(s) que compõe(m) a
primary key
da tabela usando as caixas de seleção no ícone de chave. -
Nomeie a tabela.
-
Clique em Save Table.
Sucesso!A mensagem aparece na parte superior da tela depois que a tabela é salva.
Se você precisar de um visual, observe todo o processo:
As tabelas carregadas são exibidas na seção Carregamentos de Arquivos da lista de tabelas (nas opções Todas as Tabelas e Tabelas Sincronizadas) no Gerenciador de Datas Warehouse:
Atualização ou anexação de dados a uma tabela existente appending
Tem novos dados para adicionar a um arquivo que você já carregou? Sem problemas - você pode atualizar e anexar dados facilmente no Commerce Intelligence.
-
Para começar, acesse Manage Data > File Uploads.
-
Clique na guia Edit/Upload
.csv
para Tabelas Existentes. -
Na lista suspensa, clique no nome da tabela que deseja atualizar ou anexar.
-
Use a lista suspensa para selecionar a opção para manipular linhas duplicadas:
table 0-row-2 1-row-2 2-row-2 3-row-2 Opção Descrição Overwrite old row with new row
Isso substituirá os dados existentes pelos novos dados se uma linha tiver a mesma chave primária tanto na tabela existente quanto no novo arquivo. Este é o método a ser usado para colunas com valores que mudam com o tempo - por exemplo, uma coluna Status. Os dados existentes são substituídos e atualizados com os novos dados. Linhas com chaves primárias que não estão na tabela existente são adicionadas como novas linhas. Retain old row; discard new row
Isso faz com que os novos dados sejam ignorados se uma linha tiver a mesma chave primária tanto na tabela existente quanto no novo arquivo. Purge all existing rows first and ignore duplicate keys within the file
Isso exclui todos os dados existentes e os substitui pelos novos dados do arquivo. Use essa opção somente se não precisar dos dados na tabela existente. -
Clique em Choose File e selecione o arquivo.
-
Clique em Open para iniciar o carregamento.
Após a conclusão do carregamento, Commerce Intelligence validará a estrutura de dados no arquivo. Sucesso!A mensagem aparece na parte superior da tela depois que a tabela é salva.
Disponibilidade de dados availability
Assim como as colunas calculadas, os dados de uploads de arquivo ficam disponíveis após a conclusão do próximo ciclo de atualização. Se uma atualização estava em andamento durante o upload do arquivo, os dados não estarão disponíveis até após a próxima atualização. Depois que um ciclo de atualização for concluído, você poderá navegar até a guia Data Preview
na Data Warehouse para garantir que o arquivo seja carregado corretamente e os dados sejam exibidos conforme esperado.
Encapsulamento wrapup
Este tópico abordou apenas as noções básicas de uso da importação de dados, mas convém fazer algo mais avançado. Confira os artigos relacionados para obter orientação sobre formatação e importação de dados financeiros, de comércio eletrônico e de gastos com anúncios, entre outros.
Além disso, o carregamento de arquivo não é a única maneira de obter seus dados no Commerce Intelligence. As funções da API de Importação de Dados permitem enviar dados arbitrários para a Data Warehouse Commerce Intelligence.