Ctrlk
Integration DocsContact SupportLog In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Criar recompensas em dinheiro em massa com o Advocate

Embora muitas recompensas sejam acionadas automaticamente pelas regras do programa (como uma conversão de indicação), às vezes você pode precisar recompensar participantes por ações manuais ou offline — como concluir uma pesquisa ou vencer um concurso.

A Recompensas em massa a ferramenta de importação permite que você emita dinheiro, pontos ou cartões-presente para vários defensores de uma vez, enviando um arquivo CSV. Este recurso inclui um mecanismo de segurança de execução de teste para garantir que seus dados estejam corretos antes de quaisquer fundos serem desembolsados.

Prepare seu arquivo de importação

Observação: Se você usar as configurações globais de importação, então você só precisará enviar um userId lista.

Para começar, você precisará de um arquivo CSV ou JSONL contendo a lista de usuários que deseja recompensar.

  • Colunas obrigatórias: Seu arquivo deve incluir no mínimo userId para identificar o usuário.

  • Colunas opcionais: Você pode incluir detalhes da recompensa (por exemplo, valor, unidade, tipo) no arquivo. Como alternativa, recomendamos definir isso como padrões globais na plataforma durante o processo de importação para simplificar seu arquivo.

Referência de colunas do arquivo

userId

O ID exclusivo do usuário.

Obrigatório

assignedCreditInCurrencyBaseUnit

O valor a ser recompensado (ex.: 50).

Condicional (Não obrigatório se um padrão global estiver definido)

rewardUnit

A unidade da recompensa (ex.: USD, POINTS).

Condicional (Não obrigatório se um padrão global estiver definido)

globalRewardKey

A chave de uma recompensa pré-configurada a ser concedida.

Condicional (Não obrigatório se um padrão global estiver definido)

discountPercent

O valor a ser recompensado como um desconto

Condicional (Não obrigatório se um padrão global estiver definido)

dateScheduledFor

Adie a recompensa até esta data.

Opcional

uniqueId

Um identificador exclusivo para a transação.

Recomendado Usado como uma chave de segurança para evitar recompensas duplicadas se o arquivo for executado novamente.

customerNote

Adicione uma observação que ficará visível para o cliente.

Opcional

internalNote

Adicione uma observação para uso interno que o cliente não poderá ver.

Opcional

1

Configure as configurações de importação

  1. No menu de navegação à esquerda, selecione [Engage] → Relatórios → Importações e exportações.

  2. No canto superior direito, selecione Importar.

  3. Em Tipo de importação, selecione Recompensas.

Definir valores predefinidos (padrões globais)

Para economizar tempo e reduzir erros no seu arquivo CSV, você pode definir valores predefinidos que se aplicam a todas as linhas da sua importação.

  • Recompensa: Escolha uma recompensa pré-configurada ou especifique uma unidade manual (por exemplo, "Cash/USD").

  • Programa: Associe essas recompensas a um programa específico para fins de relatórios.

  • Duração da recompensa pendente: [Ativar] para adicionar uma margem de segurança (por exemplo, 30 dias) antes que a recompensa fique disponível para o usuário. Isso permite tempo para reversões, se necessário.

Observação: Se você definir um valor aqui (por exemplo, Unidade da recompensa: USD), você não precisa incluir essa coluna no seu arquivo CSV.

2

Enviar e executar teste

Como as recompensas em dinheiro são finais e não podem ser revertidas, o sistema exige uma execução de teste (importação de teste) para que você possa revisar os detalhes com confiança antes de processar as recompensas.

  1. Em Envie seu arquivo CSV ou JSONL de usuários para importação selecionar Escolher arquivo.

  2. Selecione Executar importação de teste para iniciar o estado de teste.

  3. O sistema processará o arquivo sem criar recompensas.

3

Revisar e finalizar

Quando a execução de teste for concluída, você verá uma entrada de status na lista de Importações e exportações. E-mails podem ser enviados como parte do processo de revisão (cartões-presente, configuração de pagamento etc.).

  1. Revisão: Se houver erros (indicados com [Exclaimation]), selecione Baixar relatório de erros para corrigir seu arquivo e tentar novamente. Além disso, selecione Baixar relatório para obter um registro de todas as recompensas que serão criadas. Com ou sem erro, isso é recomendado para revisão.

  2. Confirmar: Se o teste for bem-sucedido (indicado com um [Checkmark]), selecione Executar importação.

  3. Um modal de confirmação aparecerá resumindo o impacto total (por exemplo, “Ao executar esta importação, 412 recompensas serão criadas”). Selecione Executar importação para confirmar e desembolsar as recompensas.

Se você decidir não prosseguir, basta cancelar a execução e, em seguida, selecionar Descartar para excluir a execução de teste.

AnteriorExplicação sobre opções de recompensas do programaPróximoExplicação sobre recompensas em cartão-presente

Atualizado

Isto foi útil?