Importação de produtos

A importação de produtos permite adicionar itens ao seu catálogo manualmente por meio da ferramenta de importação, para que estejam disponíveis imediatamente em suas estratégias.

Neste artigo, você aprenderá como realizar uma importação de produtos na Connectif.

Tempo de implementação: 10 min.
Dificuldade: Baixa.
Quando utilizá-la?: Ao integrar sua conta da Connectif e em qualquer momento de forma pontual.
  

Embora a tag "Contato visitou um produto" cadastre automaticamente os produtos conforme forem sendo visualizados, é recomendável realizar uma importação inicial de todo o catálogo ao integrar a Connectif, para tê-lo disponível desde o início.

 

Antes de começar: preparação do arquivo de produtos

  

Para realizar a importação, é necessário um arquivo CSV válido que contenha os campos dos produtos que se deseja importar. 

Na tabela a seguir, são mostrados os campos que podem ser incluídos no CSV:

Nome Tipo Descrição Exemplo
productDetailUrl Texto URL da página do produto (a URL deve estar sem codificação). Este valor é obrigatório no documento. http://exple.com/productA
productId Texto Identificador único do produto (no eCommerce). Este valor é obrigatório no documento. 101
name Texto Nome do produto. Este valor é obrigatório no documento. Product A
unitPrice Decimal Preço unitário do produto. Este valor é obrigatório no documento. 20.99
imageUrl Texto URL da imagem do produto. http://exple.com/images/productA.jpg
description Texto Descrição do produto. An innovative gadget for modern homes.
thumbnailUrl Texto URL da imagem de visualização do produto. http://expl.com/thumbs/productA.jpg
categories Lista de textos A(s) categoria(s) à(s) qual(is) o produto pertence. Para indicar várias categorias, utilize o caractere "|". Se o eCommerce permitir subcategorias, indique o caminho completo separando cada nível com o caractere "/".
Por exemplo: "/Computadores/Teclados/Logitech".
electronics/home/gadgets|
electronics/home/accessories
tags Lista de textos As tags associadas ao produto. Para indicar várias tags, utilize o caractere "|".  innovative|gadget
brand Texto Marca do produto. GadgetPro
ratingCount Inteiro Número de avaliações que o produto possui. 150
rating Decimal Classificação média do produto. 4.5
reviewCount Inteiro Número de resenhas que o produto possui. 75
relatedExternalProductIds Lista de textos IDs de produtos relacionados. Para indicar vários produtos, utilize o caractere "|".  200|201
priority Inteiro Nível de prioridade ou preferência deste produto. O valor padrão é 0. 5
unitPriceOriginal Decimal Preço unitário original do produto. 25.99
unitPriceWithoutVAT Decimal Preço unitário sem impostos do produto. 17.49
discountedPercentage Decimal Porcentagem de desconto, intervalo de 0 a 100, sem o símbolo de porcentagem. 20
discountedAmount Decimal Valor descontado do produto (deve corresponder a unit_price_original - unit_price). 5.0
publishedAt Data Data no formato ISO8601 da primeira vez que o produto apareceu no catálogo da loja. 2021-03-15T00:00:00Z
inStockUnits Inteiro Número de unidades do produto em estoque. 120
availability Texto Marcado como instock ou outofstock. Indica se o produto está disponível ou não. instock
isBlacklisted Booleano Marcado como true ou false e permite (quando marcado como true) excluir o produto das recomendações. Se não for indicado, o valor padrão será false ao criar o produto. false
customField1 Texto Propriedade personalizada. CustomValueA1
customField2 Texto Propriedade personalizada. CustomValueA2
customField3 Texto Propriedade personalizada. CustomValueA3
 

Os nomes da tabela devem ser mantidos exatamente iguais se a importação de produtos for feita via API. Caso contrário, eles podem ser alterados, já que deverão ser associados posteriormente no mapeamento.

A seguir, um exemplo de dados extraídos do CSV:

name,productDetailUrl,productId,unitPrice,imageUrl,thumbnailUrl,description,categories,tags,relatedExternalProductIds,priority,ratingCount,rating,reviewCount,brand,unitPriceOriginal,unitPriceWithoutVAT,discountedAmount,discountedPercentage,publishedAt,inStockUnits,availability,isBlacklisted,customField1,customField2,customField3
Product A,http://example.com/productA,101,20.99,http://example.com/images/productA.jpg,http://example.com/thumbs/productA.jpg,An innovative gadget for modern homes.,electronics/home/gadgets|electronics/home/accessories,innovative|gadget,200|201,5,150,4.5,75,GadgetPro,25.99,17.49,5.0,20,2021-03-15T00:00:00Z,120,instock,false,CustomValueA1,CustomValueA2,CustomValueA3
Product B,http://example.com/productB,102,45.5,http://example.com/images/productB.jpg,http://example.com/thumbs/productB.jpg,A durable and reliable tool for professionals.,tools/professional/hardware|tools/professional/accessories,durable|professional,300|301,3,200,4.7,90,ToolWorks,50.0,37.92,4.5,10,2021-06-20T00:00:00Z,80,outofstock,true,CustomValueB1,CustomValueB2,CustomValueB3

 

PASSO 1: Seleção da origem de dados

1. Acesse "Eccommerce > Catálogo" e clique em   Importar produtos.

Importacio_n_de_productos_-_1.png

2. Na seção Selecionar uma fonte de dados escolha a opção Importar de arquivo.

  

É possível realizar a importação copiando e colando o conteúdo do CSV na caixa de texto central, mas essa opção é mais limitada pois não suporta grandes quantidades de produtos.

Importacio_n_de_productos_-_2.png

3. Configure os parâmetros da importação.

3.1. Selecione Incluir cabeçalho se o arquivo CSV tiver um cabeçalho com os nomes das colunas.

3.2. Escolha, em Delimitador, o caractere que separa as colunas do seu arquivo.

3.3. Selecione a opção Sobrescrever existentes se quiser substituir as informações dos produtos que já existem na Connectif pelas contidas no arquivo.

3.4. Selecione a opção Atualizar apenas campos vazios se quiser que apenas os campos sem informação sejam atualizados.

4. Clique em Seguinte  .

Importacio_n_de_productos_-_3.png

 

PASSO 2: Configuração dos campos a importar

  

Uma vez importado o arquivo, será necessário associar os campos do CSV importado (coluna da esquerda da interface) com os campos dos produtos na Connectif.

5. Selecione o nome de cada campo do arquivo importado e arraste-o até o campo correspondente da Connectif.

Importacio_n_de_productos_-_4.png

 

No exemplo, o campo do arquivo ID é o que atribui valor ao campo ID externo do produto na Connectif, Nome do Produto atribui valor ao campo Name na Connectif, Categorias para Categories e Preço Unitário para Unit Price.

  

Também existe um valor (sempre disponível) chamado Literal. Sua principal utilidade é "simular" que está sendo importada uma coluna que, na verdade, não está no arquivo CSV importado. Ao atribuir Literal a um campo do produto, aparecerá um editor que permite atribuir o valor desejado a esse campo para todos os produtos que serão importados. 

6. Clique em Seguinte  .

Importacio_n_de_productos_-_5.png

 

PASSO 3: Verificação da importação

7. Clique em Ir para a lista de importações  .

Importacio_n_de_productos_-_6.png

8. Verifique se os produtos e suas informações foram importados corretamente.

  

Nesta tela, aparece a porcentagem de progresso da importação de produtos e, uma vez concluída, o resumo da operação. 

Importacio_n_de_productos_-_7.png

9. Se houver algum erro, baixe o CSV de relatório de erros clicando no botão   (Baixar relatório de erros em CSV).

  

O erro mais comum na importação é que alguma das linhas do arquivo CSV contenha um tipo de dado incompatível com o campo atribuído. Por exemplo, se for atribuído o valor de Texto "PREÇO" ao campo Preço Unitário do produto, a importação desse registro causará um erro.

Importacio_n_de_productos_-_8.png

 

 

Parabéns!
Você chegou ao final da lição.

  

Ficou com dúvidas?
Lembre-se de que você tem à disposição nossos especialistas em Connectif. Para contatá-los, basta abrir um ticket de Suporte clicando no botão azul “Ajuda” do seu Dashboard.

 


Continue aprendendo!

Para aproveitar todo o potencial da sua conta na Connectif, recomendamos continuar com os seguintes artigos: