Campanhas
Entendendo campanhas - as regras que definem seu programa de indicação.
Campanhas
Uma campanha define as regras para seu programa de indicação: como as recompensas são calculadas, períodos de garantia e quais membros participam.
Propriedades da Campanha
| Propriedade | Tipo | Descrição |
|---|---|---|
id | string | Identificador único (UUID) |
name | string | Nome de exibição |
rewardType | enum | percentage ou fixed |
rewardValue | number | Percentual (0-100) ou valor fixo em centavos |
warrantyDays | number | Dias antes do crédito ficar disponível |
isActive | boolean | Se a campanha aceita novas indicações |
minOrderValue | number | Valor mínimo do pedido para gerar recompensa (opcional) |
maxRewardValue | number | Valor máximo da recompensa por indicação (opcional) |
autoRefundFraud | boolean | Estorna automaticamente vendas fraudulentas |
platformConfig | object | Configurações específicas por plataforma (Guru/Yampi) |
Tipos de Recompensa
Baseada em Percentual
O membro recebe uma percentagem do valor do pedido indicado.
{
"reward_type": "percentage",
"reward_value": 10 // 10% do valor do pedido
}Exemplo:
- Valor do pedido: R$200.00
- Recompensa: R$200 × 10% = R$20.00
As recompensas percentuais funcionam bem para valores de pedido variáveis e criam alinhamento entre tamanho do pedido e recompensa.
Valor Fixo
O membro recebe um valor fixo independentemente do valor do pedido.
{
"reward_type": "fixed",
"reward_value": 1500 // R$15.00 fixo
}Exemplo:
- Valor do pedido: R$200.00 → Recompensa: R$15.00
- Valor do pedido: R$50.00 → Recompensa: R$15.00
As recompensas fixas são mais simples de comunicar e orçar. Ótimas para valores de pedido com baixa variância.
Período de Garantia
O período de garantia é um buffer de segurança antes dos créditos ficarem resgatáveis:
| Dias de Garantia | Caso de Uso |
|---|---|
| 0 | Confiança alta, recompensas imediatas |
| 7 | E-commerce padrão (janela de reembolso) |
| 14 | Assinatura primeira mês com garantia |
| 30 | Itens de alto valor, devoluções estendidas |
Se o pedido for reembolsado durante a garantia, o crédito pendente é automaticamente cancelado.
Criando Campanhas
Via Painel
- Navegue para Campanhas → Criar Campanha
- Preencha os detalhes:
- Nome
- Tipo e valor de recompensa
- Período de garantia
- Salve e opcionalmente ative
Campanhas são gerenciadas exclusivamente pelo Painel Administrativo. Acesse Campanhas → Criar Campanha para configurar.
Campanha Padrão
Quando um membro é criado sem especificar uma campanha, o sistema usa a primeira campanha ativa disponível.
Atribuição de Campanha
Os membros são atribuídos a campanhas no momento da criação. Para atribuir um membro a uma campanha específica, passe o campaignId ao criar o membro pelo painel ou via API com autoCreate=true.
Múltiplas Campanhas
Você pode executar múltiplas campanhas simultaneamente para:
| Estratégia | Exemplo |
|---|---|
| Recompensas em Camadas | Regular (10%) vs VIP (15%) |
| Promoções Sazonais | Campanha de feriado com bônus |
| Testes A/B | Comparar percentual vs valor fixo |
| Específica de Produto | Recompensas diferentes por categoria de produto |
Cada membro pertence exatamente a uma campanha. Para mover um membro, atualize seu campaignId.
Análise de Campanha
Rastreie o desempenho da campanha no painel:
- Total de Indicações: Número de indicações bem-sucedidas
- Total de Recompensas Pagas: Soma de todos os créditos
- Taxa de Conversão: Visitantes indicados → Compradores
- Recompensa Média: Recompensa média por indicação
Relacionado
- Membros - Participantes da campanha
- Indicações - Vendas rastreadas
- Referência de API - Endpoints de API