Tipos de conversão: papel, modo new/repeated e receita
Os tipos que vêm prontos (conversao, lead, venda), o que papel, modo e receita controlam, quando criar tipos novos e como eles se relacionam com os destinos de conversão.
Cada postback carrega um tipo (tipo=venda, tipo=lead). O tipo decide se a conversão conta receita, quantas vezes um clique pode gerar aquele evento e como ele é traduzido para a Meta e o Google.
A tabela fica em Rastreio de conversão › Tipos de conversão, com as colunas Tipo, Papel, Modo, Receita.
Os tipos que vêm prontos
| Tipo (slug) | Papel | Modo | Receita |
|---|---|---|---|
conversao | Purchase | new | sim |
lead | Lead | new | não |
venda | Purchase | new | sim |
conversao e venda são equivalentes — dois nomes para o evento de compra, para acomodar plataformas que mandam um ou outro. Um postback sem tipo cai no tipo padrão do workspace.
Os três atributos
Papel — o significado do evento para os destinos de conversão. É o nome que a Meta e o Google entendem: Lead, Purchase, Schedule, CompleteRegistration, AddToCart, InitiateCheckout, Subscribe, Contact, ViewContent… Quando a conversão é devolvida para a plataforma, é o papel que vai como nome do evento — não o slug. Assim você pode chamar o tipo de agendamento e a Meta receber Schedule.
Modo — quantas conversões daquele tipo um mesmo clique pode ter:
new— uma por clique. A segunda viraduplicate. É o modo para venda única, lead, cadastro, primeiro depósito.repeated— várias por clique, cada uma comtxiddiferente. É o modo para upsell, order bump, recorrência, recompra. Semtxiddistinto, repetições ainda são deduplicadas.
Receita — se o payout do postback entra na receita do painel. sim para compras; não para lead, cadastro e eventos intermediários, que aparecem em Conversões mas não inflam EPC e ROI.
Criar um tipo novo
+ Novo tipo na mesma tabela, ou POST /api/conversion-types com slug, role, mode e counts_revenue.
Exemplos que costumam fazer sentido:
| Slug | Papel | Modo | Receita | Uso |
|---|---|---|---|---|
agendamento | Schedule | new | não | Clínicas, serviços |
cadastro | CompleteRegistration | new | não | Apps, plataformas |
ftd | Purchase | new | sim | Primeiro depósito (iGaming) |
deposito | Purchase | repeated | sim | Depósitos seguintes |
upsell | Purchase | repeated | sim | Ofertas pós-compra |
assinatura | Subscribe | new | sim | Primeira cobrança |
renovacao | Subscribe | repeated | sim | Cobranças seguintes |
O slug é o que vai em tipo= no postback. Use minúsculas, sem acento.
Como o tipo é resolvido
- O parâmetro
tipo(ou aliasestype,event,event_type,goal) do postback. - Se a campanha tem Merchant, as regras dele podem sobrescrever — por exemplo,
status=approved&tipo=vendavira SALE,status=pending&tipo=cadastrovira LEAD. - Se o slug não existe na tabela, a conversão é gravada com o slug recebido mas sem papel — ela não é devolvida para os destinos. Crie o tipo (ou corrija o postback) para que isso não aconteça.
Tipos e destinos
Nos destinos de conversão, o mapa de eventos liga cada tipo a um evento da plataforma. Por padrão o papel já faz essa ligação (venda → Purchase), mas o mapa permite exceções — mandar lead como Contact para a Meta, por exemplo. Veja Destinos de conversão.
Excluir um tipo
Excluir um tipo não apaga conversões antigas dele; apenas impede novas. Postbacks que chegarem com aquele slug passam a ser gravados sem papel.