Reindexar o catálogo

Quando vale a pena forçar uma indexação completa, por onde se faz, o que custa, e o que fazer quando o botão não chega ao fim.

Na maior parte dos dias não é preciso. O preço e o stock chegam em segundos pelo tempo real, e a sincronização periódica revê o catálogo por sua conta, sem custo nenhum. Este guia é para as vezes em que mudou muita coisa de uma vez e não quer esperar; e como forçar tem um preço, pequeno mas real, convém saber quando é que vale a pena.

Quando vale a pena

• Uma importação grande de produtos, feita por CSV ou direta na base de dados.
• Uma mudança estrutural: renomear categorias, refazer características, mudar a estrutura de combinações.
• Depois de ligar ou desligar a partilha de vendas ou de preço de custo no módulo PrestaShop.
• Depois de mudar os pesos dos campos, se quiser ver o efeito imediatamente em vez de esperar pela reconstrução que a gravação já pediu.

Quando não vale a pena Alterações de preço, de stock e de estado chegam pelo tempo real em segundos. Reindexar por causa disso gasta tempo, gasta bTokens e não muda nada.

O que custa

A regra é uma só, em todas as plataformas:

• A rotina é gratuita. O tempo real, a sincronização periódica, a primeira sincronização de uma loja Shopify e a passagem horária do conteúdo não custam nada: não encostam no limite do plano nem geram excedente.
• Forçar custa 1 bToken por cada 1.000 documentos enviados. Um catálogo de 8.000 produtos custa 8 bTokens; um de 250, custa 1, porque a conta arredonda para cima.

O preço aparece sempre antes de confirmar. No painel, o botão abre uma janela com a estimativa para o catálogo em causa; no módulo PrestaShop, a partir da versão 0.22, o botão mostra o mesmo aviso e só arranca com a confirmação, na primeira indexação como nas seguintes; o comando de linha imprime-o antes de começar. O que se gasta fica visível no gráfico de uso, na linha reindex, para se poder conferir. Ver o plano e os pagamentos.

Onde está o botão

No painel, para qualquer plataforma: em Conta → Lojas, abra a ficha da loja e carregue em Reindexar tudo. É a única via numa loja Shopify, onde não há módulo nenhum: o Buskara vai buscar o catálogo à Shopify e reconstrói os motores por si.

No módulo PrestaShop, na configuração do módulo Buskara, o mesmo botão Reindexar tudo continua a existir, e faz o mesmo: quem tem o catálogo é a loja, e é dela que a exportação parte. Tanto faz carregar num ou noutro; a corrida é a mesma e conta da mesma maneira.

Seja qual for o botão, é na ficha da loja no painel que acompanha o que está a acontecer: Em fila, A indexar… (enviados / total) e por fim Em dia, com o total de documentos.

O que se vê enquanto corre

No módulo PrestaShop, o catálogo sobe em lotes: a página pede um bocado de cada vez, mostra a barra a andar com os itens já enviados, e no fim recarrega com o resultado. É assim porque um pedido único a enviar dezenas de milhares de produtos esbarrava no tempo limite do servidor, e o que aparecia era um Request Timeout sem explicação nenhuma.

Mantenha o separador aberto até ao fim. Se o fechar a meio, o que já subiu fica onde está e o resto entra na indexação seguinte, seja ela outro clique no botão ou a sincronização periódica.

Lançada do painel, a corrida corre do nosso lado, em fila, e não precisa de separador nenhum aberto: pode fechar a página e voltar quando quiser. Numa loja PrestaShop, o painel pede o catálogo à loja pelo mesmo endereço da sincronização periódica, por isso ele tem de estar acessível do exterior; ver como o catálogo é indexado.

Sem browser, por linha de comandos

Para lojas PrestaShop com muitas referências, ou para deixar a correr fora de horas, o módulo traz o mesmo trabalho em linha de comandos:

php modules/buskara/cli/reindex.php

Não tem tempo limite nenhum e não precisa de ninguém à frente do ecrã. Conta como qualquer outra reindexação forçada, e diz o preço antes de arrancar.

O que acontece à pesquisa entretanto

Continua a responder, com o índice anterior. A troca é feita no fim: os visitantes nunca apanham resultados a meio de uma reconstrução, nem um catálogo pela metade.

Se o total não bater certo

Compare o total de documentos do motor com o número de produtos ativos da loja. Uma diferença é quase sempre uma destas: produtos inativos ou não visíveis na loja, a opção produtos sem stock: esconder a fazer exatamente o que lhe pediram, ou uma indexação que ainda não acabou. Numa loja Shopify, contam ainda os rascunhos, os produtos arquivados e os não publicados no canal da loja online, que ficam fora de propósito.

A lista completa das causas, por ordem de probabilidade, está em produtos que não aparecem.