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.
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.
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.
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 .
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.
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 .
PASSO 3: Verificação da importação
7. Clique em Ir para a lista de importações .
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.
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.
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:
- Ficha de produto, para conhecer as tags e categorias dos produtos do seu eCommerce.
- Sincronização e verificação de produtos, para aproveitar todo o potencial do catálogo da Connectif.
- Segmentos de produtos, para aprender a utilizar grupos de produtos em tempo real em diferentes estratégias.
-
Recomendador de ofertas, para ajudar clientes indecisos a optar por produtos em promoção no site.