A sincronização por Feed de produtos permite automatizar a atualização dos itens do seu catálogo no Connectif a partir de um arquivo XML com as informações dos produtos do seu eCommerce. Esse método realiza uma única requisição para baixar o arquivo, reduzindo a carga do seu servidor web e agilizando a sincronização em comparação com a consulta individual de cada produto.
Neste artigo, você aprenderá como ativar uma sincronização de produtos por Feed.
Tempo de implementação: 30 min.
Dificuldade: Média.
Quando utilizar?: Quando quiser atualizar periodicamente os produtos do seu catálogo Connectif com base nas informações disponíveis nas páginas de produto.
PASSO 1. Acesso à configuração do Product Feed
(Neste passo você acessará a configuração da sincronização via Feed de Produtos).
1. Na sua Loja Connectif, no menu lateral, acesse “Ecommerce > Catálogo”.
2. Clique em Sincronização de produtos.
3. Na aba Product Feed, clique em Configurar.
PASSO 2. Configuração do Feed de Produtos
(Neste passo você adicionará o arquivo de onde o Connectif obterá as informações dos produtos do seu catálogo).
4. Em Adicionar feed de produtos, insira a URL pública do arquivo XML que contém as informações do seu catálogo.
2.1. Especificações do Feed de Produtos
O Feed deve ser um arquivo XML acessível publicamente e utilizar codificação “UTF-8”. Só é possível adicionar um Feed de Produtos, portanto ele deve conter todas as informações que você deseja sincronizar por este método.
No final deste artigo (ou clicando neste link), você encontrará um documento 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 de Feed de Produtos (ou clicando neste link).
Considere as seguintes especificações ao preparar seu Feed:
- Quando o Connectif tenta ler o feed em uma URL, utiliza o cabeçalho 'User-Agent': 'Connectif'. Isso pode ser útil caso seja necessário permitir o acesso ao recurso apenas para determinadas aplicações.
- Pode ser usado o modelo de feed especificado pelo Google. Caso utilize outro formato, apenas será permitido que o elemento "Produto" esteja no segundo nível, ou seja, no máximo o feed conterá três níveis: o que contém a lista de produtos, o próprio item e a(s) propriedade(s) do produto.
- A codificação do feed deve ser UTF-8.
- Campos do Google que o Connectif converte automaticamente (quando o feed respeita integralmente o formato Google):
- G:AUTO_PRICING_MIN_PRICE, G:SALE_PRICE, G:PRICE: são formatados para remover a moeda e tratados como número.
- G:AVAILABILITY: são aceitos os valores permitidos pelo Google 'in_stock', 'in stock' e são transformados em nosso valor válido "instock".
- G:GOOGLE_PRODUCT_CATEGORY, G:PRODUCT_TYPE: os caracteres requeridos pelo Google ">" para separação de categoria são substituídos pelo permitido pelo Connectif "/". Para este campo, o Connectif obterá a definição das categorias do Google.
- Se desejar obter categorias personalizadas com hierarquização própria, isso é possível pelo campo G:PRODUCT_TYPE.
- Para indicar as diferentes categorias que um produto pode ter, deve-se repetir o campo no feed.
- Para indicar os diferentes subníveis de uma categoria, utilizar o valor ">".
- Para mais informações sobre este campo, consulte a documentação oficial do Google Merchant Center.
Por exemplo, um produto com as seguintes categorias personalizadas:
- Primeiro nível:
Bicicleta
Outlet
- Segundo nível:
Bicicleta/Montanha
Bicicleta/Travesia
Outlet/Bici.
- Terceiro nível:
Bicicleta/Montanha/Mil_metros
Deve aparecer no feed da seguinte forma:
<g:product_type>Bicicleta > Montanha > Mil_metros</g:product_type>
<g:product_type>Bicicleta > Travesia</g:product_type>
<g:product_type>Outlet > Bici</g:product_type>
- Os campos que não forem mapeados no feed são respeitados e não são sobrescritos.
- Produtos criados por mecanismos diferentes do feed não são descontinuados.
- Se não utilizar o formato do Google, os dados relativos a preços devem estar em formato numérico.
- Podem ser usadas várias tags com o mesmo nome.
- Quando um campo não autodetectado é mapeado manualmente, o caminho para o campo são os nomes de cada nível da tag até o valor, separados por um ">".
- Todos os campos que em um mapeamento são do tipo "array", se aparecerem várias vezes no Feed, o Connectif coletará todos os valores nesse campo.
Se você usa 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 categorias personalizadas de produto, visite a documentação oficial do Google.
PASSO 3. Configuração da periodicidade da sincronização
(Neste passo você definirá com que frequência e em que horário o Connectif consultará o Feed de Produtos).
8. Em Periodicidade da sincronização, selecione com que frequência deseja que o Connectif revise as páginas de produto do seu catálogo. Você pode escolher:
- “1 dia”.
- “2 dias”.
- “3 dias”.
- “1 semana”.
9. Em Hora, selecione o horário em que deseja que cada processo de sincronização ocorra.
10. Em Personalizar a descontinuação do produto, insira o número de dias que um produto pode estar ausente do Feed antes de passar para o estado “Descontinuado”. Você pode definir um valor entre “1” e “30” dias.
Se não inserir nenhum valor, o Connectif usará “10 dias” por padrão.
11. Clique em Próximo.
PASSO 4. Mapeamento dos campos do Feed
(Neste passo você vinculará os campos detectados no Feed de Produtos com os campos da ficha de produto do Connectif).
12. Em Campos de produto automaticamente detectados, localize os campos do Feed que deseja sincronizar.
A seleção dos campos a mapear é obtida a partir dos campos únicos de uma amostra de produtos do seu Feed.
13. Clique em cada um dos campos e arraste-o para a coluna central para vinculá-lo ao campo correspondente da ficha de produto do Connectif.
O campo mapeado como "Url do produto" é validado com os domínios permitidos.
4.1. Mapeamento manual de campos não detectados
(Se um campo do seu Feed não aparecer entre os valores detectados automaticamente, nesta seção você poderá vinculá-lo inserindo seu caminho manualmente).
12. Selecione o valor “Caminho do campo” e vincule-o ao campo correspondente da ficha de produto do Connectif.
15. Localize no arquivo XML o campo que deseja obter e copie seu caminho completo, incluindo cada um dos níveis desde a tag principal até o campo.
16. Insira o caminho que você obteve do XML separando cada um dos seus níveis pelo símbolo “>”.
Em nosso exemplo, foi criado o campo "product_tags", extraído do caminho da imagem anterior. Nesse caso, o caminho completo seria RSS>CHANNEL>ITEM>G:PRODUCT_TAGS.
PASSO 5. Ativação da sincronização
(Neste passo você ativará a sincronização por Feed de Produtos com a configuração estabelecida).
17. Uma vez determinada a configuração da sincronização, clique em:
- Ativar, para programar a sincronização conforme a periodicidade estabelecida.
- Ativar e sincronizar imediatamente, para executar uma sincronização naquele momento e programar a próxima dentro do período estabelecido.
Com essa configuração, o Connectif sincronizará os produtos via Feed com a periodicidade, descontinuação de produtos e mapeamento que você definiu.
Sucesso!
Sua sincronização de produtos por Feed já está pronta.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
Sincronização massiva de produtos, para conhecer como funciona a sincronização massiva e as diferenças entre Scraping Web e Feed de Produtos.
Métodos de sincronização e verificação de produtos no Connectif, para conhecer as diferentes formas de manter seu catálogo atualizado.
Sincronização de Produtos via Scraping Web, para configurar uma sincronização massiva por Scraping Web.
Sincronização de produtos via API, para importar e atualizar produtos via API do Connectif.