Importar os dados do seu programa de indicações
Ao migrar de outra plataforma de indicações para a Advocate, você não está apenas importando dados — você está elevando o potencial do seu programa com rastreamento poderoso, experiências personalizáveis e suporte especializado. Este artigo mostra como:
Por que a migração importa
Como é um plano de migração estratégico
Quais dados podem ser importados
Como preparar seus arquivos
Erros de validação comuns e como evitá-los
Por que planejar uma migração estratégica?
Migrar seu programa de indicações não é apenas uma tarefa técnica — é uma chance de elevar a forma como você engaja e recompensa seus clientes. Uma migração bem planejada ajuda a:
Minimizar interrupções na sua experiência de indicação
Preservar dados históricos e garantir a continuidade das recompensas
Permitir uma transição limpa dos sistemas legados
Reapresentar seu programa de indicações com entusiasmo e clareza
A migração de indicações e recompensas depende da sua capacidade de exportar dados do sistema atual. Sua equipe da Advocate pode informar o que é possível com base nos dados de exportação que você fornecer.
Sua equipe da Advocate trabalhará com você para revisar seus arquivos de exportação, identificar o que é viável e criar um plano que corresponda às necessidades e aos objetivos do seu programa.
O que você precisará fazer
Exportar os dados de usuários, indicações, e recompensas. Entre em contato com seu CSM na antiga plataforma de indicações para obter ajuda ou use uma ferramenta de exportação na própria plataforma, se houver.
Baixe cada um dos 3 relatórios de dados em um arquivo CSV separado, por exemplo,
user_data.CSV,referral_data.CSV, ereward_data.CSV.Veja os exemplos abaixo para ter uma ideia de como o conteúdo de cada arquivo .csv pode ser, ou consulte a referência completa do campo de destino.
Isso inclui e-mails, códigos de indicação, links de compartilhamento , e campos personalizados. Os afiliados devem ser filtrados para evitar recompensas duplicadas.
Depende do formato do link de compartilhamento e do uso de subdomínio personalizado.
O arquivo de Dados do Usuário conterá informações detalhadas sobre cada participante do seu programa. Exporte uma lista de todos os participantes para manter seu programa atualizado com os links de compartilhamento e códigos de indicação deles.
Os seguintes campos são obrigatórios:
ID do Usuário
ID da Conta
Use o e-mail do usuário como seu ID do usuário e ID da conta. As datas devem ser formatadas em milissegundos desde a época Unix. Baixe um exemplo dos campos obrigatórios ou use o exemplo abaixo no .csv formato.
Isso inclui datas de início e conversão, e relacionamentos entre quem indicou e quem foi indicado. Isso permite mapear o desempenho histórico das indicações.
O arquivo de dados de indicações fornece um registro do status de cada conexão de indicação feita no seu programa de indicações.
Os seguintes campos são obrigatórios:
ID do Usuário da Advocate
ID da Conta da Advocate
ID do Usuário Indicado
ID da Conta do Indicado
Use o e-mail do usuário como seu ID do usuário e ID da conta. As datas devem ser formatadas em milissegundos desde a época Unix. Baixe um exemplo dos campos obrigatórios ou use o exemplo abaixo no .csv formato.
Isso inclui valores, datas concedidas/resgatadas, tipos de recompensa e status. Isso permite preservar a credibilidade e a imparcialidade com os usuários.
O arquivo de Dados de Recompensa fornece um registro do histórico de recompensas dos participantes, incluindo seu valor e o valor resgatado gerado por meio do seu programa de indicações.
Os seguintes campos são obrigatórios:
ID do Usuário da Advocate
ID da Conta da Advocate
Nome da Recompensa
Unidade da Recompensa
Valor da recompensa
Data de criação
Data Concedida
Data Resgatada
Valor Resgatado
Use o e-mail do usuário como seu ID do usuário e ID da conta. As datas devem ser formatadas em milissegundos desde a época Unix.
O valor da recompensa é o valor numérico da recompensa em sua menor unidade de medida (por exemplo, para uma recompensa em dinheiro de US$ 1,00, o valor seria 100 centavos). Se a unidade da recompensa for dinheiro, ela deve incluir o código da moeda no seguinte formato <unitName>/<Currency> (Ex.: Dinheiro/USD).
Importante: Se os Data Resgatada e Valor Resgatado campos não forem definidos adequadamente — ou seja, se forem deixados em branco ou contiverem valores incorretos (por exemplo, uma data futura ou um valor resgatado impreciso) — a recompensa poderá ficar disponível para o usuário resgatá-la novamente.
Baixe um exemplo dos campos obrigatórios ou use o exemplo abaixo no .csv formato.
Importante: Os 3 arquivos de exportação devem conter dados de apenas um único programa. Se os arquivos tiverem dados de vários programas, a importação os consolidará em um único programa.
Um plano de migração de exemplo
Toda migração é única, mas as bem-sucedidas seguem uma estrutura semelhante que equilibra preparação, comunicação e execução. Abaixo está um plano de migração que garante continuidade e uma experiência perfeita tanto para sua equipe quanto para seus defensores. Os prazos e as fases podem variar de acordo com a configuração do seu programa.
Fase 1: Planejamento e preparação (1–2 semanas)
Esta é a etapa de definição da base, preparando o terreno para uma transição tranquila.
Metas
• Alinhe as partes interessadas.
• Configuração técnica.
• Confirme o escopo da migração.
• Planeje a comunicação com os usuários.
Tarefas
• Garanta um conjunto de amostra dos seus dados históricos (usuários, indicações, recompensas) e compartilhe com a equipe da Advocate para revisão e mapeamento de campos .
• Exporte conjuntos completos de dados depois que a amostra tiver sido validada. Muito provavelmente, os dados de exportação precisarão ser manipulados (por exemplo, ajustando cabeçalhos, nomes de campos ou a estrutura do arquivo) para atender aos requisitos de importação.
• Defina uma data de lançamento e uma janela de reversão.
• Adicione widgets da Advocate em modo oculto (ambiente de teste ou páginas não vinculadas).
• Configure as integrações necessárias (por exemplo, Shopify, HubSpot, Segment).
• Conclua a configuração do programa na Advocate (por exemplo, configuração de recompensas, regras do programa, modelos de e-mail, segmentação).
• Teste a funcionalidade do programa de ponta a ponta — confirme que compartilhamentos, conversões e recompensas são rastreados corretamente em um ambiente de teste antes de entrar no ar.
• Elabore mensagens para comunicar a transição aos defensores.
A migração de indicações e recompensas depende da sua capacidade de exportar dados do sistema atual. Sua equipe da Advocate pode informar o que é possível com base nos dados de exportação que você fornecer.
Dicas
• Se você estiver sobrepondo plataformas, certifique-se de que apenas uma esteja emitindo recompensas.
• Identifique usuários avançados que possam precisar de um tratamento especial (VIPs, influenciadores).
Fase 2: Corte e entrada no ar (1–2 dias)
Este é o momento da transição. Planeje uma breve pausa no rastreamento entre os sistemas e agende durante horários de menor tráfego, se possível.
Metas
• Faça a transição sem problemas da sua plataforma legada para a Advocate.
• Garanta que os usuários possam acessar a nova experiência imediatamente.
• Evite a perda de dados de indicação ou recompensas.
Tarefas
• Remova os scripts/widgets da plataforma antiga do seu site.
• Coloque os widgets da Advocate no ar.
• Importe os dados finais de usuários, indicações e recompensas.
• Acompanhe/sinalize manualmente quaisquer conversões entre o desligamento do sistema e o lançamento.
• Monitore o painel da Advocate para verificar a atividade.
• Envie a comunicação de lançamento para seus defensores. Avise os usuários de que seus links de indicação foram atualizados e, de preferência, inclua os novos links diretamente no e-mail para facilitar que comecem a compartilhar imediatamente.
Dicas
• Inclua uma pequena margem de bloqueio de recompensas, se necessário (por exemplo, “As indicações feitas em 15 de maio serão analisadas e adicionadas após o lançamento.”).
• Use a comunicação voltada aos defensores para criar entusiasmo (por exemplo, “Aprimoramos sua experiência de indicação!”).
Fase 3: Pós-migração e limpeza (1–2 dias)
Agora que você está no ar, garanta que seu programa esteja funcionando como esperado e resolva quaisquer pendências.
Metas
• Verifique a integridade dos dados e o acompanhamento das recompensas.
• Capture quaisquer conversões perdidas.
• Ofereça suporte e oriente os usuários.
Tarefas
• Valide que os relacionamentos entre quem indica e quem é indicado funcionem no modo ao vivo.
• Importe quaisquer conversões perdidas que ocorreram entre a transição.
• Faça um teste de QA (indique a si mesmo, confirme o rastreamento e a lógica de recompensas).
• Forneça FAQs internas e externas ou documentos de ajuda.
• Monitore a caixa de entrada de suporte para problemas relacionados a usuários legados.
Dicas
• Se você estiver encerrando uma conta legada de financiamento de recompensas, dê aos usuários um período de carência para resgatar.
• Use lembretes por e-mail ou no app para incentivar a atividade inicial de indicação no novo programa.
Importe os dados do seu programa
No menu de navegação à esquerda, selecione
[Engage] → Relatórios → Importações e exportações.No canto superior direito, selecione
Importar.Selecione a Tipo de importação das opções disponíveis:
Tipo de importaçãoDescriçãoUsuários
Selecione esta opção para enviar novos usuários ou dados de usuários existentes. Você também pode optar por importar esses dados de uma conta ou plataforma diferente.
Atualizar saldos de prêmios dos usuários
Selecione esta opção para atualizar e resgatar saldos de recompensas de usuários.
Eventos do Usuário
Selecione esta opção para enviar dados de eventos do usuário.
Excluir Usuários
Selecione esta opção se quiser excluir em massa usuários existentes do seu programa.
Você também pode desativar o tratamento de usuários e optar por:
• Preservar contas vazias
• Impedir que usuários excluídos sejam criados novamente
Histórico de Recompensas
Selecione esta opção para enviar um registro de todas as informações de recompensas. Você também pode optar por importar esses dados de uma conta ou plataforma diferente.
Histórico de Indicações
Selecione esta opção para enviar um registro de todas as conexões de indicação. Você também pode optar por importar esses dados de uma conta ou plataforma diferente.
Selecione Escolher arquivo ou arraste e solte o arquivo que você gostaria de importar.
Selecione Importar para enviar seus dados.
Se estiver excluindo usuários existentes em massa, selecione Exclusão em Massa.
Referência de erros de validação
Você pode receber 3 tipos de erros de validação:
Mensagem de erro inline: essas aparecem na tabela de validação de pré-visualização e fazem com que as linhas com erro sejam destacadas em vermelho:
INVALID_FIELD— por exemplo, o Data de criação campo não foi formatado em milissegundos desde a época Unix .MISSING_FIELD— por exemplo, um campo obrigatório como ID do Usuário ou ID da Conta está ausente.
Chamada de erro: essas aparecem no lugar da tabela de validação de pré-visualização como mensagens de aviso em vermelho:
MISSING_HEADER— por exemplo, um cabeçalho de coluna obrigatório como ID da Conta ou Valor da recompensa está ausente.CSV_PARSING— por exemplo, o arquivo CSV contém caracteres especiais que estão formatados incorretamente.FILE_REF_IO— por exemplo, o arquivo está corrompido e não pode ser lido.
Erros listados: esses aparecem como uma lista de contagens de erros na Importações e Exportações tela dentro da Relatórios seção quando o tipo de importação não tem uma tabela de validação de pré-visualização. Erros de linha e erros de arquivo serão exibidos juntos:
Suporte
Você não precisa navegar pela migração sozinho. Nossa equipe de onboarding da Advocate está pronta para ajudar com:
Suporte ao mapeamento de campos
Orientação sobre formatação de dados
Estratégia de migração de recompensas
Testes e QA
Entre em contato com sua equipe de suporte da Advocate.
Atualizado
Isto foi útil?