Todo mundo que vende cursos acaba com uma planilha. Ela guarda o que o Shopify não tem onde colocar: em qual turma um aluno está, quem paga a vaga dele, o número de registro que precisa aparecer no certificado, de onde veio a indicação. Ela está correta no dia em que é feita e errada em um mês.
O Alva Courses é um app Shopify para criar e vender cursos online, e as propriedades de contato são o lugar onde essa planilha deveria morar. Este artigo trata do que cabe em uma delas, de como preenchê-las em escala a partir de uma importação de CSV e de como elas voltam na exportação de membros.
Por que a planilha envelhece
Uma planilha paralela não tem ligação nenhuma com aquilo que descreve. Alunos se matriculam, mudam de e-mail, são reembolsados, entram em uma segunda turma — e nada disso chega ao arquivo. Pior: quem mantém a planilha costuma ser quem está mais ocupado, então ela se deteriora mais rápido justamente quando o programa está crescendo.
O registro de cliente do Shopify também não resolve. Ele é construído em torno da compra: nome, endereços, pedidos, tags, estado de marketing. Quem vende cursos precisa de fatos sobre o aluno enquanto aprendiz, e o registro de cliente não tem um campo com esse formato.
As tags são a gambiarra de sempre e são a ferramenta errada para a maior parte disso. Uma tag é um sinalizador, não um valor. Ela pode dizer que um aluno está na turma da primavera; não pode guardar um número de registro, o nome de uma empresa ou uma data, e a loja que tenta acaba com centenas de tags de uso único que ninguém consegue pesquisar.
O que cabe em uma propriedade de contato
Uma propriedade de contato é um valor nomeado guardado em um membro da sua loja. Ela serve para um fato sobre aquela pessoa que você conhece e o Shopify não, e que você vai querer ler depois na página de membro dela ou puxar para uma exportação. É texto livre, então guarda o que o seu programa realmente precisa.
- Turma ou edição — primavera_2026, grupo_marco, aquilo pelo que você separa os alunos ao fazer uma sessão ao vivo.
- Empresa ou patrocinador — quem comprou a vaga, quando o aluno não é o comprador.
- Número de licença ou registro — o identificador que um conselho profissional quer em um registro de educação continuada.
- Origem da indicação — o parceiro, o afiliado ou o evento que trouxe o aluno, guardado por aluno em vez de deduzido de um pedido.
- Detalhe do programa — o nome de um mentor, um número de vaga, uma data de renovação, uma referência de ordem de compra para um aluno faturado.
Duas coisas para deixar de fora. Não duplique o que o Shopify já guarda bem — nome, e-mail, histórico de pedidos —, porque a cópia vai se distanciar do original. E tenha cuidado com dados sensíveis: uma propriedade de contato é um dado pessoal que você escreveu sobre outra pessoa, e está sujeita às mesmas solicitações que todo o resto que você guarda. Dados de alunos e GDPR para quem vende cursos trata desse lado.
Como funcionam as propriedades de contato no Alva Courses
As propriedades de contato ficam na própria página do membro dentro do admin, descritas ali como propriedades personalizadas que você anexa a esse contato. Você adiciona uma propriedade, dá a ela um nome e um valor e salva. Editar e excluir estão no mesmo card. Não há um esquema a definir antes, então uma propriedade nova pode ser inventada no momento em que você precisar.
As regras de nomenclatura e por que elas existem
O nome de uma propriedade usa letras minúsculas, números e sublinhados, entre 3 e 64 caracteres — numero_registro, turma, empresa. A restrição não é decoração. Um nome estável e legível por máquina é o que permite que a mesma propriedade vire um cabeçalho de coluna em uma exportação e uma sugestão na próxima vez que você adicionar uma, em vez de cinco grafias quase idênticas da mesma ideia.
Uma loja pode ter até 100 nomes de propriedade distintos. Esse limite é generoso para um programa de verdade e propositalmente não é ilimitado, porque cada nome é uma coluna em potencial no seu CSV de membros, e uma exportação com mil colunas não ajuda ninguém. No limite, as propriedades existentes continuam editáveis; você só não pode inventar um nome novo até aposentar um.
Alguns nomes são reservados porque o importador de CSV já os usa — email, first_name, last_name e as colunas de curso. Tentar usar um deles é recusado com uma explicação, em vez de aceito em silêncio e depois ignorado na importação.
Elas são só suas
Uma mesma pessoa pode ser cliente de várias lojas que usam o mesmo app. As propriedades de contato são guardadas por loja, então o que você registra sobre um aluno é visível apenas para você — nunca para outro lojista que por acaso tenha o mesmo cliente, e nunca na página de membro dele.
Preenchê-las em escala a partir de uma importação de CSV
Digitar propriedades um membro por vez funciona para uns poucos e é inviável para uma turma. O importador de membros resolve o caso em volume: qualquer coluna do seu CSV que não faça parte da importação padrão de membros é oferecida como propriedade de contato, e você decide coluna a coluna quais manter.
As colunas extras vêm desmarcadas por padrão, então nada é criado sem você saber. Marque uma coluna e ela é importada como propriedade; deixe-a desmarcada e ela é ignorada. É aqui que a planilha finalmente vira dado de verdade em vez de um universo paralelo.
Como os cabeçalhos de planilha são texto corrido, o importador mostra o nome de propriedade que ele propõe para cada coluna antes de salvar qualquer coisa. Uma coluna chamada Número de Registro vira numero_registro, e você vê essa reescrita em vez de descobri-la depois. As colunas que não podem virar um nome válido, ou que colidem com um nome reservado, são explicadas em vez de descartadas em silêncio.
Recuperá-las: exportações
Uma propriedade que ninguém consegue extrair é só uma anotação. Cada propriedade de contato que a sua loja usa está disponível como coluna própria na exportação CSV de membros, ao lado das colunas padrão, então a exportação pode responder à pergunta que a planilha respondia — e desta vez ela é gerada a partir de dados vivos.
O seletor de colunas da exportação separa as colunas de membros das propriedades de contato, então você pode montar um arquivo que seja exatamente o relatório de turma de que precisa, em vez de tudo o que o app sabe. Se você faz o mesmo relatório todo mês, salve a seleção como um conjunto de colunas e reutilize-a, com um conjunto definido como padrão.
Dali o arquivo vai para onde o seu trabalho acontece: um faturamento para uma empresa patrocinadora, uma lista de turma para uma sessão ao vivo, uma prestação de contas de educação continuada que precisa de números de registro ao lado das datas de conclusão. Veja exportar membros para CSV para a exportação em si e propriedades de contato para o detalhe campo a campo.
Colocar uma propriedade no próprio e-mail
Uma exportação conta algo sobre uma turma. Uma variável de mesclagem conta ao aluno algo sobre ele mesmo, que é o ponto em que uma propriedade guardada deixa de ser administração e passa a ser ensino. Cada propriedade que a sua loja usa vira um marcador nos modelos de e-mail do curso, escrito como {contact.sua_chave} e oferecido pelo painel Inserir variável do editor, ao lado dos marcadores padrão de curso e de cliente.
Isso transforma um único e-mail de matrícula no e-mail de matrícula certo para cada edição: cite a turma em que o aluno realmente entrou, o patrocinador que comprou a vaga dele ou o mentor a que ele foi designado, sem manter um modelo separado por grupo. Guarde uma regra — um aluno sem valor salvo naquela propriedade recebe um espaço vazio, e não o texto do marcador —, então escreva a frase de modo que ela sobreviva a um vazio, ou reserve as variáveis de mesclagem para propriedades que todos os alunos realmente têm. Veja editar seus modelos de e-mail.
Um exemplo prático: um programa de certificação
Digamos que você venda um curso credenciado a profissionais que precisam reportar o treinamento a um órgão regulador, e que empresas costumem comprar vagas em blocos. Três propriedades carregam quase toda a carga administrativa desse programa, e nenhuma delas existe em lugar nenhum do Shopify.
- numero_registro — capturado na matrícula, necessário em todo registro de conclusão que você envia.
- turma — a qual edição a pessoa pertence, para que um convite de sessão ao vivo chegue às quarenta pessoas certas.
- empresa — quem está pagando, para que o patrocinador receba um relatório de progresso em vez de pedir um a você.
A empresa manda uma planilha com quarenta funcionários e os números de registro deles. Você importa uma vez, marca duas colunas extras, e cada um desses membros passa a carregar os próprios dados dali em diante. No fim do trimestre, uma exportação filtrada por aquela turma gera o arquivo do órgão regulador e o relatório do patrocinador no mesmo download.
Combine isso com o resto da área de membros e o quadro fica completo: o progresso e a conclusão vêm do próprio curso, um e-mail mensal de progresso mantém os alunos avançando entre as sessões ao vivo, e as propriedades dizem quem cada um deles é para o seu negócio. Se você ainda está desenhando o programa, o checklist de lançamento de curso é onde decidir o que você precisará registrar antes de a primeira turma comprar.
Perguntas frequentes
Uma propriedade de contato é um valor nomeado que você guarda em um membro da sua loja, para um fato sobre aquele aluno que o registro de cliente do Shopify não tem onde guardar. Ela aparece na página do membro dentro do admin e pode ser exportada como coluna própria no CSV de membros.
Qualquer coisa de que o seu programa precise e que já não seja um campo do Shopify: turma ou edição, empresa ou patrocinador, número de licença ou registro, origem da indicação, mentor, número de vaga, data de renovação ou uma referência de ordem de compra. Os valores são texto livre.
Não. A mesma pessoa pode ser cliente de várias lojas que usam o app, e as propriedades de contato são guardadas por loja. O que você registra sobre um aluno é visível apenas na sua página de membro, e nunca na de outro lojista.
Até 100 nomes de propriedade distintos por loja. Os nomes usam letras minúsculas, números e sublinhados e têm entre 3 e 64 caracteres. No limite, as propriedades existentes continuam editáveis e você aposenta um nome antes de adicionar outro.
Sim. Quando você importa membros, qualquer coluna que não faça parte da importação padrão é oferecida como propriedade de contato. As colunas extras vêm desmarcadas por padrão, e o importador mostra o nome de propriedade que ele propõe para cada coluna antes de salvar qualquer coisa.
Sim. Cada propriedade que a sua loja usa está disponível como coluna própria na exportação de membros, listada separadamente das colunas padrão no seletor de colunas. Salve uma seleção como conjunto de colunas para reutilizar o mesmo relatório todo mês.