Eventos do sistema

Eventos automáticos na plataforma que podem acionar campanhas sem integração personalizada

Eventos do sistema são eventos automáticos disparados pela plataforma Xtremepush, sem nenhum código personalizado de rastreamento de eventos no seu app ou site. Eles podem ser usados como gatilhos de campanha da mesma forma que eventos personalizados.

application_install

Esse evento dispara a primeira vez que um perfil é criado como resultado da instalação e lançamento do seu aplicativo móvel por um dispositivo.

Disponível para: Campanhas de aplicativos móveis (iOS e Android)

Casos de uso:

Notificação push de boas-vindas no primeiro lançamento
Inscrição em campanhas de integração

Esse evento acontece uma vez por perfil, na primeira instalação. Reinstalações no mesmo dispositivo vinculadas a um perfil existente não reiniciam esse evento.

session_start

Esse evento é ativado toda vez que um usuário abre seu aplicativo móvel e inicia uma nova sessão.

Disponível para: Campanhas dentro do aplicativo (apenas iOS e Android, não presencialmente)

Casos de uso:

Campanha de reengajamento desencadeada após um período de inatividade
Mensagem contextual dentro do app mostrada na abertura do app

session_start está disponível como um evento nomeado do sistema no seletor de gatilhos da campanha. Quando selecionado, ele contorna a verificação padrão de validação de eventos (que exige que o evento tenha sido registrado no último ano), já que nenhum registro de evento é armazenado no histórico de eventos para o início da sessão.

profile_create

Esse evento é ativado quando um novo registro de perfil é criado no Xtremepush, normalmente via importação de perfil (CSV ou importação de API).

Casos de uso:

E-mail ou SMS de boas-vindas acionados no momento da criação do perfil durante uma importação de dados
Segmentação inicial ou campanha de entrada no ciclo de vida

profile_create é acionado por importações de perfil, não pela instalação de um aplicativo de dispositivo. Para o comportamento de instalação de aplicativos, use application_install. Nem todos os caminhos de criação de perfis ativam esse evento — ele está especificamente associado ao pipeline de importação.

preference_trigger

Esse evento é ativado quando a preferência de consentimento de um perfil muda, por exemplo, quando um usuário opta por entrar ou não em uma preferência de marketing nomeada.

Este evento está disponível apenas em projetos que tenham as funções de Preferências de Assinatura e Eventos de Preferência de Campanha por Consentimento ativadas.

Casos de uso:

Mensagem de confirmação quando um usuário opta por uma categoria específica de marketing
Lógica de supressão ou reengajamento impulsionada por mudanças de preferência
Fluxo de confirmação com duplo opt-in

Carga útil de eventos

Diferentemente de outros eventos do sistema, preference_trigger carrega uma carga útil estruturada que pode ser usada para condições de filtro de eventos:

{
  "user_id": "u123",
  "customer_id": "c456",
  "preferences": {
    "marketing": [
      {
        "preference_id": 1,
        "name": "marketing",
        "display_name": "Marketing Emails",
        "channel": "email",
        "status": 1,
        "timestamp": 1713100000,
        "source": "manual",
        "metadata": { "channel": "branch" }
      }
    ]
  }
}

Campo	Descrição
`user_id`	O ID de usuário do perfil
`customer_id`	O ID do cliente do perfil (presente apenas se ativado no projeto)
`preferences`	Objeto chaveado pelo nome da preferência. Cada tecla mapeia para um array de registros de mudança de preferência
`preferences[name][].preference_id`	ID da definição de preferência por assinatura
`preferences[name][].name`	Nome de preferência (corresponde à tonalidade externa)
`preferences[name][].display_name`	Rótulo de preferência legível para humanos
`preferences[name][].channel`	Canalizar a preferência aplicada, por exemplo, `email`, `sms`
`preferences[name][].status`	`1` = participou, `0` = desistiu
`preferences[name][].timestamp`	Carimbo de data e hora do Unix de quando a mudança ocorreu
`preferences[name][].source`	Como a mudança foi feita: `manual`, `api`, `import`, etc.
`preferences[name][].metadata`	Metadados arbitrários opcionais anexados ao registro de preferência

Filtragem sobre carga útil de preferência

Quando o disparo de Limite em alguns eventos é ativado para uma preference_trigger campanha, as condições são avaliadas em relação às propriedades de preferência listadas acima. Por exemplo, você só pode acionar uma campanha quando source é manualigual a , ou somente quando channel é emailigual a .

Múltiplas mudanças de preferência para o mesmo perfil são agrupadas em um único evento disparando com um pequeno atraso. Portanto, o preferences objeto pode conter mais de uma entrada de preferência por evento. Quando as condições de filtro de eventos são aplicadas, apenas as entradas de preferência que correspondem às condições são incluídas na carga útil passada para a campanha.

Direcionar uma preferência específica

Uma preference_trigger campanha pode ser direcionada para uma preferência nomeada definindo o campo do evento Trigger para o nome da preferência. Configurá-lo como 0 (ou deixá-lo desconfigurado para "qualquer") acionará mudanças em qualquer preferência.