Com o Matomo Tag Manager, você exibe o widget ViaSay em todas as páginas do seu site sem modificar o código. Basta uma tag e um acionador. A pessoa responsável pelo Matomo pode fazer isso sozinha, sem um desenvolvedor.
Antes de começar
Uma conta do Matomo que possa criar tags e publicar o contêiner (o espaço que reúne as tags do seu site).
Matomo Tag Manager já instalado no seu site: o código dele é carregado em cada uma das suas páginas.
O código do seu Widget ViaSay, em Build > Integrate > Channels > Integration. Se você ainda não tem um Widget, comece por Criar um Widget ViaSay.
Dica: defina Distribuição do público como 0% durante a configuração. O código é implantado, mas o widget permanece oculto. Depois, exiba-o alterando a porcentagem em Integração, sem tocar no Matomo.
Etapa 1: criar a tag
Uma tag é o código que o Matomo adiciona às suas páginas. Aqui, é o código do widget.
Abra Tag Manager, depois clique em Tags no menu à esquerda.
Clique em Create New Tag.
Escolha o tipo HTML personalizado, na categoria Personalizado. Ele aceita qualquer código, incluindo o script do widget.
Em Nome, digite « Widget ViaSay ».
Em HTML personalizado, cole o código do seu Widget. Deixe Posição para Body End.
O token (o identificador do seu Widget) da captura de tela é fictício: cole o código do seu próprio Widget.
Etapa 2: exibir o widget em todas as páginas
Um acionador (trigger) informa ao Matomo quando iniciar a tag. O acionador Pageview a inicia a cada visualização de página, portanto em todo o site.
Role para baixo até Configure when the tag should do this.
Abra a primeira lista suspensa e escolha Pageview.
Clique em Create New Tag na parte inferior do formulário.
A tag aparece na lista, com o acionador Pageview. Ela ainda não está online: falta testá-la e depois publicá-la.
Etapa 3: testar antes de publicar
O modo de pré-visualização (preview) exibe seu site com a nova tag, visível apenas para você.
Clique em Preview / Debug no menu à esquerda.
Digite o endereço do seu site e clique em Debug. Seu site será aberto em uma nova aba.
No painel do Matomo na parte inferior da página, verifique se Widget ViaSay aparece em Fired Tags.
Clique em Stick to Top se o painel ocultar a parte inferior da página: o widget aparecerá no canto inferior direito.
Etapa 4: publicar
Clique em Publicar no menu à esquerda ou no link Publish a new version now do banner verde.
Digite um nome para a versão, por exemplo, « Widget ViaSay ».
Clique em Create New Version And Publish Release.
Clique em Disable Preview no menu à esquerda para sair do modo de pré-visualização.
Verificar se funciona
Abra seu site em uma janela de navegação privada.
Navegue por algumas páginas: o widget deve ser exibido em cada uma delas.
Você o verá no local definido em Formato e design. Se você definiu Distribuição do público como 0%, ele permanecerá oculto até que você altere a porcentagem.
Se não funcionar
O tipo Custom HTML não é oferecido: o Matomo permite desativar essas tags por segurança. Peça a um administrador para reativá-las em Administration > General Settings.
Widget ViaSay não aparece em Fired Tags: a tag não tem um acionador. Abra-a e refaça a etapa 2.
O painel de depuração não é exibido: adicione ?mtmPreviewMode= seguido do identificador do contêiner ao endereço do seu site. O Matomo o exibe na tela Preview / Debug.
A tag é acionada, mas o widget não aparece: verifique o token colado na tag e a configuração Distribuição do público do seu Widget.
Próximas etapas
Gerenciar a visibilidade do seu widget: escolha as páginas onde ele será exibido.
Aceitação de cookies para a exibição do widget: adapte a exibição ao consentimento dos seus visitantes.
Instalar o Widget com o Google Tag Manager: a mesma instalação com a ferramenta do Google.