Importação e exportação
Traz membros de outra app de fidelidade com um CSV, ou exporta os teus membros atuais como cópia de segurança. Ambos vivem em Definições, na secção Importação e Exportação de Membros.
Importação e Exportação de Membros
Exportar membros
Clica em Exportar membros em CSV para transferir todos os membros inscritos como um ficheiro CSV. Usa-o como cópia de segurança, para rever saldos numa folha de cálculo, ou como modelo de partida para uma importação — as colunas da exportação são um superconjunto do que o importador lê, por isso um ficheiro exportado pode ser editado e voltar a ser importado tal como está.
Formato CSV
O importador só precisa de três colunas. Quaisquer colunas extra de uma exportação são ignoradas. A linha de cabeçalho é obrigatória e os nomes das colunas não distinguem maiúsculas de minúsculas.
| Coluna | Obrigatória | O que é |
|---|---|---|
email | Sim | O email do membro. Usado para encontrar o cliente Shopify correspondente. |
points | Sim | Um número inteiro ≥ 0. Torna-se o saldo de pontos do membro (e a base dos pontos acumulados). |
tier | Não | Um slug de nível (ex.: gold). Deixa em branco para que sejam os pontos a decidir o nível. |
O valor de tier tem de ser um slug de nível, não o seu nome de apresentação — por exemplo vip-member, não "VIP Member". Uma exportação já usa slugs, por isso os ciclos de ida e volta são seguros.
Um ficheiro de importação mínimo tem este aspeto:
email,points,tier
alice@example.com,1200,gold
bob@example.com,350,silver
carol@example.com,0,O que uma importação faz
Para cada linha cujo email corresponda a um cliente Shopify existente, a importação:
- Inscreve o membro — sem bónus de inscrição, independentemente da tua definição de bónus de inscrição.
- Define os seus pontos com o valor do CSV (isto é uma definição, não uma adição).
- Atribui o nível a partir da coluna
tier, ou apura-o pelos pontos se a coluna estiver em branco. - Data os pontos no dia da importação — por isso, se usares expiração contínua (FIFO), o contador começa do zero a partir do dia em que importas.
A importação é uma substituição total. Para qualquer email que corresponda a um membro existente, a importação sobrepõe o saldo atual e apaga o histórico de pontos anterior (mantido apenas como linhas canceladas para auditoria). Os códigos de desconto já emitidos não são afetados. Isto não pode ser anulado — por isso, para uma migração única, importa antes de os membros começarem a ganhar pontos.
Como funciona a correspondência
Os membros são associados aos clientes Shopify por email. Se um email não tiver um cliente Shopify correspondente, essa linha é ignorada e listada no resultado — a importação nunca cria novos clientes Shopify. Os emails ignorados são apresentados quando a importação termina, para que possas criar esses clientes no Shopify e voltar a correr, se necessário.
Os níveis após a importação
Um nível vindo do CSV é aplicado de imediato. O Gibbond também volta a verificar o nível de cada membro uma vez por dia em relação aos teus limites de nível, por isso um nível é, em última instância, determinado pelos pontos do membro. Se importares um nível para o qual os pontos não se qualificam, será reconciliado para o nível baseado nos pontos na próxima execução diária. Para manter estáveis os níveis importados, certifica-te de que os teus limites de nível estão alinhados com os pontos que importas.
Correr uma importação
As importações correm em segundo plano, por isso podes sair da página enquanto uma está em curso. Um banner de estado mostra o progresso em tempo real e um resumo quando termina (importados, ignorados e quaisquer erros). Depois de os dados serem gravados, o Gibbond atualiza automaticamente o saldo de pontos e o nível de cada membro na loja.
| Limite | Valor |
|---|---|
| Tamanho máximo do ficheiro | 5 MB |
| Máximo de linhas por importação | 10.000 |
| Emails duplicados num ficheiro | Prevalece a última linha de um email |
Voltar a correr o mesmo ficheiro é seguro: como cada importação é uma substituição total, voltar a importar limita-se a reajustar os membros aos valores do ficheiro, em vez de acumular pontos.