A ferramenta de Sincronização de Produtos permite automatizar a forma como o Connectif revisa o catálogo de produtos do seu eCommerce e o atualiza em sua Loja do Connectif. Através da interface, você poderá escolher a opção de sincronização em massa por Web Scraping ou através do Feed de Produtos, bem como configurar esse processo.
Além dos métodos de sincronização e verificação via interface do Connectif, também é possível importar e atualizar produtos realizando chamadas à API do Connectif. Para mais informações, consulte a documentação associada.
Como acessar
Você pode acessar a funcionalidade de sincronização em massa de produtos através do caminho "Ecommerce > Catálogo", clicando em Sincronização de produtos.
Interface
A interface principal da Sincronização de Produtos é composta por 3 blocos:
1. Abas: para navegar por uma das duas opções de sincronização, além de revisar o registro de sincronizações:
- Web Scraping: para automatizar a sincronização através da consulta do Connectif ao catálogo do eCommerce.
- Feed de produtos: para automatizar a sincronização consultando um feed de produtos previamente publicado.
Apenas uma opção de sincronização pode estar ativa. Para saber como configurar cada tipo de sincronização em massa de produtos, veja a seção Funcionamento.
- Registro de sincronização: para revisar os últimos processos de sincronização e seus detalhes.
2. Painel principal: onde estão localizadas as opções de cada aba.
3. Voltar à lista de integrações: para, após configurar a integração, retornar ao Catálogo.
Funcionamento
Você pode ativar sincronizações em massa dos produtos do seu catálogo no Connectif com o estado atual do seu eCommerce. Para isso, há dois métodos com funcionamento distinto:
- O Web Scraping, que faz requisições uma a uma ao seu servidor web para atualizar as informações.
- O Feed de produtos, que faz uma requisição para baixar o arquivo do feed e processar o estado dos produtos.
1. Ativar uma sincronização via Web Scraping
O Web Scraping consiste na revisão, por parte do Connectif, das URLs das páginas de produto que se encontram no seu Catálogo do Connectif. Quando esta função é ativada, no momento e forma determinados, o Connectif visita essas URLs, uma a uma, em busca da tag de produto visualizado, presente no seu eCommerce, para atualizar o estado dos produtos no Connectif e sincronizá-lo com a informação encontrada naquele momento em seu site. Se esses produtos não estiverem no catálogo do seu eCommerce, o Connectif não os visitará.
Em Abas (1), vá para Web Scraping e clique em Configurar.
No Painel principal (2), configure a Periodicidade da sincronização, ou seja, com que frequência você quer que o Connectif acesse seu eCommerce e visite, uma a uma, as páginas dos diferentes produtos para criar, atualizar ou descontinuar os produtos no Catálogo do Connectif, conforme o estado em que eles se encontram em seu site.
Você pode escolher entre as opções: "1 dia", "2 dias", "3 dias" e "1 semana".
Escolha a Hora em que você quer que ocorra cada um dos processos de sincronização.
Em Configuração avançada, você pode definir dois aspectos que ajudarão a otimizar o desempenho da atualização do Catálogo com base no desempenho da sua página.
- No menu suspenso Tempo de espera entre produtos, você pode escolher se quer que o Connectif espere entre as visitas aos diferentes produtos e, em caso afirmativo, quanto tempo ele deve esperar. Dependendo do tamanho do seu catálogo, você pode aumentar ou diminuir o tempo para não sobrecarregar a página.
- No seletor Incluir produtos descontinuados, você pode escolher se quer que o Connectif não visite os produtos marcados como descontinuados no processo de sincronização. Esta opção reduz a carga do site e aumenta o desempenho do processo de sincronização via Web Scraping.
Uma vez determinada a configuração da sincronização, clique em Ativar para programar a sincronização, ou em Ativar e sincronizar imediatamente para executar a sincronização e programar a próxima dentro do período estabelecido.
2. Ativar uma sincronização via Feed de Produtos
A sincronização em massa via Feed de Produtos é muito mais rápida e reduz a carga do seu servidor web, pois realiza apenas uma única requisição para baixar o arquivo do seu eCommerce, em vez de uma requisição para cada produto.
Apenas um Feed de Produtos pode ser adicionado, portanto ele deve estar completo.
Esta requisição é feita no período e horário configurados. O Connectif armazena uma cópia do Feed original no momento indicado. Por isso, se houver alguma alteração no Feed após a execução de uma sincronização ou durante uma sincronização em andamento, ela não será refletida no Connectif até a próxima execução da sincronização.
Os produtos passam para o estado "Descontinuado" se não aparecerem no feed durante 10 dias. Esta verificação é feita todos os dias.
Em Abas (1), vá para Feed de Produtos e clique em Configurar.
No Painel principal (2), na área Adicionar feed de produtos, adicione a URL do feed de produtos do qual o Connectif extrairá as informações do seu catálogo.
O feed de produtos é um arquivo XML que deve estar acessível publicamente, ou seja, a URL do feed deve ser pública, sem httaccess. Esse documento contém uma série de objetos com as propriedades de um produto, em forma de etiquetas e valores.
Especificações sobre o Feed de Produtos:
No final deste artigo (ou clicando neste link), você encontrará um documento de exemplo de Feed de Produtos.
Também encontrará um arquivo para download com o esquema utilizado para descrever a estrutura e as restrições dos conteúdos dos documentos XML do Feed de Produtos (ou clicando neste link).
- Quando o Connectif tenta ler o feed em uma URL, ele utiliza o cabeçalho 'User-Agent': 'Connectif'. Isso pode ser útil caso você precise permitir acesso ao recurso apenas para determinadas aplicações.
- Pode-se utilizar o modelo de feed especificado pelo Google. Caso utilize outro formato, será permitido apenas que o elemento "Produto" esteja no segundo nível. Ou seja, o feed pode conter no máximo três níveis: o que contém a lista de produtos, o item em si e as propriedades do produto.
- Campos do Google que o Connectif converte automaticamente:
- G:AUTO_PRICING_MIN_PRICE, G:SALE_PRICE, G:PRICE: são formatados para remover a moeda e tratá-los como número.
- G:AVAILABILITY: são aceitos os valores permitidos pelo Google 'in_stock', 'in stock', e são transformados no nosso valor válido "instock".
- G:GOOGLE_PRODUCT_CATEGORY, G:PRODUCT_TYPE: os caracteres exigidos pelo Google ">" para a separação de categorias são substituídos pelo permitido no Connectif "/".
- A codificação do feed deve ser UTF-8.
- Os campos que não forem mapeados no feed serão respeitados e não serão sobrescritos.
- Produtos criados por outros mecanismos além do feed não serão descontinuados.
- Se não for usado o formato do Google, os dados relativos a preços devem estar em formato numérico.
- Podem ser utilizadas várias etiquetas com o mesmo nome.
- Quando um campo não é detectado automaticamente e é mapeado manualmente, o caminho do campo será composto pelos nomes de cada nível da etiqueta até o valor, separados por um ">".
- Todos os campos de tipo "array" no mapeamento, caso apareçam várias vezes no Feed, o Connectif coletará todos os valores nesse campo.
Se você utiliza categorias personalizadas para os produtos da sua loja e seu feed de produtos é do tipo Google, pode adicioná-las na tag G:PRODUCT_TYPE e depois configurá-la no mapeamento para que o Connectif as obtenha. Se precisar de mais informações sobre como enviar as categorias personalizadas de produto, visite a documentação oficial do Google.
Configure a Periodicidade da sincronização, ou seja, com que frequência você quer que o Connectif acesse seu Feed de Produtos para extrair as informações. Você pode escolher entre: "1 dia", "2 dias", "3 dias" e "1 semana".
Escolha o Horário em que você quer que ocorra cada um dos processos de sincronização.
Clique em Próximo .
No Painel Principal (2), você deverá selecionar os valores detectados do Feed de Produtos e vinculá-los com os da ficha de produto da Connectif.
O campo mapeado como "URL do produto" é validado com os domínios permitidos.
Para isso, clique em cada um dos campos da coluna Campos de produto detectados automaticamente e arraste-os para a coluna central, de forma que correspondam aos campos da ficha de produto da Connectif (coluna da direita).
A seleção dos campos a mapear é obtida a partir dos campos únicos de uma amostra de produtos do seu Feed.
Se houver no seu Feed de produtos algum campo que você queira vincular e que não aparece na seleção de valores, deverá selecionar o valor "Caminho do campo", vinculá-lo ao campo correspondente e inserir manualmente o caminho e cada um de seus níveis no mesmo formato utilizado nos demais campos da Connectif.
Copie o caminho e seus diferentes níveis, conforme mostrado no exemplo.
Insira-os na Connectif com o formato correspondente. Cada um dos níveis do caminho que você inserir deverá ser separado pelo símbolo ">".
Se você alterar o nome de algum dos campos mapeados no seu Feed de Produtos, será necessário atualizá-lo na Connectif da mesma forma.
No nosso exemplo, foi criado o campo "product_tags", extraído do caminho da imagem anterior. Neste caso, o caminho completo seria RSS>CHANNEL>ITEM>G:PRODUCT_TAGS.
Depois de configurar a sincronização, clique em Ativar para agendar a sincronização ou em Ativar e sincronizar imediatamente para executar uma sincronização e agendar a próxima no período definido.
3. Desativar um tipo de sincronização para ativar outro
Não é possível manter ambos os processos de sincronização ativos ao mesmo tempo, então, se um estiver ativo, será necessário desativá-lo antes de configurar o outro.
Para isso, vá até a aba (1) do tipo de sincronização ativa e, no Painel Principal (2), clique em Desativar.
4. Revisar o Registro de Sincronização
Na aba (1), vá para Registro de Sincronizações.
No Painel Principal (2), você poderá revisar as datas de execução dos processos de sincronização passados, bem como possíveis mudanças de status de cada sincronização.
Independentemente do tempo configurado para a execução da sincronização, o processo de descontinuação de produtos será executado diariamente, portanto, mais processos do que o configurado aparecerão na lista.
Parabéns!
Você chegou ao final da lição.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
-
Onboarding, para adquirir experiência com nossa interface.
-
Workflows iniciais, para implementar suas primeiras estratégias.
-
Integrações com sistemas externos, para conectar-se com Facebook, formulários e webhooks do seu site.
-
Eventos que consomem Atividades, para entender melhor o consumo da sua conta.