Barra de Pesquisa IA

Visão Geral

A Barra de Pesquisa IA é um widget de pesquisa independente para o seu site. Os visitantes digitam com as próprias palavras e os resultados correspondentes aparecem sob a barra quando eles fazem uma pausa: produtos do seu feed de dados em tempo real como cartões com imagem e preço, e páginas da sua base de conhecimento com título, uma breve prévia e um link. Como pesquisa por significado e não apenas por palavras-chave exatas, um visitante que digita uma descrição ainda encontra o item certo.

Ela usa a mesma base de conhecimento do seu chatbot, então não há nada extra para indexar ou manter. Os dois widgets são independentes: use a barra de pesquisa sozinha, o widget de chat sozinho, ou os dois juntos nas mesmas páginas.

Adicionando ao Seu Site

A barra de pesquisa com IA requer o plano Standard ou superior. Num plano inferior a barra aparece no seu site, mas nunca devolve resultados, por isso verifique primeiro o seu plano se nada acontecer.

O seu ID de widget é apresentado na página Barra de pesquisa com IA do seu painel.

Mais simples: substitua a caixa de pesquisa que já tem

Se o seu site já tem pesquisa - a pesquisa do tema Shopify, um formulário do WordPress ou a sua - não precisa de colocar nada nem editar o tema. Adicione data-replace à etiqueta script e o widget encontra o formulário atual, esconde-o e aparece exatamente no lugar dele:

Este script pode ficar em qualquer sítio da página, por isso serve qualquer plugin que adicione código ao cabeçalho ou ao rodapé. Carregar em Enter sem escolher um resultado continua a abrir a sua antiga página de resultados, por isso nada do que os visitantes conhecem deixa de funcionar. Se a deteção automática escolher o elemento errado num tema invulgar, indique um seletor CSS em vez de auto, por exemplo data-replace=".header-search". Quando nada corresponde, o widget deixa a sua página intacta.

Colocá-la manualmente

Se ainda não tem uma barra de pesquisa, ou a quer num sítio específico, cole as duas linhas onde a barra deve aparecer - por exemplo no cabeçalho, ao lado do logótipo. A barra ocupa a largura do elemento onde a colocar, o que normalmente implica editar um ficheiro do tema.

Se algo não funcionar

• Não aparece nenhuma barra. Verifique se o ID de widget no script corresponde ao da página Barra de pesquisa com IA e se o código está mesmo na página publicada, e não apenas num rascunho ou pré-visualização.
• A barra aparece mas nunca devolve resultados. É quase sempre o plano: a pesquisa funciona a partir do Standard. É também o que vê quando o limite mensal de respostas de IA se esgota.
• Recebe páginas mas nenhum produto. Os produtos vêm de um Real-Time Data Feed. Ligue um na página Barra de pesquisa com IA e verifique se a caixa dessa fonte está marcada.
• Não obtém nada, em pesquisa nenhuma. A sua base de conhecimento pode ainda estar vazia. Rastreie o seu site ou adicione conteúdo no painel primeiro e tente de novo.
• O data-replace não encontrou a sua caixa de pesquisa. Alguns temas escondem a pesquisa atrás de um botão ou de uma janela. Indique um seletor CSS do elemento pretendido em vez de auto e veja a página numa janela normal do navegador, não no editor do tema.

Fontes de Pesquisa

Duas caixas de seleção na página Barra de Pesquisa IA no seu painel controlam o que a pesquisa pode usar: páginas do site (páginas rastreadas e URLs adicionadas) e o seu feed de dados em tempo real. Ambas vêm ativadas por padrão. O feed não se limita a produtos - qualquer coisa que você indexe lá, como artigos ou anúncios, pode aparecer como resultado. Uma alteração se aplica imediatamente no seu site.

Os resultados de produtos precisam de um feed de dados conectado. Ambos os tipos funcionam: o Feed de Dados em Tempo Real a partir do plano Standard e o Feed de Dados em Tempo Real Max no Pro. Sem feed a pesquisa continua a funcionar, apenas devolve só as páginas do seu site, e a página do painel marca o feed como não conectado para saber porque não aparecem produtos.

Análise de pesquisas

A página Barra de Pesquisa IA no seu painel mostra as pesquisas dos últimos 30 dias: quantas foram feitas, quantas não encontraram nada e com que frequência um visitante abriu um resultado. Duas tabelas listam as suas pesquisas mais frequentes e as pesquisas sem resultados. A segunda tabela é a útil, porque mostra exatamente o que os visitantes esperam e não conseguem encontrar.

O registo está ligado por predefinição e pode desligá-lo com uma caixa de seleção na mesma página. Com ele desligado, nenhum texto de pesquisa é guardado e as tabelas deixam de ser atualizadas, enquanto a pesquisa em si continua a funcionar exatamente como antes.

As pesquisas que você faz na página do painel nunca são contadas. Os sites que usam o Modo retenção zero não guardam nenhum texto de pesquisa e, se você definir uma política de retenção, os dados de pesquisa são eliminados no mesmo prazo que as suas conversas.

Como ficam os resultados

Duas definições na página AI Search Bar do seu painel alteram o aspeto da barra e dos resultados. Ambas são guardadas assim que as escolhe e nenhuma exige mexer no código.

Detalhe do resultado de produto

Sob o nome de cada produto, a barra pode mostrar uma linha da descrição do seu feed de dados. Se isso ajuda depende inteiramente do que o feed contém. Um feed de viagens que indica a duração da viagem e os lugares por ocupar vale a pena mostrar. Já um feed com uma lista de atributos lê-se como uma exportação de base de dados.

Portanto a escolha é sua: apenas o nome, uma linha ou duas linhas. Uma linha é a predefinição e serve para a maioria dos feeds, porque chega para distinguir dois produtos parecidos sem sobrecarregar a lista. Isto afeta apenas os resultados de produto - um resultado de página mostra sempre o texto que correspondeu à pesquisa do visitante.

Tamanho da barra

A barra tem três alturas: compacta com 38 pixels para um cabeçalho estreito, a predefinida com 44 pixels, e grande com 52 pixels para uma página construída em torno da pesquisa. O tamanho do texto acompanha.

A largura nunca é definida por nós. A barra preenche sempre o elemento onde a coloca, por isso é o seu layout que controla a largura. O painel de resultados acompanha a barra automaticamente.

Depois de alterar o tamanho, copie novamente o código de incorporação. O novo código leva o tamanho, por isso a barra fica certa assim que a página carrega. Se não voltar a copiá-lo, a barra ainda assim se redimensiona, mas só depois da primeira pesquisa.

Quando uma pesquisa não encontra nada

Se o seu widget de chat estiver na mesma página, a barra de pesquisa oferece passar a pergunta ao seu assistente sempre que uma pesquisa não encontra resultados. O visitante mantém a sua pergunta e chega ao chat com ela já escrita, por isso um beco sem saída torna-se uma conversa. Esta opção só aparece quando o widget de chat está presente.

Opções

A barra de pesquisa usa automaticamente o idioma do navegador do seu visitante para o placeholder, os títulos dos resultados e o texto de carregamento. Defina esses valores apenas se quiser usar as suas próprias palavras.

Os dois títulos também podem ser mudados na página Barra de pesquisa com IA do seu painel, sem alterar código. É o caminho mais fácil se o seu feed tiver artigos ou anúncios em vez de produtos. Um atributo na etiqueta script continua a ter prioridade sobre a definição do painel.

Todos os atributos são opcionais e vão na tag script:

• data-placeholder="Search products..." - texto mostrado na barra de pesquisa vazia
• data-accent="#0a7d4f" - cor de foco e destaque, para combinar com a sua marca
• data-max-results="8" - quantos resultados mostrar, 1 a 20
• data-new-tab="true" - abrir os resultados em uma nova aba do navegador
• data-size="sm" - altura da barra: sm, md ou lg. Prevalece sobre o tamanho definido no seu painel
• data-label-products="Products" - título acima dos resultados do feed, no seu idioma - por exemplo Artigos se o seu feed contém artigos
• data-label-pages="Pages" - título acima dos resultados de páginas, no seu idioma
• data-label-empty="No results found" - mensagem quando nada corresponde
• data-label-searching="Searching..." - texto mostrado enquanto os resultados carregam
• data-label-ask-ai="Ask our assistant" - texto da opção que entrega uma pesquisa sem resultados ao seu chatbot
• data-target=".my-container" - renderiza a barra dentro deste elemento em vez do contêiner padrão
• data-replace="auto" - substitui a barra de pesquisa que o seu tema já tem, descrita acima

Uso e Cobrança

Cada pesquisa feita por um visitante usa 1 resposta da IA do limite mensal do seu plano - o mesmo limite usado pelas respostas do seu chatbot. Uma pesquisa é disparada quando o visitante pausa a digitação, não a cada letra. As pesquisas que você faz na página Barra de Pesquisa IA no seu painel não contam. Quando o seu limite mensal é atingido, a barra de pesquisa simplesmente não mostra resultados até o limite ser redefinido.

Bom Saber

• Os visitantes podem pesquisar em qualquer idioma, mesmo quando o seu conteúdo está escrito em outro.
• Erros de escrita e palavras a meio continuam a encontrar o que interessa, por isso uma pesquisa por jaket encontra os seus casacos.
• Os preços dos produtos são mostrados com o seu símbolo de moeda, retirado da moeda do seu feed.
• A mesma página em vários idiomas aparece uma única vez - vence a versão que corresponde ao idioma da pesquisa.
• Os resultados abrem páginas reais do seu site, então a barra de pesquisa também funciona como navegação.
• O widget é um único script pequeno, sem dependências, e não deixa a sua página mais lenta.
• Os controles de teclado funcionam de imediato: setas para mover, Enter para abrir, Escape para fechar.