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