Importação e exportação
Traga membros de outro app de fidelidade com um CSV ou exporte seus membros atuais como backup. Ambos ficam em Configurações, em Importação e Exportação de Membros.
Importação e Exportação de Membros
Exportando membros
Clique em Exportar membros em CSV para baixar cada membro inscrito como um arquivo CSV. Use-o como backup, para revisar saldos em uma planilha ou como modelo inicial para uma importação — as colunas da exportação são um superconjunto do que o importador lê, então um arquivo exportado pode ser editado e importado de volta como está.
Formato do CSV
O importador precisa de apenas três colunas. Quaisquer colunas extras de uma exportação são ignoradas. A linha de cabeçalho é obrigatória e os nomes das colunas não diferenciam maiúsculas de minúsculas.
| Coluna | Obrigatória | O que é |
|---|---|---|
email | Sim | O e-mail 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 do acumulado). |
tier | Não | Um slug de tier (ex.: gold). Deixe em branco para que os pontos decidam o tier. |
O valor de tier precisa ser um slug de tier, não o nome de exibição — por exemplo vip-member, não "VIP Member". Uma exportação já usa slugs, então as idas e voltas são seguras.
Um arquivo de importação mínimo fica assim:
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 e-mail corresponda a um cliente Shopify existente, a importação:
- Inscreve o membro — sem bônus de inscrição, independentemente da sua configuração de bônus de inscrição.
- Define os pontos dele com o valor do CSV (isto é uma definição, não uma adição).
- Atribui o tier a partir da coluna
tierou o deduz dos pontos se a coluna estiver em branco. - Data os pontos no dia da importação — então, se você usa expiração contínua (FIFO), o relógio recomeça do zero a partir do dia em que você importa.
A importação é uma substituição total. Para qualquer e-mail que corresponda a um membro existente, a importação sobrescreve 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. Isso não pode ser desfeito — então, para uma migração única, importe antes que os membros comecem a acumular pontos.
Como a correspondência funciona
Os membros são correspondidos aos clientes Shopify pelo e-mail. Se um e-mail não tiver um cliente Shopify correspondente, essa linha é ignorada e listada no resultado — a importação nunca cria novos clientes Shopify. Os e-mails ignorados são exibidos quando a importação termina, para que você possa criar esses clientes no Shopify e executar novamente se necessário.
Tiers após a importação
Um tier vindo do CSV é aplicado imediatamente. O Gibbond também reavalia o tier de cada membro uma vez por dia em relação aos seus limites de tier, então o tier é, em última instância, definido pelos pontos do membro. Se você importar um tier para o qual os pontos não qualificam, ele será conciliado ao tier baseado em pontos na próxima execução diária. Para manter os tiers importados estáveis, verifique se os limites dos seus tiers estão alinhados com os pontos que você importa.
Executando uma importação
As importações rodam em segundo plano, então você pode sair da página enquanto uma estiver em andamento. Um banner de status mostra o progresso em tempo real e um resumo quando termina (importados, ignorados e eventuais erros). Depois que os dados são gravados, o Gibbond atualiza automaticamente o saldo de pontos e o tier de cada membro na vitrine.
| Limite | Valor |
|---|---|
| Tamanho máximo do arquivo | 5 MB |
| Máximo de linhas por importação | 10.000 |
| E-mails duplicados em um arquivo | A última linha de um e-mail prevalece |
Executar o mesmo arquivo novamente é seguro: como cada importação é uma substituição total, importar de novo apenas reajusta os membros para os valores do arquivo, em vez de acumular pontos.