Operadores de Tempo

​

Visão geral

• Carrinho abandonado: Lembrar usuários que não finalizaram a compra após um determinado tempo
• Lembretes de eventos: Enviar mensagens para usuários antes de um compromisso agendado ou data de renovação
• Marcos: Fazer follow-up quando usuários não completaram uma ação antes de um prazo
• Aniversários: Enviar mensagens automáticas no (ou próximo ao) aniversário de um usuário

​

Quando devo usar isso?

• Enviar mensagens relativas a um evento, não em um tempo fixo do calendário
• Criar janelas de tempo móveis (por exemplo, “24–48 horas depois”)
• Reutilizar a mesma lógica para muitos usuários com datas diferentes
• Avaliar continuamente a elegibilidade conforme o tempo passa

​

Tags vs Custom Events

• Use Tags quando você quer armazenar o último timestamp conhecido (por exemplo, cart_updated_at ou subscription_expires_at) no usuário e segmentar com base nesse valor ao longo do tempo.
• Use Custom Events quando você quer registrar cada ocorrência de evento (com propriedades) e acionar Journeys com base no comportamento em tempo real.

• Tags para propriedades de usuário que são estáticas e não mudam frequentemente
• Custom Events para cenários em tempo real, segmentação complexa e fluxos de trabalho de jornada mais sofisticados

​

Referência rápida

1. Converta a data do evento para um timestamp Unix em segundos.
2. Defina uma Tag onde a chave é o nome do evento e o valor é o timestamp como string (ex., 'event_date': '1739145600').
3. Crie um segmento usando o operador Time Elapsed Greater Than:
   • Após uma data passada usando o operador Time Elapsed Greater Than com um valor positivo
   • Antes de uma data futura usando o operador Time Elapsed Greater Than com um valor negativo

​

Enviar mensagens após um evento passado

1

Armazenar o timestamp quando o evento acontece

Quando o usuário atualizar seu carrinho, salve o tempo atual como um timestamp Unix (em segundos):

// Exemplo SDK
const timestampSeconds = String(Math.floor(Date.now() / 1000));
OneSignal.User.addTag("cart_updated_at", timestampSeconds);

Use segundos (10 dígitos), não milissegundos (13 dígitos).

2

Criar um segmento

1. Vá para Audience > Segments
2. Adicione um filtro User Tag
3. Defina Key como cart_updated_at
4. Escolha Time Elapsed Greater Than
5. Defina Value como 1 dia (ou 24 horas ou 86400 segundos)

3

Adicionar um limite superior (Recomendado)

Sem um limite superior, os usuários permanecem no segmento para sempre. Adicione um segundo filtro para criar uma janela:

• Time Elapsed Greater Than 24 horas
• Time Elapsed Less Than 48 horas

Agora os usuários estão apenas no segmento entre 24-48 horas após o evento.

4

Usar o segmento em um Journey

Crie um Journey que segmente seu segmento para automatizar as mensagens.

​

Enviar mensagens antes de um evento futuro

1. Armazene a data futura como uma tag de timestamp Unix (ex., 'future_date': '1739145600')
2. Crie um segmento com Time Elapsed Greater Than e seu tempo de entrada desejado como um valor negativo
   • Exemplo: -2 dias (ou -172800 segundos)

3. Adicione um limite superior usando o mesmo operador Time Elapsed Greater Than com um valor negativo de um tempo mais próximo
   • Exemplo: -1 dia (ou -86400 segundos)

​

Exemplo: Mensagens de aniversário

1

Armazenar o timestamp do próximo aniversário

Calcule e armazene o próximo aniversário do usuário:

function getNextBirthday(month, day) {
  // month: 0-11 (Jan=0), day: 1-31
  const now = new Date();
  let birthday = new Date(now.getFullYear(), month, day);

  if (birthday <= now) {
    birthday = new Date(now.getFullYear() + 1, month, day);
  }
  
  return String(Math.floor(birthday.getTime() / 1000));
}

// Exemplo: aniversário em 15 de janeiro
OneSignal.User.addTag("birthday", getNextBirthday(0, 15));

2

Criar um segmento de aniversário

• User Tag: birthday
• Time Elapsed Greater Than: 0 segundos

Os usuários entram no segmento uma vez que seu timestamp de aniversário passa.

3

Configurar um Journey recorrente

1. Crie um Journey direcionado ao seu segmento de aniversário
2. Defina a reentrada para 52 semanas para que os usuários possam reentrar no próximo ano
3. Atualize a tag birthday para a data do próximo ano após o envio (no seu backend ou Journey)

​

FAQ

​

Como funciona a matemática? (detalhes técnicos)

time_elapsed = current_time - tag_timestamp

• Timestamps passados → valores positivos
• Timestamps futuros → valores negativos

• Time Elapsed Greater Than X: corresponde quando elapsed > X
• Time Elapsed Less Than X: corresponde quando elapsed < X

-2,592,000 < 172,800  →  true (corresponde)

​

Como posso testar?

1. Encontre seu usuário via ID Externo, ID de Assinatura, Email ou número de telefone. Veja Encontrar e definir assinaturas de teste para detalhes sobre encontrar seu usuário.
2. Obtenha um timestamp em segundos da data atual e uma data futura (5 minutos a partir de agora).
3. Defina duas tags com as chaves ‘current_time’ e ‘future_time’ e os valores como os timestamps em segundos.
4. Crie um segmento current_time com os seguintes filtros:
   • User Tag: current_time Time Elapsed Greater Than: 2 minutos
   • E User Tag: current_time Time Elapsed Less Than: 5 minutos
5. Crie um segmento future_time com os seguintes filtros:
   • User Tag: future_time Time Elapsed Greater Than: -5 minutos
   • E User Tag: future_time Time Elapsed Less Than: -2 minutos

• Entrar no segmento current_time 2 minutos após a data de tempo atual e sair do segmento 5 minutos após a data de tempo atual.
• Entrar no segmento future_time 5 minutos antes da data de tempo futuro e sair do segmento 2 minutos antes da data de tempo futuro.