Keitaro
O plugin Keitaro integra o painel de rastreamento Keitaro à Keoto para enviar postbacks de conversão automaticamente, permitindo acompanhar o ROI de campanhas e fontes de tráfego.
O que é
O Keitaro é uma plataforma de rastreamento de tráfego e conversões usada por afiliados e gestores de tráfego. Com a integração na Keoto, cada venda ou evento é reportado automaticamente ao Keitaro via postback, permitindo atribuição precisa de conversões.
O que faz
- Envia postbacks de conversão automaticamente para o Keitaro a cada evento de venda
- Mapeia status de conversão — vendas aprovadas, leads (pagamentos gerados), rejeições e reembolsos
- Suporta parâmetros UTM — repassa dados de origem do tráfego
- Envia dados do cliente (opcional) — nome, email, telefone
- Suporta SubIDs customizados — configure até 7 SubIDs para segmentação avançada
- Mapeamento de status personalizado — configure quais eventos enviam qual status
Como configurar
1. Acesse o plugin Keitaro
- No painel da Keoto, clique em Plugins no menu lateral
- Selecione Keitaro
- Clique em Criar nova integração
2. Preencha os dados da integração
| Campo | Descrição |
|---|---|
| Nome | Nome identificador da integração |
| URL | URL do postback no seu Keitaro (ex: https://seudominio.com/postback) |
| Token | Token de autenticação (se necessário) |
3. Vincule ao produto
Selecione o produto da Keoto que deve enviar conversões ao Keitaro.
4. Configure as opções avançadas
Envio de dados
| Configuração | Descrição |
|---|---|
| Enviar dados do cliente | Inclui nome, email e telefone no postback |
| Enviar parâmetros UTM | Repassa utm_source, utm_medium, utm_campaign, utm_term e utm_content |
| Enviar ID da transação | Inclui o ID da transação no postback |
Mapeamento de status
Configure qual status enviar ao Keitaro para cada evento:
| Evento na Keoto | Status padrão no Keitaro |
|---|---|
| Venda aprovada | SALE |
| Assinatura renovada | SALE |
| Pix / Boleto / NuPay gerado | LEAD |
| Venda recusada / reembolsada / contestada | REJECTED |
Você pode personalizar o nome do status para cada evento conforme a nomenclatura usada nas suas campanhas.
SubIDs customizados
Configure até 7 SubIDs (sub_id_1 a sub_id_7) para enviar informações adicionais de segmentação junto com o postback.
5. Salve a integração
Clique em Salvar para ativar a integração.
Dados enviados ao Keitaro
A cada evento, os seguintes parâmetros são enviados via query string:
| Parâmetro | Descrição |
|---|---|
subid | ID de rastreamento (obrigatório — vem do checkout) |
status | Status da conversão (SALE, LEAD, REJECTED, ou personalizado) |
payout | Valor da venda em formato decimal |
currency | Moeda (BRL, USD, EUR, etc.) |
fn / ln | Primeiro nome / Sobrenome (se configurado) |
email / phone | Email / Telefone (se configurado) |
tid | ID da transação (se configurado) |
sub_id_1 a sub_id_7 | SubIDs customizados |
utm_source, utm_medium, etc. | Parâmetros UTM (se configurado) |
Importante: O postback só é enviado se o checkout possuir um
subidassociado. Certifique-se de que seus links de tráfego incluem o parâmetro de rastreamento.
Solução de problemas
”Postback não está sendo enviado”
- Verifique se o checkout possui o parâmetro
subid— sem ele, o postback não é disparado - Confirme que a URL do postback está correta
- Verifique nos logs se houve erro na requisição
”Conversão aparece com status incorreto”
- Revise o mapeamento de status nas configurações avançadas
- Verifique se o evento correto está sendo disparado
Precisa de mais ajuda? Entre em contato com nosso suporte.