Esta tarefa mostra como incluir parâmetros UTM em uma notificação push da Inngage Context Cloud — seja em uma campanha ou em um disparo pelo Envio Rápido — para analisar os cliques no GA4 (Google Analytics 4).
Antes de começar
- Tenha o SDK da Inngage integrado ao aplicativo. Sem o SDK, o clique no push não é processado e as UTMs não chegam ao GA4.
- Tenha o GA4 configurado no aplicativo para receber os eventos de clique.
- Defina previamente os valores de UTM que você vai usar (
utm_source,utm_medium,utm_campaign,utm_term), seguindo a mesma convenção de nomenclatura usada nas suas outras campanhas no GA4.
Passos
- Crie a mensagem push pelo fluxo desejado:
- Em uma campanha — ver Como criar uma campanha.
- Em um disparo avulso — ver Como criar e enviar uma campanha com o Envio Rápido.
- Na configuração da mensagem push, localize a área de UTMs.
- Preencha os campos de UTM com os valores de sua preferência (ver a tabela Parâmetros de UTM).
- Conclua a criação da campanha ou o Envio Rápido normalmente.
Os valores de UTM que você definir ficam associados à mensagem e são enviados junto com a notificação push.
Parâmetros de UTM
Todos os valores são definidos pelo cliente. Use a mesma convenção adotada no GA4 para que a análise fique consistente com as demais campanhas.
| Campo | Descrição | Exemplo |
|---|---|---|
utm_source | Origem do tráfego. | app |
utm_medium | Meio ou canal da comunicação. | push |
utm_campaign | Nome da campanha. | promo_julho |
utm_term | Termo associado à campanha. | desconto |
Como as UTMs chegam ao GA4
Por padrão, o SDK da Inngage adiciona os valores de UTM ao evento inngage_notification_click. Esse evento é disparado no clique da notificação push e carrega as UTMs nos seus metadados. No GA4, a análise é feita a partir das UTMs inseridas na mensagem.
Como validar
- Envie a notificação push para uma audiência de teste. Ver Como criar uma audiência de teste para push.
- Clique na notificação no dispositivo.
- No GA4, verifique se o evento de clique foi registrado com os parâmetros de UTM definidos.
Problemas comuns
- O clique na push não aciona o SDK da Inngage → quando o clique não passa pelo SDK, nenhuma função do SDK é executada: deep links e links não são abertos e o callback de clique não é enviado à Context Cloud, o que interrompe a mensuração de CTR → garanta que o tratamento do clique da notificação passe pelo SDK da Inngage, para que ele execute o callback de clique (CTR) e abra os deep links e links.
- O app tem evento próprio de clique no GA4 e não recebe os parâmetros de UTM → o evento de clique próprio do app não está lendo as UTMs do payload da push → use o callback do SDK para capturar os dados de UTM no payload da notificação e repassá-los ao evento de clique do app no GA4.
