# Eventos personalizados

Ao contrário dos [eventos padrão](/pt/product/audience-data-and-segmentation/events/default-events), que são universais em muitos aplicativos e setores, os eventos personalizados são específicos para o seu aplicativo. Esses eventos rastreiam ações específicas únicas para suas necessidades, como concluir um treino ou estender uma assinatura. Eles ajudam você a entender como os usuários interagem com seus recursos específicos. Além disso, eles fornecem insights mais profundos sobre o comportamento do usuário, ajudam a [rastrear a retenção](/pt/product/statistics-and-analytics/user-retention-statistics) e permitem a criação de campanhas de marketing altamente personalizadas e eficazes. Isso, em última análise, melhora o engajamento e a satisfação do usuário.

Se um evento personalizado contiver dados de receita (por exemplo, `order_completed` com um atributo de preço), você pode mapeá-lo como uma fonte para [eventos de Conversão](/pt/product/audience-data-and-segmentation/events/conversion-events/) sem adicionar novo código.

## Criando eventos personalizados

Para criar um evento personalizado no Pushwoosh:

1. Vá para **Audience > Events** e clique em **Create Event**. No menu suspenso que aparece, selecione **Custom Event**.

<img src="/events-custom-events-1.webp" alt="Menu suspenso Criar Evento mostrando a opção Evento Personalizado"/>

2. Na janela que se abre, insira o nome do seu evento no campo **Event Name**. Por exemplo, use level\_completed para rastrear quando um usuário completa um nível de jogo. Forneça uma breve descrição do evento no campo **Description**. Isso ajuda a identificar rapidamente o propósito do evento.

<img src="/events-custom-events-2.webp" alt="Formulário de criação de evento personalizado com os campos Nome do Evento e Descrição"/>

3. Defina os atributos específicos relevantes para o seu evento e selecione o tipo de atributo. Atributos de evento são informações específicas que descrevem os detalhes de um evento. Eles capturam vários aspectos da interação de um usuário dentro do seu aplicativo. Isso fornece dados valiosos para segmentação e direcionamento preciso de mensagens. Você pode adicionar até 50 atributos a um evento.

Tipos de atributos disponíveis:

* **integer**
* **string**
* **boolean**
* **list**
* **decimal (price)**
* **date**

Para detalhes sobre os tipos de atributos, consulte [Entendendo eventos](/pt/product/audience-data-and-segmentation/events/#2-set-attributes).

<img src="/events-custom-events-3.webp" alt="Configuração de atributos de evento mostrando tipos e campos de atributos"/>

Para cada evento que ocorre, haverá valores de atributos correspondentes. Por exemplo, os atributos para o evento **level\_completed** podem incluir **level\_number, completion\_time, score,** ou **points\_earned**. Quando o evento é registrado no Pushwoosh, ele incluirá esses valores de atributos junto com um carimbo de data/hora. Esses dados podem ser usados posteriormente para construir segmentos, direcionar mensagens e coletar estatísticas.

Depois de preencher os detalhes necessários e adicionar atributos, clique em **Create** para finalizar a configuração do evento. Se decidir não prosseguir com a criação do evento, clique em **Cancel** para descartar as alterações.

<Aside type="caution" icon="setting" title="Assistência de desenvolvedor necessária">
  Depois de configurar um evento personalizado no Control Panel, você precisará da ajuda de sua equipe de desenvolvimento para integrá-lo ao seu aplicativo. Compartilhe com eles o código de integração que você pode encontrar ao lado do evento que criou, juntamente com [este link](/pt/developer/guides/audience-and-segmentation/events#custom-events-implementation) para obter instruções.
</Aside>

## Gerenciando eventos personalizados

A lista de eventos fornece uma visão geral de todos os eventos personalizados que você criou para sua aplicação. Cada evento ajuda a rastrear interações ou comportamentos específicos do usuário.

**Detalhes do Evento**

* **Event Name** que identifica o evento (por exemplo, "button\_clicked", "video\_watched")
* **Attributes** ou informações chave associadas ao evento, fornecendo contexto adicional (por exemplo, "button\_id", "video\_category")
* **7-Day Activity** - o número de vezes que o evento ocorreu nos últimos sete dias, oferecendo uma visão rápida do engajamento recente

<img src="/events-custom-events-4.webp" alt="Lista de eventos personalizados mostrando detalhes do evento e opções de gerenciamento"/>

Cada evento possui um menu para gerenciamento adicional:

* Clique em **View Code** para acessar o trecho de código necessário para integrar este evento na base de código do seu aplicativo.
* Clique em **Event Statistics** para aprofundar nas estatísticas detalhadas do evento escolhido, fornecendo insights sobre o comportamento do usuário.
* Clique em **Edit Event** para modificar as configurações de um evento, incluindo seu nome e atributos associados, para garantir a coleta de dados precisa.

<img src="/events-custom-events-6.webp" alt="Menu de gerenciamento de eventos com as opções Ver Código, Estatísticas do Evento e Editar Evento"/>

## Usando eventos personalizados no Pushwoosh

Depois de configurar seus eventos, você pode usá-los para:

1. [Criar uma jornada do cliente](/pt/product/customer-journey/create-a-customer-journey-for-your-project) que será lançada no seu evento personalizado, usando o elemento [**Trigger-based entry**](/pt/product/customer-journey/journey-elements#trigger-based-entry).
2. [Construir segmentos por eventos](/pt/product/audience-data-and-segmentation/segmentation/create-segments/by-events/), incluindo filtragem por valores de atributos de eventos e operadores.
3. Segmentar usuários por critérios como quantas vezes eles realizaram um evento personalizado ou quando o evento ocorreu pela última vez. Use esses segmentos para configurar [Audience-based entries](/pt/product/customer-journey/journey-elements/#audience-based-entry) para jornadas do cliente ou use a opção [Segment Split](/pt/product/customer-journey/journey-elements#segment-split) dentro da jornada.
4. Definir um [atraso de tempo em sua jornada do cliente](/pt/product/customer-journey/journey-elements#delay-based-on-user-or-event-data) com base no evento personalizado que os usuários acionam em sua jornada.
5. Usar o evento personalizado na etapa [Wait for Trigger](/pt/product/customer-journey/journey-elements#wait-for-trigger) para definir diferentes cenários de comunicação com base em se um usuário aciona este evento específico ou vários eventos dentro de um tempo especificado.

## Casos de uso de eventos personalizados

| Tipo de App                      | Evento Personalizado      | Descrição                                                         | Caso de Uso                                                                                                                                                                                                                                                                               |
| ----------------------------- | ----------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Apps de Fitness e Saúde       | workout\_complete | Um usuário completa uma sessão de treino.                                 | Envie mensagens motivacionais ou recompensas para manter os usuários engajados e incentivar treinos regulares.                                                                                                                                                                                            |
| Apps de E-commerce               | cart\_abandoned   | Um usuário adiciona itens ao carrinho, mas não conclui a compra. | <p>Envie um e-mail de lembrete ou notificação push com uma oferta especial ou desconto nos itens deixados no carrinho.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-e-commerce">Explore eventos recomendados para apps de e-commerce</a></p> |
| Apps de Educação e e-Learning | complete\_course  | Um usuário completa um curso.                                          | Envie mensagens de parabenização e recomende cursos avançados ou tópicos relacionados.                                                                                                                                                                                                         |
| Apps de Mídia e entretenimento  | watch\_video      | Um usuário assiste a um vídeo.                                             | <p>Envie notificações sobre conteúdo semelhante ou novos lançamentos. Recomende outros vídeos.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-media">Explore eventos recomendados para apps de mídia</a></p>                                    |
| Apps de Viagem e hospitalidade   | book\_flight      | Um usuário reserva um voo.                                              | Envie lembretes de viagem, dicas de bagagem e recomendações de atividades no destino.                                                                                                                                                                                          |
| Apps de Assinatura             | start\_trial      | Um usuário inicia um teste gratuito.                                         | <p>Envie mensagens de integração com dicas, ofereça assistência e destaque os principais recursos.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-subscription-management">Explore eventos recomendados para apps de assinatura</a></p>           |
| Apps de Mobilidade ou carsharing   | ride\_completed   | Um usuário completa uma corrida de carsharing.                                 | Envie uma mensagem in-app de acompanhamento, solicite feedback ou ofereça um desconto na próxima corrida.                                                                                                                                                                                               |
| Apps de Jogos                   | level\_completed  | Um usuário completa um nível de jogo.                                      | <p>Envie mensagens de parabenização e ofereça dicas ou recompensas para completar o próximo nível. </p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-gaming-apps">Explore eventos recomendados para apps de jogos</a></p>                        |

## Rastreando eventos personalizados

#### Estatísticas de eventos

Você pode rastrear cada evento que criou. Para isso:

1. Navegue até **Audience > Events**.
2. Na lista de **Events**, encontre o evento que deseja rastrear e clique nos três pontos ao lado dele. Selecione **Event Statistics**.
3. Defina o intervalo de datas para o qual deseja analisar os dados do evento.
4. Refine a análise de dados do evento adicionando condições ou filtros específicos com base em atributos como segmentos de usuários, tipos de dispositivos ou outros critérios personalizados.
5. Veja um gráfico que visualiza a frequência com que o evento selecionado foi acionado durante o intervalo de datas especificado.
6. Você também pode exportar os dados do evento para um arquivo CSV para análise ou relatórios adicionais.

<img src="/events-custom-events-7.webp" alt="Painel de estatísticas de eventos mostrando gráfico de frequência e opções de exportação de dados"/>

Para atualizar os dados do evento exibidos no painel, clique no botão **Refresh**.

#### Painéis

O Pushwoosh também permite que você rastreie eventos personalizados usando o painel de Eventos, que contém estatísticas relacionadas aos eventos usados em suas campanhas, ou construindo seu próprio painel personalizado. [Saiba mais](/pt/product/statistics-and-analytics/dashboards/)

#### Aba de Retenção

Use a aba **Retention** para rastrear a retenção relacionada a eventos específicos relevantes para o seu negócio. [Saiba mais](/pt/product/statistics-and-analytics/user-retention-statistics)