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

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

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

Período de Garantia

O período de garantia é um buffer de segurança antes dos créditos ficarem resgatáveis:

Dia 0        Dia 7 (garantia = 7)        Dia 30
  │               │                        │
  ▼               ▼                        ▼
┌─────┐      ┌─────────┐           ┌──────────┐
│Pedido│      │ PENDENTE│           │DISPONÍVEL│
│Colocado│────│ Saldo   │───────────│ Saldo    │
└─────┘      └─────────┘           └──────────┘

Se o pedido for reembolsado durante a garantia, o crédito pendente é automaticamente cancelado.

Criando Campanhas

Via Painel

1. Navegue para Campanhas → Criar Campanha
2. Preencha os detalhes:
   • Nome
   • Tipo e valor de recompensa
   • Período de garantia
   • Resgate mínimo (opcional)
3. Salve e opcionalmente ative

Via API

curl -X POST https://api.rafobase.com/v1/campaigns \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Programa de Indicação de Verão",
    "reward_type": "percentage",
    "reward_value": 15,
    "warranty_days": 7,
    "min_redemption": 2000,
    "is_active": true,
    "auto_register": false
  }'

Campanha Padrão

Cada merchant tem uma campanha padrão que é usada quando:

• Um membro é criado sem especificar uma campanha
• O registro automático cria um membro

Defina a padrão em Configurações → Campanhas → Definir como Padrão.

Atribuição de Campanha

Os membros são atribuídos a campanhas no momento da criação:

# Atribua a campanha específica
curl -X POST https://api.rafobase.com/v1/members \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "vip@example.com",
    "name": "Cliente VIP",
    "campaign_id": "camp_vip_xxxxx"  // Campanha VIP com recompensas maiores
  }'

Múltiplas Campanhas

Você pode executar múltiplas campanhas simultaneamente para:

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
• API de Campanhas - Endpoints de API