---
title: "Eventos em tempo real de disparo no Android"
slug: "android-events"
updated: 2026-06-12T10:30:51Z
published: 2026-06-12T10:30:51Z
canonical: "docs.xtremepush.com/android-events"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos em tempo real de disparo no Android

Mensagens dentro do app são acionadas com base em eventos em tempo real dentro do app. Eventos em tempo real também podem ser usados para disparar comunicações, como notificações push, e-mail, SMS e mensagens na caixa de entrada. Este guia descreve como disparar eventos do seu app Android.

## Eventos Personalizados

Se você quiser enviar uma mensagem aos seus clientes após eventos personalizados, deve disparar esses eventos com esse `hitEvent(String title)` método. Por exemplo, se você quiser acompanhar como um evento sempre que um usuário abre a página de configurações, faça da seguinte forma:

```java
mPushConnector.hitEvent("opened_settings");
```

O evento `opened_settings` então estará disponível como uma opção de gatilho ao criar uma mensagem push para Android.

![2256](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/8578a10cd56ea128592352512827563b3048bbe3bec0d49d7533d3f69998e32b-Screenshot_2024-10-10_at_15.33.35(1).png?sv=2026-02-06&spr=https&st=2026-11-04T06%3A16%3A18Z&se=2026-11-04T07%3A16%3A18Z&sr=c&sp=r&sig=d%2BHbhJNOAYlDD%2Fgdf6Vy7FXS8c0JEOn%2FnQ%2FGnnPl95c%3D)

Exemplo de uma campanha push para Android que será desencadeada pelo evento 'opened_settings'.

> [!NOTE]
> Um evento é criado no seu projeto sempre que você o executa pela primeira vez pelo seu app (como visto antes), ou você também pode criá-lo manualmente navegando até **o Gerenciador de Dados > Eventos > Criar evento**.

## Valores de eventos

É possível passar um valor com o evento atingido. Ele pode ser usado para segmentação adicional e personalização das suas mensagens.

Para passar um valor de string com o evento, use:

```java
mPushConnector.hitEvent("test", "payload");
```

Para passar pares chave-valor com o evento usando HashMap:

```java
HashMap <String, String> hm = new HashMap<>();
hm.put("product_category", "Sports");
hm.put("product_name", "Home Jersey");
mPushConnector.hitEvent("product_add_to_basket", hm);
```

Para passar pares-chave-valor com o evento usando JSONObject:

```java
JSONObject jo = new JSONObject();  
jo.put("type","transfer");  
jo.put("amount", 100);
mPushConnector.hitEvent("deposit",jo.toString());
```

## Início da Sessão

Existe um evento padrão para acompanhar o início de sessões ou eventos de abertura do app. Para isso, chame o `setEnableStartSession` método antes de inicializar o Xtremepush na sua atividade principal:

```java
// INITIALISE THE XTREMEPUSH CONNECTOR HERE
mPushConnector = new PushConnector.Builder("XTREME_PUSH_APP_KEY", "GOOGLE_PROJECT_NUMBER")
  .setEnableStartSession(true)
  .create(this);
```

Na [aba Eventos](/documentation/docs/pt-br/campaign-events) , você pode então selecionar o botão de acionar **Início de Sessão** para abrir uma mensagem dentro do aplicativo.

![2248](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/0775e1b26085b07d0a5f149ea5276da47f29ca9089dc11b652897bcf2b1961f3-Screenshot_2024-10-10_at_15.34.36(1).png?sv=2026-02-06&spr=https&st=2026-11-04T06%3A16%3A18Z&se=2026-11-04T07%3A16%3A18Z&sr=c&sp=r&sig=d%2BHbhJNOAYlDD%2Fgdf6Vy7FXS8c0JEOn%2FnQ%2FGnnPl95c%3D)

Exemplo de uma campanha dentro do app acionada no início da sessão.

> [!TIP]
> Apenas mensagens [dentro do app](/documentation/docs/pt-br/quick-start-inapp) podem ser acionadas no **início da sessão**