Como funcionam as tags de progresso
Com as tags de progresso ativadas em um curso, cada aluno matriculado nele carrega uma de três tags de cliente do Shopify a partir do momento em que a marcação começa para ele, mantida atualizada automaticamente. As tags são montadas a partir do nome de tag do curso: se o nome for aquarela-101-42, elas serão alva-not-started-aquarela-101-42, alva-in-progress-aquarela-101-42 e alva-completed-aquarela-101-42. Um aluno só é contado em uma das três.
Matriculado não é o mesmo que iniciado. Um cliente que compra o curso e nunca o abre carrega a tag de não iniciado, e normalmente também carrega quem abre uma aula, assiste ao vídeo e sai: uma aula precisa ser marcada como concluída para alguém contar como em andamento. A exceção é um bloco de vídeo do Bunny Stream com Marcar a aula como concluída quando o vídeo terminar ativado. Essa opção fica desligada a menos que você a ative, mas onde ela está ligada, reproduzir o vídeo até o fim marca a aula como concluída e move o aluno para em andamento — vale conferir antes de montar um público de alunos que não assistiram a nada. A tag de concluído chega quando o aluno termina o curso — em um curso que exige nota de aprovação em questionário, isso significa ser aprovado nos questionários obrigatórios além de percorrer as aulas. Até lá, ele continua em andamento.
Passar de um estado para o seguinte é uma troca, e o Alva Courses a faz nesta ordem: a tag nova é adicionada primeiro e a antiga removida logo em seguida. Assim o aluno nunca fica sem nenhuma tag, o que o tiraria dos três segmentos de uma vez. O custo é que ele pode carregar duas por um instante — e, se a remoção não passar, ele fica com as duas até o próximo avanço disparar a troca de novo e limpá-la.
Ativar as tags de progresso
1. Abra as configurações do curso
No admin do Shopify, abra o Alva Courses, clique em Cursos e abra o curso que você quer marcar. Selecione a aba Configurações e role até Tags de progresso.
2. Escolha Ativar tags de progresso
Tags de progresso tem duas opções: Ativar tags de progresso e Desativar tags de progresso. Todo curso começa em Desativar tags de progresso, então escolha Ativar tags de progresso.
3. Defina o nome da tag
O Nome da tag é preenchido para você no momento em que você ativa as tags de progresso. O Alva Courses o monta a partir da URL do curso e coloca o número de ID do curso no fim — um curso em /aquarela-101 com o ID 42 recebe aquarela-101-42 —, o que impede que dois cursos compartilhem uma tag. Mantenha esse nome ou substitua pelo seu: apenas letras minúsculas de a a z, números e hifens, até 40 caracteres, sem vírgulas. Não deixe o campo em branco — um Nome da tag vazio bloqueia o salvamento com Informe um nome de tag antes de salvar. Cada curso que você ativar precisa de um nome de tag que nenhum outro curso ativado já esteja usando. Escolha com cuidado: o nome da tag fica fixo depois de definido.
4. Salve e copie as tags finalizadas
Salve o curso. Tags adicionadas aos clientes passa então a listar as três tags finalizadas ao lado dos rótulos Não iniciado, Em andamento e Concluído. Copie-as dali — uma condição de segmento precisa corresponder exatamente à tag.
Alunos já matriculados não são marcados
Ativar as tags de progresso não marca os alunos que você já tem. A marcação começa daquele momento em diante: o próximo aluno a se matricular, concluir uma aula ou terminar o curso recebe a tag certa. Todos os demais ficam sem tag até fazerem alguma coisa, então um segmento criado na mesma tarde pode parecer vazio.
Esse é o motivo mais comum para as tags de progresso serem relatadas como quebradas, e não há nada de errado — simplesmente ainda não houve atividade nova para marcar. Se você quiser os seus alunos atuais marcados agora, escreva para courses@alvaapps.com informando qual curso: rodamos uma sincronização pontual que lê todas as matrículas atuais e grava a tag correspondente. Não existe um botão para isso no app.
O nome da tag fica fixo depois de definido
O nome da tag não pode ser alterado depois — nem nas configurações do curso, nem em nenhum outro lugar, nem desativando as tags de progresso antes. Renomear deixaria as tags antigas soltas em registros reais de clientes no Shopify, sem nada para limpá-las, enquanto os seus segmentos continuariam correspondendo a uma tag que o Alva Courses não mantém mais. Entre em contato se precisar alterar alguma.
Alterar a URL do curso depois não altera as tags. Elas ficam fixas quando você as configura, então renomear um curso ou movê-lo para um novo endereço deixa os seus segmentos funcionando.
O que saber antes de montar um fluxo
As tags refletem o progresso, não o acesso. Um aluno cujo acesso expirou, ou cujo acesso você revogou, mantém a tag de progresso que tinha — inclusive a de concluído. Um segmento de concluído é uma lista de pessoas que terminaram o curso, não de pessoas que ainda podem abri-lo.
Um curso duplicado começa limpo. A cópia vem com as tags de progresso desativadas e o nome da tag vazio, mesmo que o original tivesse os dois definidos. Dois cursos gravando as mesmas três tags nos mesmos clientes corromperiam os dois segmentos, então dê à cópia um nome de tag próprio ao ativar as tags nela.
O Shopify permite cerca de 250 tags por cliente. Cada curso com as tags de progresso ativadas usa três delas — vale contar se você vende dezenas de cursos para as mesmas pessoas.
O que os alunos veem
Nada. As tags de progresso são gravadas no registro do cliente dentro do admin do Shopify, onde só você e sua equipe as veem. O player do curso continua igual, e aulas, questionários e certificados funcionam exatamente como antes.
Veja também
Isso foi útil?
Última atualização em 2026-08-25