Dados do usuário

Eventos de clientes para segmentação por comportamento

Registre o que um cliente acabou de fazer — subir de nível, um pagamento, uma semana de silêncio — no exato momento em que acontece. As jornadas reagem em tempo real, e os segmentos podem perguntar com que frequência e há quanto tempo, não só o que é verdade agora.

Painel de criação de eventos do Control Panel com os tipos de atributo abertos, mostrando Integer, String, Date e Price ao lado de uma lista de eventos existentes

Alguns fatos são um momento, não um número

Saber o nível atual de um cliente é um fato. Saber que ele cancelou uma assinatura há uma hora é outro tipo de fato. Aconteceu num momento específico, e vale a pena reagir naquele momento, e não no próximo envio programado.

É para isso que serve um evento. Uma tag te diz o que é verdade sobre alguém agora. Um evento te diz o que ele acabou de fazer.

O que um evento pode guardar

Você descreve um evento uma vez só: o nome, os dados que ele carrega. Depois, envia toda vez que acontece, pelo SDK ou pela API. A partir daí, ele alimenta triggers de jornada e filtros de segmento a partir do mesmo registro.

Eventos padrãoEventos personalizados
OrigemNativos: PW_InAppPurchase, Log out, Payment method changed e outros eventos documentadosDefinidos por conta, no Control Panel ou via API createEvent
AtributosAté 100, tipadosAté 100, tipados
TiposInteger, String, List, Date, Boolean, PriceOs mesmos 6 tipos. Sem tipo Version, diferente das tags
RetençãoDefinida por tipo de eventoDefinida por tipo de evento
1 / 4
Origem
Eventos padrão
Nativos: PW_InAppPurchase, Log out, Payment method changed e outros eventos documentados
Eventos personalizados
Definidos por conta, no Control Panel ou via API createEvent
2 / 4
Atributos
Eventos padrão
Até 100, tipados
Eventos personalizados
Até 100, tipados
3 / 4
Tipos
Eventos padrão
Integer, String, List, Date, Boolean, Price
Eventos personalizados
Os mesmos 6 tipos. Sem tipo Version, diferente das tags
4 / 4
Retenção
Eventos padrão
Definida por tipo de evento
Eventos personalizados
Definida por tipo de evento

Conecte receita e retenção direto ao evento

Um atributo do tipo Price combinado com a flag trackRevenue conecta o evento direto ao relatório de receita. A retenção é definida por tipo de evento, em vez de uma única vez para a conta inteira: um evento de pagamento pode ficar registrado por um ano, enquanto um evento de engajamento de baixo valor expira em um mês.

Com que frequência, e há quanto tempo

Um perfil construído só com o estado atual te diz quem alguém é. Não te diz o que acabou de acontecer com ele. A segmentação por comportamento que só filtra por “verdadeiro agora” não distingue o cliente que fez algo três vezes essa semana daquele que fez uma vez, seis meses atrás.

Os eventos permitem que um segmento pergunte com que frequência e há quanto tempo, e diga “não fez X há 14 dias” com a mesma precisão de “fez X”. É isso que torna um perfil de cliente unificado útil de verdade.

Como funciona

  1. Defina o evento, se você quiser ter controle sobre ele

    No Control Panel (Audience → Events → Create Event) ou via API createEvent: nome, descrição, até 100 atributos tipados, uma flag trackRevenue opcional, e uma janela de retenção. Se pular essa etapa, o postEvent cria o evento no primeiro envio, com os tipos de atributo inferidos a partir do payload.

  2. Envie a partir do seu app

    No exato momento em que acontece, pelo postEvent do SDK (iOS, Android, Web) ou pelo endpoint REST /postEvent.

  3. Use

    Como filtro de segmento (contagem mais janela de tempo), como trigger de entrada em jornada, ou como condição de ramificação no canvas.

As etapas um e três são no-code, no Control Panel. A etapa dois precisa de um desenvolvedor para adicionar a chamada do SDK ou da API.

Um evento, lido por três funcionalidades diferentes

Um evento disparado no checkout pode puxar alguém para uma jornada de recuperação via entrada por trigger, ramificar essa jornada pelo próprio atributo de valor do carrinho do evento via Condition Split, e marcar a jornada como sucesso via metas de conversão. Três produtos, lendo o mesmo evento no momento em que ele chega.

Construído para alimentar o resto da plataforma

A entrada por trigger lê um evento para iniciar uma jornada. O Condition Split lê seus atributos para direcionar uma ramificação. As metas de conversão o leem para fechar uma jornada como ganha. Um evento, três funções, sem redefinir nada.

Para que servem os eventos

UsoVerticaisO que dispara
Jornadas reativasE-commerce, FinTech, Food deliveryCarrinho abandonado, transação grande, status de entrega: a jornada reage na mesma sessão
Segmentos de frequência e recênciaQualquer"Fez X três vezes ou mais em 30 dias" ou "não fez X há 14 dias"
Eventos atribuídos a receitaE-commerce, FinTechAtributo Price mais trackRevenue, conectado direto ao relatório de receita
Escalas de retenção e inatividadeE-commerce, Food deliveryinactivity_7, inactivity_30, d7_retention: reativação gradual em vez de uma única flag
Uso
1 / 4
Jornadas reativas
Verticais
E-commerce, FinTech, Food delivery
O que dispara
Carrinho abandonado, transação grande, status de entrega: a jornada reage na mesma sessão
Uso
2 / 4
Segmentos de frequência e recência
Verticais
Qualquer
O que dispara
"Fez X três vezes ou mais em 30 dias" ou "não fez X há 14 dias"
Uso
3 / 4
Eventos atribuídos a receita
Verticais
E-commerce, FinTech
O que dispara
Atributo Price mais trackRevenue, conectado direto ao relatório de receita
Uso
4 / 4
Escalas de retenção e inatividade
Verticais
E-commerce, Food delivery
O que dispara
inactivity_7, inactivity_30, d7_retention: reativação gradual em vez de uma única flag

Como saber que está funcionando

As estatísticas de Events & Tags mostram quantas vezes cada evento disparou, e para quantos usuários únicos, na janela de tempo que você escolher. É a visão para checar antes de confiar numa jornada ou segmento construído sobre um evento que você acabou de adicionar.

O que ter em mente

Algumas coisas que vale a pena checar antes de construir em cima de um evento.

  • Envie um evento que ainda não está definido, e o postEvent cria ele e infere os tipos de atributo. Defina primeiro se você quiser um tipo específico, trackRevenue, ou uma janela de retenção diferente dos valores inferidos por padrão.
  • Até 100 atributos por evento, nome de atributo com até 255 caracteres.
  • Sem tipo de atributo Version. Eventos carregam 6 tipos, tags carregam 7.
  • Sem limite publicado de quantos tipos de evento distintos uma conta pode definir.

Transforme o que seus clientes fazem no que acontece a seguir

Uma tag te diz quem alguém é. Um evento te diz o que ele acabou de fazer, e é exatamente isso que uma jornada ou um segmento pode acionar no mesmo momento em que acontece.