KeystoneKeystone
#Keystone#Fidelidade#Migração#Shopify

Como trocar de app de fidelidade na Shopify sem perder os pontos dos clientes

Exporte os saldos em CSV, importe no novo app antes de desinstalar, confira uma amostra de clientes e anuncie uma única vez. O playbook completo de migração, passo a passo.

By haris.velic

August 25, 2026
7 min read
Como trocar de app de fidelidade na Shopify sem perder os pontos dos clientes

Trocar de app de fidelidade parece arriscado porque o que você está movendo não é uma configuração - é uma promessa. Cada ponto no saldo de um cliente é uma pequena dívida que a sua loja tem com ele e, se a migração zera esses saldos, os clientes percebem na hora e em alto e bom som.

A boa notícia: feita na ordem certa, uma migração de fidelidade é trabalho de planilha, não um salto no escuro. Esta é a versão curta:

  • Exporte o saldo de pontos de cada cliente (e o tier, se você usa níveis) em CSV a partir do app atual.
  • Mapeie os campos - e-mail, pontos, tier - para o formato de importação do novo app.
  • Importe antes de desinstalar. Os dois apps podem ficar instalados ao mesmo tempo; só um deve estar visível.
  • Rode uma janela curta em paralelo para conferir os saldos em contas reais.
  • Comunique uma única vez, depois da virada, não antes e não repetidamente.

Agora o playbook completo, incluindo as partes que costumam dar errado.

Passo 1: levante o que você está migrando de verdade

Antes de exportar qualquer coisa, anote o que o seu programa atual contém. A maioria das lojas migra mais coisas do que imagina:

  • Saldos de pontos por cliente
  • Atribuições de tiers VIP (e o histórico de gastos que gerou cada uma)
  • Indicações pendentes - links compartilhados que ainda não converteram
  • Recompensas emitidas e não resgatadas (cupons de desconto já gerados)
  • Regras do programa: taxas de acúmulo, política de expiração, exclusões

Saldos e tiers migram como dados. Regras migram como configuração que você recria à mão no novo app. Indicações pendentes e recompensas já emitidas normalmente não migram de jeito nenhum - isso você resolve com política, e é o que vemos mais abaixo.

Passo 2: exporte pontos, tiers e clientes em CSV

Todo app de fidelidade sério tem exportação em CSV dos saldos dos clientes - se o seu não tem, fale com o suporte e peça uma antes de cancelar, enquanto você ainda é cliente pagante. No mínimo você precisa de três colunas: e-mail do cliente, saldo de pontos e nome do tier, quando houver.

Exporte em um dia tranquilo e anote o horário. Todo ponto acumulado depois da exportação vai exigir uma segunda exportação delta, menor, logo antes da virada - ou você aceita uma pequena lacuna e credita manualmente o punhado de clientes afetados.

Passo 3: limpe os dados antes de importar

Dez minutos numa planilha evitam a maior parte dos erros de migração:

  • Remova e-mails duplicados. Se o mesmo e-mail aparece duas vezes, some os saldos em uma única linha.
  • Padronize as maiúsculas. Deixe todo e-mail em minúsculas - alguns apps tratam Jane@ e jane@ como clientes diferentes.
  • Tire o ruído inativo. Clientes sem pontos e sem pedidos há dois anos não precisam migrar; uma importação menor é mais fácil de conferir.
  • Confira os totais. Some a coluna de pontos e anote o número. Você vai comparar com ele depois da importação.

Passo 4: importe no novo app antes de desinstalar o antigo

Esta é a regra que salva migrações: nunca desinstale o app antigo antes de os saldos estarem conferidos no novo. Os dois apps podem ficar instalados ao mesmo tempo - basta manter o widget do novo desativado enquanto você importa. Os clientes continuam vendo o programa antigo; você trabalha nos bastidores.

No Keystone, a importação e a exportação de dados estão disponíveis em todos os planos, inclusive no gratuito (em agosto de 2026), então você consegue fazer toda a importação e a conferência antes de pagar qualquer coisa. Suba o CSV, mapeie as colunas de e-mail e pontos e deixe a importação rodar.

Passo 5: confira uma amostra de clientes

Depois de importar, verifique três coisas:

  • O total. A soma dos pontos importados deve bater com o número que você anotou no passo 3.
  • Contas específicas. Escolha dez clientes reais em toda a faixa - um grande comprador, um membro de tier intermediário, alguém com 40 pontos - e confirme cada saldo.
  • A posição no tier. Se você migrou os tiers, confirme que a atribuição veio junto em vez de ser recalculada a partir de um histórico de gastos zerado.

Se uma amostra falhar, corrija o mapeamento e importe de novo. É exatamente para isso que o app antigo continua instalado.

Passo 6: troque os widgets e anuncie uma única vez

A virada cabe em uma noite: desative o widget do app antigo, ative o novo, coloque-o nas mesmas páginas (página de produto, página da conta, cabeçalho se o saldo de pontos aparecia ali) e processe a exportação delta se houver pontos acumulados desde o passo 2. Depois desinstale o app antigo - após uma exportação final guardada como backup - e envie um único e-mail de anúncio.

E as indicações pendentes e as recompensas já emitidas?

Os links de indicação do app antigo morrem na virada - não existe formato portável para eles. A política mais limpa: reconheça qualquer indicação antiga que converta em até 30 dias após a troca creditando os pontos manualmente, e diga isso no seu anúncio. O volume quase sempre é pequeno o bastante para resolver na mão.

Os cupons de desconto já emitidos normalmente ficam na própria Shopify, então continuam funcionando depois que o app de fidelidade que os gerou for removido. Teste um antes da virada para poder afirmar isso com segurança.

Leve a sua política de expiração de forma consciente

Se o programa antigo expirava pontos após 12 meses de inatividade, decida explicitamente o que acontece com os pontos importados: o relógio reinicia na importação ou você respeita as datas originais de acúmulo? Reiniciar o relógio é mais simples e mais generoso - um gesto discreto de boa vontade que custa pouco, já que a maioria dos pontos perto de expirar iria virar quebra de qualquer forma. Configure a regra de expiração do novo app antes da importação, não depois, para que as notificações se comportem corretamente desde o primeiro dia.

O e-mail de anúncio

Um e-mail só, enviado depois da virada, com três frases de conteúdo real: seus pontos estão seguros e já estão no novo programa, este é o seu saldo atual (merge tag) e é isto que há de novo para você - comece por uma vantagem genuinamente melhor, como um limite de resgate mais baixo ou um novo tier VIP. Não explique a troca de fornecedor; o cliente não se importa com qual app roda o programa, apenas com o fato de o saldo dele ter sobrevivido.

Falhas mais comuns

  • E-mails que não batem. A importação cruza pelo e-mail; clientes que fecharam o pedido como visitante com outro endereço não serão conectados. Espere alguns tickets de suporte e resolva com ajustes manuais.
  • Acúmulo dobrado durante a sobreposição. Se os dois apps estiverem no ar e ambos derem pontos nos pedidos, os saldos se descolam. Deixe exatamente um programa acumulando a cada momento.
  • Desinstalar cedo demais. Apagar o app antigo geralmente apaga os dados dele. Exporte primeiro, confira a nova importação, só então desinstale.
  • Migrar num fim de semana de promoção. Volume alto de pedidos durante a virada multiplica o delta que você precisa reconciliar. Escolha a sua semana mais fraca.

Se você preferir não fazer nada disso por conta própria

Todo o playbook acima é exatamente o que uma configuração feita para você cobre. No plano Standard do Keystone ($69/mês em agosto de 2026), nosso time cuida da migração - revisão da exportação, importação, conferência e montagem do widget - como parte do onboarding, e todos os planos, a partir do gratuito, incluem as ferramentas de importação e exportação se você preferir tocar sozinho.


Leitura relacionada

Pronto para trocar? Keystone Loyalty inclui importação e exportação em CSV em todos os planos e tiers VIP por um terço do preço dos apps mais conhecidos - com um caminho de migração feito para você, caso queira que o nosso time conduza a virada.

Frequently Asked Questions

Sim. Exporte os saldos dos clientes em CSV a partir do app atual (e-mail, pontos, tier) e importe esse arquivo no novo app antes de desinstalar o antigo. A maioria dos apps de fidelidade consolidados suporta exportação e importação em CSV; no Keystone, importar e exportar está disponível em todos os planos, inclusive no gratuito, em agosto de 2026.

Sempre depois. Mantenha os dois apps instalados ao mesmo tempo, com apenas o widget antigo visível, importe no novo app, confira os saldos contra os totais da sua exportação e uma amostra de clientes reais, e só então troque os widgets e desinstale. Desinstalar primeiro costuma apagar justamente os dados de que você precisa.

Os links de indicação do app antigo param de funcionar na virada, então a política prática é reconhecer indicações antigas que convertam em cerca de 30 dias creditando os pontos manualmente. Cupons de desconto já emitidos normalmente ficam na própria Shopify e continuam funcionando depois que o app antigo é removido.

O trabalho de dados - exportação, limpeza, importação e conferência - costuma caber em um dia, mais uma janela curta em paralelo antes da virada. Planeje a troca para a sua semana mais fraca, para que o delta entre exportação e virada fique pequeno, ou use uma configuração feita para você, em que o time do app conduz a migração.

Trocar de app de fidelidade sem perder pontos | Keystone for Shopify