Scripts Personalizados e Agente da Loja
Adicione JavaScript da loja e escolha quais Habilidades estão disponíveis em um projeto de loja.
As capturas de tela e as gravações mostram a interface em inglês. Os nomes dos controles podem variar conforme o idioma selecionado.
Scripts Personalizados alteram o comportamento da loja, enquanto Agente da Loja altera quais Habilidades o Runner pode usar para o projeto atual. Ambas são configurações específicas da loja e devem ser revisadas com cuidado extra.
O que este guia cobre
Você será capaz de adicionar e salvar um script, pausá-lo sem deletá-lo e adicionar ou desativar uma Habilidade apenas para o projeto atual.
Disponibilidade e pré-requisitos
- Abra Configurações de dentro do projeto pretendido.
- JavaScript personalizado pode alterar o comportamento da loja. Adicione apenas código que você entenda e confie.
- As ações de Habilidade dependem das Habilidades de espaço de trabalho disponíveis e se uma System Habilidade é configurável.
- A página completa do Agente e o portão de plano ainda controlam a disponibilidade mais ampla de Habilidade.
Caminhos de entrada
- Scripts: Configurações → Loja: nome da loja → Scripts personalizados
- Habilidades do projeto: Configurações → Loja: nome da loja → Agente
Controles de Scripts Personalizados
| Entrada ou botão | Por que é útil | O que acontece a seguir |
|---|---|---|
| Adicionar script | Criar uma entrada de script da loja. | Uma nova linha de Script ativada abre com Código JavaScript vazio. |
| Linha de script | Expanda ou recolha seu editor. | Nome do script e Código JavaScript ficam visíveis. |
| Ícone de olho / olho oculto | Ative ou desative um script. | A linha local muda de estado; selecione Salvar Alterações para aplicá-lo. |
| Ícone de exclusão | Remova um script da lista pendente. | A linha desaparece sem um segundo diálogo; Salvar Alterações aplica a remoção. |
| Salvar Alterações | Aplique cada edição de script pendente. | O Runner salva a lista de scripts completa e mostra uma mensagem de sucesso ou erro. |
O Runner permite até dez entradas de script. O botão Salvar Alterações permanece desativado quando nada mudou.
O editor em branco permite revisar os campos do script antes da instalação. Nenhum script de rastreamento foi salvo neste exemplo.
Adicionar ou alterar um script
- Abra Loja → Scripts Personalizados.
- Selecione Adicionar script.
- Digite um Nome do script claro e Código JavaScript confiável.
- Deixe o script ativado apenas se ele deve ser executado na loja.
- Revise todas as outras linhas porque Salvar Alterações aplica a lista inteira.
- Selecione Salvar Alterações e aguarde Salvo.
- Verifique a loja com segurança após salvar.
O Runner tenta evitar que um erro de script quebre a página, mas isso não torna código desconhecido seguro. Um script ainda pode afetar privacidade, desempenho, rastreamento e experiência do cliente.
Inspecione um rascunho de roteiro primeiro
Para uma primeira olhada, selecione Adicionar script, nomeie-o Store analytics e desligue o controle ocular. Deixe o código vazio e não selecione Salvar Alterações. Isso permite identificar o editor e o estado desativado antes de adicionar código de um provedor confiável. Ao salvar um script real, reabra a lista e verifique seu código e estado ativado.
As anotações em inglês indicam os controles. Selecione a imagem para ampliá-la.
Para habilidades do projeto, escolha Agente no título da loja. Esta imagem mostra a sua entrada; não mostra uma habilidade sendo adicionada ou desativada.
Controles do Agente da Loja
| Entrada ou botão | Por que é útil | O que acontece a seguir |
|---|---|---|
| Linha de Habilidade ativa | Veja qual Habilidade está disponível neste projeto. | A linha mostra nome, descrição e tipo System ou Custom. |
| Desativar | Remova uma Habilidade configurável apenas deste projeto. | A Habilidade sai da lista ativa deste projeto; não é globalmente deletada. |
| Adicionar habilidade | Adicione uma Habilidade de espaço de trabalho disponível a este projeto. | Selecionar uma Habilidade listada a ativa para o projeto atual. |
| Criar habilidade personalizada… | Crie uma nova capacidade personalizada. | O editor de Habilidade abre, depois a lista de projetos é atualizada após o sucesso. |
Configurar Habilidades do Projeto
- Abra Loja → Agente.
- Revise as Habilidades ativas no momento.
- Selecione Adicionar habilidade e escolha uma Habilidade disponível ou Criar habilidade personalizada….
- Aguarde a mensagem de sucesso e confirme que a Habilidade aparece.
- Use Desativar quando uma Habilidade configurável deve parar de se aplicar a este projeto.
- Abra o Agente na navegação do projeto para obter detalhes completos da habilidade, pausar, editar, importar ou excluir ações.
Estados e limites
- As alterações de script permanecem locais até que Salvar Alterações tenha sucesso.
- Remover uma linha de script não tem confirmação separada antes de Salvar Alterações.
- Atingir dez scripts desativa Adicionar script.
- O Agente da Loja pode mostrar carregamento, um erro, Nenhuma habilidade ativada ou a lista ativa.
- System Habilidades fixas não mostram Desativar.
- Desativar no Agente da Loja altera o escopo deste projeto; não deleta ou pausa globalmente a Habilidade.
Solução de problemas
- Se um script ainda for executado, confirme seu estado desativado foi seguido por Salvar Alterações.
- Se Salvar falhar, a lista salva anteriormente permanece inalterada; corrija o código ou tente novamente após o erro.
- Se Adicionar habilidade não tiver entrada esperada, verifique a página completa do Agente e o plano atual.
- Se Desativar estiver ausente, a System Habilidade não é configurável para este projeto.
- Se uma nova Habilidade aparecer globalmente mas não aqui, adicione-a ao projeto a partir do Agente da Loja.