태그: 시간 연산자

​

개요

• 장바구니 포기: 특정 시간 후 체크아웃하지 않은 사용자에게 알림
• 이벤트 알림: 예약된 약속이나 갱신 날짜 전에 사용자에게 메시지 전송
• 마일스톤: 사용자가 데드라인까지 액션을 완료하지 않았을 때 후속 조치
• 생일: 사용자의 생일(또는 생일 즈음)에 자동 메시지 전송

​

언제 사용해야 하나요?

• 고정된 달력 시간이 아닌 이벤트에 상대적인 메시지 전송
• 움직이는 시간 윈도우 생성 (예: “24-48시간 후”)
• 다른 날짜를 가진 많은 사용자에 대해 동일한 로직 재사용
• 시간이 지남에 따라 자격을 지속적으로 평가

​

태그 vs 사용자 정의 이벤트

• 사용자에게 마지막으로 알려진 타임스탬프(예: cart_updated_at 또는 subscription_expires_at)를 저장하고 시간이 지남에 따라 해당 값을 기준으로 세그먼트를 나누려는 경우 태그를 사용합니다.
• 각 이벤트 발생(속성 포함)을 기록하고 실시간 행동을 기반으로 여정을 트리거하려는 경우 사용자 정의 이벤트를 사용합니다.

• 정적이고 자주 변경되지 않는 사용자 속성에는 태그
• 실시간 시나리오, 복잡한 세분화, 더 정교한 Journey 워크플로에는 사용자 지정 이벤트

​

빠른 참조

1. 이벤트 날짜를 초 단위 Unix 타임스탬프로 변환합니다.
2. 키가 이벤트 이름이고 값이 타임스탬프를 문자열로 하는 태그를 설정합니다 (예: 'event_date': '1739145600').
3. Time Elapsed Greater Than 연산자를 사용하여 세그먼트를 생성합니다:
   • 과거 날짜 이후의 경우 Time Elapsed Greater Than 연산자와 양수 값 사용
   • 미래 날짜 이전의 경우 Time Elapsed Greater Than 연산자와 음수 값 사용

​

과거 이벤트 후 메시지 전송

1

이벤트 발생 시 타임스탬프 저장

사용자가 장바구니를 업데이트할 때 현재 시간을 Unix 타임스탬프(초 단위)로 저장합니다:

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

초(10자리)를 사용하고 밀리초(13자리)는 사용하지 마세요.

2

세그먼트 생성

1. Audience > Segments로 이동
2. User Tag 필터 추가
3. Key를 cart_updated_at로 설정
4. Time Elapsed Greater Than 선택
5. Value를 1일 (또는 24시간 또는 86400초)로 설정

3

상한선 추가 (권장)

상한선이 없으면 사용자는 영구적으로 세그먼트에 남아 있습니다. 윈도우를 만들기 위해 두 번째 필터를 추가합니다:

• Time Elapsed Greater Than 24시간
• Time Elapsed Less Than 48시간

이제 사용자는 이벤트 후 24-48시간 사이에만 세그먼트에 있습니다.

4

여정에서 세그먼트 사용

메시징을 자동화하기 위해 세그먼트를 타겟팅하는 여정을 생성합니다.

​

미래 이벤트 전 메시지 전송

1. 미래 날짜를 Unix 타임스탬프 태그로 저장합니다 (예: 'future_date': '1739145600')
2. Time Elapsed Greater Than과 원하는 진입 시간을 음수 값으로 하여 세그먼트를 생성합니다
   • 예: -2일 (또는 -172800초)

3. 동일한 Time Elapsed Greater Than 연산자를 사용하여 더 가까운 시간의 음수 값으로 상한선을 추가합니다
   • 예: -1일 (또는 -86400초)

​

예: 생일 메시지

1

다음 생일 타임스탬프 저장

사용자의 다음 다가오는 생일을 계산하고 저장합니다:

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));
}

// 예: 1월 15일 생일
OneSignal.User.addTag("birthday", getNextBirthday(0, 15));

2

생일 세그먼트 생성

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

생일 타임스탬프가 지나면 사용자가 세그먼트에 들어갑니다.

3

반복 여정 설정

1. 생일 세그먼트를 타겟팅하는 여정 생성
2. 사용자가 내년에 재진입할 수 있도록 재진입을 52주로 설정
3. 전송 후 birthday 태그를 내년 날짜로 업데이트 (백엔드 또는 여정에서)

​

FAQ

​

수학은 어떻게 작동하나요? (기술적 세부사항)

time_elapsed = current_time - tag_timestamp

• 과거 타임스탬프 → 양수 값
• 미래 타임스탬프 → 음수 값

• Time Elapsed Greater Than X: elapsed > X일 때 매치
• Time Elapsed Less Than X: elapsed < X일 때 매치

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

​

어떻게 테스트할 수 있나요?

1. 외부 ID, 구독 ID, 이메일 또는 전화번호로 사용자를 찾으세요. 사용자 찾기에 대한 자세한 내용은 테스트 구독 찾기 및 설정을 참조하세요.
2. 현재 날짜와 미래 날짜(지금부터 5분 후)의 초 단위 타임스탬프를 구하세요.
3. 키가 ‘current_time’과 ‘future_time’이고 값이 초 단위 타임스탬프인 두 개의 태그를 설정하세요.
4. 다음 필터로 current_time 세그먼트를 생성하세요:
   • User Tag: current_time Time Elapsed Greater Than: 2분
   • 그리고 User Tag: current_time Time Elapsed Less Than: 5분
5. 다음 필터로 future_time 세그먼트를 생성하세요:
   • User Tag: future_time Time Elapsed Greater Than: -5분
   • 그리고 User Tag: future_time Time Elapsed Less Than: -2분

• 현재 시간 날짜 후 2분에 current_time 세그먼트에 들어가고 현재 시간 날짜 후 5분에 세그먼트에서 나간다.
• 미래 시간 날짜 5분 전에 future_time 세그먼트에 들어가고 미래 시간 날짜 2분 전에 세그먼트에서 나간다.