Eventos padrão

Nota

Disponível a partir do SDK 5.2.2

O que são eventos padrão

Eventos Padrão são interações básicas que os usuários realizam em aplicativos ou sites, independentemente do setor ou funcionalidade. Essas ações-chave do usuário formam o núcleo da comunicação com o cliente e podem ser aproveitadas para qualquer produto e cliente em qualquer estágio do ciclo de vida do cliente.

Os Eventos Padrão estão disponíveis prontos para uso nas versões atualizadas do SDK. Eles não precisam de configurações adicionais, exceto para o PW_InAppPurchase (veja os detalhes abaixo).

Para encontrar e ativar os Eventos Padrão disponíveis no Pushwoosh, siga estes passos:

1. Navegue para a aba Eventos na seção Público.
2. Clique em Criar Evento.
3. Selecione Evento Padrão no menu suspenso.
4. Na janela pop-up, escolha o evento desejado e clique em Ativar.

Uma vez ativados, os Eventos Padrão podem ser usados em mensagens baseadas em comportamento. Por exemplo, use-os como uma Trigger-based Entry em uma Customer Journey ou como um gatilho para mensagens In-App.

Dica

Para ver como você pode usar os Eventos Padrão para criar uma campanha de marketing no Pushwoosh e converter automaticamente usuários gratuitos em clientes pagantes, assista a este tutorial:

Vídeo do Youtube: Como usar Eventos Padrão para criar uma campanha de marketing no Pushwoosh e converter automaticamente usuários gratuitos em clientes pagantes

PW_DeviceRegistered

Este Evento é disparado apenas uma vez para cada dispositivo, no primeiro lançamento do aplicativo e na inicialização do SDK. Como o nome sugere, este Evento rastreia o registro do dispositivo em seu aplicativo.

Casos de uso

• Inicie uma campanha de onboarding para usuários recém-registrados – adicione a Trigger-based Entry usando o Evento PW_DeviceRegistered a uma Customer Journey de Onboarding
• Identifique atividades de aquisição que trazem mais novatos com as estatísticas do Evento
• Engaje os usuários logo na primeira visita: receba-os com In-Apps acionados pelo Evento DeviceRegistered

PW_DeviceUnregistered

Este Evento é disparado quando o aplicativo é desinstalado, ou um usuário opta por não receber e-mails ou notificações push.

Atributos do evento

• message_id (string)
• message_code (string)
• campaign_id (string)

Casos de uso

• Retenha usuários quando eles decidirem parar de usar seu aplicativo. Por exemplo, você pode enviar um e-mail com uma oferta especial para cada usuário que desinstalou o aplicativo
• Mantenha a comunicação com usuários que se descadastraram de um de seus canais. Por exemplo, se um usuário não quiser mais receber notificações push, você pode enviar um e-mail ou mostrar uma in-app incentivando-o a usar o aplicativo com mais frequência

PW_ApplicationOpen

Apenas para aplicativos móveis

O Evento ApplicationOpen é acionado toda vez que um usuário inicia seu aplicativo móvel em seu dispositivo.

Atributos do evento

• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• application_version

Casos de uso

• Colete estatísticas de retenção de usuários com base nas estatísticas do evento ApplicationOpen
• Execute campanhas de mensagens in-app para usuários que estão ativos no aplicativo

PW_ScreenOpen

Apenas para aplicativos móveis

Este Evento é disparado toda vez que um usuário visualiza uma tela específica em seu aplicativo móvel.

Atributos do evento

• application_version
• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• screen_name (nome técnico da tela obtido do seu aplicativo)

Casos de uso

• Envie mensagens perfeitamente relevantes para usuários que demonstraram interesse em seções específicas do aplicativo, iniciando Customer Journeys com o evento PW_ScreenOpen
• Avalie e melhore a eficácia de suas promoções: teste A/B/n duas ou mais versões de sua oferta, espere o evento ScreenOpen ocorrer e veja qual conteúdo teve o melhor desempenho
• Descubra quais telas do aplicativo são mais visitadas: filtre as estatísticas do Evento pelo nome da tela

PW_ApplicationMinimized

Apenas para aplicativos móveis

Este Evento é disparado quando um usuário minimiza (mas não força o fechamento) o aplicativo em seu dispositivo.

Atributos do evento

• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• application_version

Casos de uso

• Rastreie o tempo médio da sessão entre os eventos ApplicationOpen e ApplicationMinimized
• Envie notificações push enquanto o aplicativo está em segundo plano para chamar a atenção dos usuários e trazê-los de volta ao aplicativo

PW_UserIdle

Apenas para aplicativos móveis

Assistência do desenvolvedor necessária

Para começar a receber eventos PW_UserIdle, você precisará da ajuda da sua equipe de desenvolvedores. Compartilhe as notas de configuração do SDK abaixo.

Este Evento é disparado quando um usuário está dentro do seu aplicativo, mas não interagiu com a tela por um período configurável. Diferente do PW_ApplicationMinimized, que é acionado depois que o usuário sai do aplicativo, o PW_UserIdle é disparado enquanto o usuário ainda está no aplicativo — capturando o momento em que a atenção diminui, o usuário hesita ou se distrai. Use-o como um sinal do lado do servidor para mostrar uma In-App oportuna, oferecer assistência ou incentivar o usuário a dar o próximo passo.

A detecção de inatividade está desativada por padrão em ambas as plataformas. Quando a chave de tempo limite está ausente ou definida como 0, nenhum evento PW_UserIdle é enviado. Para ativá-la, defina o tempo limite (mínimo de 30 segundos) na configuração da plataforma do seu aplicativo:

• Para iOS:
  • adicione a chave Pushwoosh_IDLE_TIMEOUT_SECONDS (Número, mínimo 30) ao Info.plist do seu aplicativo.
• Para Android:
  • adicione os metadados com.pushwoosh.idle_timeout_seconds (inteiro, mínimo 30) ao seu AndroidManifest.xml.

Atributos do evento

• screen_name (string) — a tela onde o usuário ficou inativo. Formatado como ActivityName/FragmentName no Android e ParentVC/ChildVC no iOS quando a tela atual está aninhada; caso contrário, o nome da atividade ou do controlador de visualização
• idle_seconds (inteiro) — o tempo limite de inatividade configurado que decorreu
• session_duration (inteiro) — segundos desde que o aplicativo foi trazido para o primeiro plano pela última vez
• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• application_version (string)

Comportamento

• Dispara no máximo uma vez por sessão em primeiro plano. Voltar para o segundo plano e depois para o primeiro plano inicia uma nova sessão.
• O temporizador pausa automaticamente enquanto o teclado virtual está aberto, enquanto um diálogo modal ou prompt do sistema está na tela e enquanto o aplicativo está em segundo plano.
• A interação física com a tela — toques, rolagem e digitação — reinicia o temporizador.

Casos de uso

• Acione uma oferta In-App ou um assistente contextual quando os usuários demorarem em uma tela de alta intenção — carrinho, preços, checkout — sem tomar uma atitude
• Mostre uma dica ou tutorial quando os usuários pararem em uma etapa de onboarding
• Identifique onde os usuários perdem o ímpeto, filtrando as estatísticas de eventos de inatividade por screen_name

PW_ApplicationExit

Apenas para aplicativos móveis

Assistência do desenvolvedor necessária

Para começar a receber eventos PW_ApplicationExit, você precisará da ajuda da sua equipe de desenvolvedores. Compartilhe as notas de configuração do SDK abaixo.

Este Evento é disparado quando um usuário coloca o aplicativo em segundo plano e não retorna dentro de um tempo limite configurável. Diferente do PW_ApplicationMinimized, que é disparado imediatamente quando o usuário sai, o PW_ApplicationExit é disparado somente após o atraso configurado ter decorrido — confirmando que o usuário realmente deixou a sessão em vez de alternar brevemente entre aplicativos. Use-o para reengajar usuários que abandonaram uma sessão no meio do fluxo ou para acionar campanhas de acompanhamento após uma saída confirmada.

A detecção de intenção de saída está desativada por padrão. Para ativá-la, defina o tempo limite (10–30 segundos, valores fora deste intervalo são ajustados automaticamente) na configuração da plataforma do seu aplicativo:

• Para Android:
  • adicione os metadados com.pushwoosh.exit_intent_timeout_seconds (inteiro, 10–30) ao seu AndroidManifest.xml.
• Para iOS:
  • adicione a chave Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (Número, 10–30) ao Info.plist do seu aplicativo.

Atributos do evento

• screen_name (string) — a última tela ativa quando o usuário colocou o aplicativo em segundo plano
• session_duration (inteiro) — segundos desde que o aplicativo foi trazido para o primeiro plano pela última vez
• exit_intent_seconds (inteiro) — o tempo limite efetivo que decorreu antes do evento ser disparado (10–30 s)
• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• application_version (string)

Comportamento

• O temporizador começa quando o aplicativo é colocado em segundo plano e é cancelado se o usuário retornar antes que o tempo limite expire.
• O nome da tela e a duração da sessão são capturados no momento em que o aplicativo é colocado em segundo plano, não quando o evento é disparado.
• O evento não é disparado se a detecção de intenção de saída estiver desativada (a chave de tempo limite é 0 ou não está definida).

Casos de uso

• Reengaje usuários que abandonaram um fluxo de compra ou inscrição — acione uma notificação push ou e-mail com um lembrete ou desconto
• Inicie uma Customer Journey de reconquista para usuários que saem sem completar uma ação-chave (por exemplo, deixando um carrinho ou parando no meio do onboarding)
• Identifique telas com alta taxa de abandono filtrando as estatísticas de eventos por screen_name

PW_SiteOpened

Apenas para plataformas web

O Evento SiteOpened é disparado toda vez que um usuário abre qualquer uma das páginas do seu site.

Atributos do evento

• device_type (código de tipo de dispositivo inteiro, consulte registerDevice para detalhes)
• title – o título da página visitada
• url – URL da página visitada

Casos de uso

• Analise a distribuição do tráfego do seu site e compare o número de vezes que os usuários abrem páginas específicas do site. Para isso, filtre as estatísticas do Evento por seus atributos
• Acompanhe a visita de um usuário ao site com uma comunicação relevante: construa uma jornada começando com o Evento SiteOpened configurado para um atributo ‘title’ ou ‘url’ específico

PW_InAppPurchase

Apenas para aplicativos móveis

Assistência do desenvolvedor necessária

Para configurar o evento de Compra In-App, você precisará da ajuda da sua equipe de desenvolvedores. Compartilhe o guia com eles.

O Evento InAppPurchase é disparado toda vez que um usuário compra um item in-app em seu aplicativo. Exemplos incluem assinaturas pagas, elementos de mecânica de jogo, moeda in-app, etc.

Nota

Lembre-se de que esses itens devem ser especificados na página do seu aplicativo na App Store.

Para implementar o evento de Compra In-App:

• Para iOS:
  • ative o Evento PW_InAppPurchase em seu Painel de Controle;
  • defina o parâmetro Pushwoosh_PURCHASE_TRACKING_ENABLED do SDK do Pushwoosh para iOS como ‘yes’.
• Para Android:
  • ative o Evento PW_InAppPurchase em seu Painel de Controle;
  • configure o envio de informações de compra para o Pushwoosh usando este guia.

Atributos do evento

• productIdentifier (obtido da App Store)
• quantity – o número de itens comprados
• transactionDate – data da compra
• status – status da compra

Casos de uso

• Colete estatísticas de compras in-app
• Execute promoções e acompanhe seu sucesso: defina o evento Aguardar Gatilho (Wait for Trigger) após a mensagem promocional

PW_NotificationOpen

Para plataformas móveis e web

Este Evento é disparado toda vez que um usuário abre uma notificação push enviada com o Pushwoosh.

Casos de uso

• Configure o horário ideal para enviar um push
• Crie Segmentos com base no desempenho das notificações dentro de um período de tempo específico

PW_NotificationSend

Para plataformas móveis e web

Este Evento é disparado uma vez que uma mensagem do Pushwoosh é enviada para o dispositivo de um usuário.

Atributos do evento

• message_id (string)
• message_code (string)
• campaign_id (string)

Casos de uso

• Rastreie se uma mensagem foi enviada, independentemente do canal usado
• Crie Segmentos de usuários com base no número de mensagens enviadas
• Visualize todas as mensagens enviadas a um usuário no histórico de Eventos e analise o comportamento futuro do usuário

PW_EmailLinkClicked

Apenas para a plataforma de e-mail

Este Evento é disparado toda vez que um usuário clica em um link em um e-mail.

Atributos do evento

• message_id (string)
• message_code (string)
• campaign_id (string)
• redirect_link (string)
• original_link (string)

Casos de uso

• Execute campanhas direcionadas para usuários que clicam em um link específico em um e-mail
• Envie outra mensagem para usuários que ignoraram o link no primeiro e-mail para incentivá-los a clicar nele (ou tomar outra ação)

PW_EmailOpen

Este evento é disparado quando um usuário abre um e-mail enviado via Pushwoosh.

Atributos do evento

• campaign_code (string): O código único da campanha associada ao e-mail.
• campaign_id (string): O ID da campanha.
• message_code (string): O identificador único da mensagem de e-mail específica.
• message_id (string): O ID da mensagem

Casos de uso

• Rastreie aberturas de e-mail para identificar usuários que se engajam ativamente com seus e-mails. Use esses dados para criar campanhas de acompanhamento, como enviar códigos de desconto para usuários que abrem e-mails promocionais
• Se os usuários abrirem um e-mail, mas não concluírem a ação desejada (por exemplo, fazer uma compra), você pode acionar e-mails de acompanhamento com lembretes ou ofertas personalizadas
• Analise as taxas de abertura em todas as campanhas para refinar suas linhas de assunto e estratégias de tempo de e-mail para campanhas como lançamentos de produtos ou promoções sazonais

PW_InAppShown

Este evento é disparado quando uma mensagem in-app é exibida para o usuário.

Atributos do evento

• message_code (string): O identificador único da mensagem específica associada à in-app.
• message_id (inteiro): O ID da mensagem
• campaign_code (string): O código único da campanha associada à in-app.
• campaign_id (inteiro): O ID da campanha que acionou a in-app.
• rich_media_code (string): O identificador único do conteúdo de rich media exibido na in-app.
• inapp_code (string): O código único que identifica a mensagem in-app específica mostrada.

Casos de uso

• Rastreie a frequência de visualizações de mensagens in-app para ajustar sua estratégia de mensagens, como remover mensagens redundantes que possam irritar os usuários
• Use dados de impressões in-app para avaliar o alcance de campanhas promocionais como vendas relâmpago ou upgrades de assinatura
• Se uma mensagem in-app for mostrada, mas não clicada, você pode acionar uma ação de acompanhamento, como enviar uma notificação push com conteúdo semelhante para reforçar a mensagem

PW_InAppClicked

Este evento é disparado quando um usuário interage com uma mensagem in-app clicando nela.

Atributos do evento

• message_code (string): O identificador único da mensagem específica associada à in-app.
• message_id (inteiro): O ID da mensagem.
• campaign_code (string): O código único da campanha associada à in-app.
• campaign_id (inteiro): O ID da campanha que acionou a in-app.
• rich_media_code (string): O identificador único do conteúdo de rich media exibido na in-app (se aplicável).
• inapp_code (string): O código único que identifica a mensagem in-app específica clicada.
• element_id (string): O identificador do elemento específico dentro da mensagem in-app que foi clicado (por exemplo, um botão ou link).
• link (string): A URL ou deep link associado ao elemento clicado.

Casos de uso

• Analise o comportamento de cliques para identificar com quais botões ou links os usuários interagem com mais frequência e otimize os designs futuros de mensagens in-app. Por exemplo, teste diferentes CTAs em campanhas de upgrade de assinatura
• Acione ações automatizadas com base nos cliques do usuário, como redirecionar os usuários para uma página de produto específica ou enviar uma notificação push

PW_WhatsAppReceived

Este evento é disparado quando uma mensagem do WhatsApp é recebida através do sistema.

Atributos do evento

• message (string): O conteúdo ou identificador da mensagem do WhatsApp recebida.

Casos de uso

• Automatize ações de acompanhamento em resposta a mensagens recebidas do WhatsApp (como iniciar uma Customer Journey ou rastrear eventos de engajamento do usuário).
• Segmente usuários com base em suas interações com mensagens do WhatsApp para permitir mensagens direcionadas ou campanhas personalizadas.