Importar os Dados do Seu Programa de Indicação
Ao migrar de outra plataforma de indicação para o Advocate, você não está apenas importando dados — está elevando o potencial do seu programa com rastreamento poderoso, experiências personalizáveis e suporte especializado. Este artigo guia você por:
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ção não é apenas uma tarefa técnica — é uma oportunidade para aprimorar como você engaja e recompensa seus clientes. Uma migração bem planejada ajuda a:
Minimizar a interrupção na experiência de indicação
Preservar dados históricos e garantir continuidade das recompensas
Permitir uma ruptura limpa com sistemas legados
Reapresentar seu programa de indicação com entusiasmo e clareza
A migração de indicações e recompensas depende da sua capacidade de exportar dados do seu sistema atual. Sua equipe Advocate pode informar o que é possível com base nos dados de exportação que você fornecer.
Sua equipe 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 objetivos do seu programa.
O que você precisará fazer
Exporte o dados de usuário, dados de indicação, e dados de recompensa. Entre em contato com seu CSM na sua antiga plataforma de indicação para obter assistência ou use uma ferramenta de exportação dentro da plataforma, se ela for fornecida.
Faça o download de 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 como o conteúdo de cada arquivo .csv pode ser, ou consulte a referência completa do campo Destination.
Isto inclui e-mails, códigos de indicação, links para compartilhar , e campos personalizados. Afiliados devem ser excluídos para evitar recompensas duplicadas.
Dependendo do formato do sharelink 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 seus links de compartilhamento e códigos de indicação.
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 epoch unix. Faça o download de um exemplo dos campos obrigatórios ou utilize o exemplo abaixo em .csv formato.
Isto inclui datas de início e conversão, e relações entre quem indicou e quem foi indicado. Suporta mapear desempenho histórico de indicações.
O arquivo de dados de indicação fornece um registro do status de cada conexão de indicação feita no seu programa de indicação.
Os seguintes campos são obrigatórios:
ID do Usuário Advocate
ID da Conta Advocate
ID do Usuário Indicado
ID da Conta Indicada
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 epoch unix. Faça o download de um exemplo dos campos obrigatórios ou utilize o exemplo abaixo em .csv formato.
Isto inclui valores, datas de concedido/resgatado, tipos de recompensa e status. Permite preservar credibilidade e justiça com os usuários.
O arquivo de Dados de Recompensa fornece um registro do histórico de recompensas dos participantes, incluindo seu valor e valor resgatado gerado através do seu programa de indicação.
Os seguintes campos são obrigatórios:
ID do Usuário Advocate
ID da Conta 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 epoch 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 $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.: Cash/USD).
Importante: Se os Data Resgatada e Valor Resgatado campos não forem definidos adequadamente — ou seja, estiverem em branco ou contiverem valores incorretos (por exemplo, uma data futura ou um valor resgatado impreciso) — a recompensa pode ficar disponível para o usuário resgatar novamente.
Faça o download de um exemplo dos campos obrigatórios ou utilize o exemplo abaixo em .csv formato.
Importante: Todos os 3 arquivos de exportação devem conter dados de um único programa apenas. 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
Cada 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. Cronogramas e fases podem variar dependendo da configuração do seu programa.
Fase 1: Planejamento e preparação (1–2 semanas)
Esta é a fase de estabelecimento de base, preparando o terreno para uma transição suave.
Metas
• Alinhar stakeholders.
• Configuração técnica.
• Confirmar o escopo da migração.
• Planejar 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 Advocate para revisão e mapeamento de campos .
• Exporte conjuntos de dados completos assim que a amostra tiver sido validada. Os dados de exportação provavelmente precisarão ser manipulados (por exemplo, ajuste de cabeçalhos, nomes de campos ou estrutura de arquivos) para corresponder aos requisitos de importação.
• Defina uma data de lançamento e uma janela de rollback.
• Adicionar widgets do Advocate em modo oculto (ambiente de teste ou páginas não vinculadas).
• Configurar integrações necessárias (por exemplo, Shopify, HubSpot, Segment).
• Completar a configuração do programa no Advocate (por exemplo, configuração de recompensas, regras do programa, modelos de e-mail, segmentação).
• Testar a funcionalidade do programa de ponta a ponta — confirme que compartilhamentos, conversões e recompensas sejam rastreados corretamente em um ambiente de teste antes de entrar no ar.
• Redigir mensagens para comunicar a transição aos defensores.
A migração de indicação e recompensas depende da sua capacidade de exportar dados do seu sistema atual. Sua equipe 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 poderosos que possam necessitar de tratamento especial (VIPs, influenciadores).
Fase 2: Corte e lançamento (1–2 dias)
Este é o seu momento de transição. Planeje uma breve pausa no rastreamento entre sistemas e agende durante horas de baixo tráfego, se possível.
Metas
• Trocar perfeitamente da sua plataforma legada para o Advocate.
• Garantir que os usuários possam acessar a nova experiência imediatamente.
• Evitar perda de dados de indicação ou recompensas.
Tarefas
• Remover scripts/widgets da plataforma antiga do seu site.
• Colocar widgets do Advocate no ar.
• Importar os dados finais de usuários, indicações e recompensas.
• Rastrear/manualmente sinalizar quaisquer conversões entre o desligamento do sistema e o lançamento.
• Monitorar o painel do Advocate para atividade.
• Enviar comunicação de lançamento aos seus defensores. Informe os usuários que seus links de indicação foram atualizados e, idealmente, inclua os novos links diretamente no e-mail para facilitar que eles comecem a compartilhar imediatamente.
Dicas
• Incluir um breve período de suspensão de recompensas se necessário (por exemplo, “Indicações feitas em 15 de maio serão revisadas e adicionadas após o lançamento.”).
• Usar comunicação voltada aos defensores para criar entusiasmo (por exemplo, “Atualizamos sua experiência de indicação!”).
Fase 3: Pós-migração e limpeza (1–2 dias)
Agora que você está no ar, certifique-se de que seu programa esteja funcionando conforme o esperado e resolva quaisquer pendências.
Metas
• Verificar integridade dos dados e rastreamento de recompensas.
• Capturar quaisquer conversões perdidas.
• Suportar e educar os usuários.
Tarefas
• Validar que as relações entre quem indicou e quem foi indicado funcionem em modo ao vivo.
• Importar quaisquer conversões perdidas que ocorreram durante o corte.
• Realizar um teste de QA (indique a si mesmo, confirme rastreamento e lógica de recompensas).
• Fornecer FAQs internas e externas ou documentos de ajuda.
• Monitorar a caixa de entrada de suporte para problemas relacionados a usuários legados.
Dicas
• Se você estiver encerrando uma conta de financiamento de recompensas legada, dê aos usuários um período de carência para resgatar.
• Use lembretes por e-mail ou in-app para incentivar atividade inicial de indicações no novo programa.
Importe os dados do seu programa
No menu de navegação à esquerda, selecione
[Engage] → Reporting → Imports & Exports.No canto superior direito, selecione
Importar.Selecione o Tipo de Importação das opções disponíveis:
Tipo de ImportaçãoDescriçãoUsuários
Selecione esta opção para carregar 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 Recompensa do Usuário
Selecione esta opção para atualizar e resgatar saldos de recompensas dos usuários.
Eventos do Usuário
Selecione esta opção para carregar 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 excluir o manuseio 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 carregar 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 carregar 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 em massa usuários existentes, selecione Exclusão em Massa.
Referência de erro de validação
Você pode receber 3 tipos de erros de validação:
Mensagem de erro inline: estas aparecem na tabela de validação de pré-visualização e fazem com que linhas com erros sejam destacadas em vermelho:
CAMPO_INVALIDO— por exemplo, o Data de Criação campo não foi formatado em milissegundos desde a epoch unix .CAMPO_FALTANDO— por exemplo, um campo obrigatório como ID do Usuário ou ID da Conta está faltando.
Alerta de erro: estes aparecem no lugar da tabela de validação de pré-visualização como mensagens de aviso em vermelho:
CABECALHO_FALTANDO— por exemplo, um cabeçalho de coluna obrigatório como ID da Conta ou Valor da Recompensa está faltando.ANALISE_CSV— por exemplo, o arquivo CSV contém caracteres especiais que estão formatados incorretamente.ARQ_REF_IO— por exemplo, o arquivo está corrompido e não pode ser lido.
Erros listados: estes aparecem como uma lista de contagens de erro na tela Imports & Exports dentro da seção Reporting 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 do Advocate está pronta para ajudar com:
Suporte de mapeamento de campos
Orientação sobre formatação de dados
Estratégia de migração de recompensas
Testes e QA
Contate seu time de suporte Advocate.
Atualizado
Isto foi útil?