세션 추적

Braze SDK를 통해 세션을 추적하는 방법을 알아보세요.

세션 생명주기에 대하여

세션은 Braze SDK가 앱이 시작된 후 사용자 활동을 추적하는 기간을 의미합니다. 새로운 세션을 강제로 시작할 수도 있습니다 메서드 changeUser() 호출.

• web
• android
• swift

비활성 정의

비활성이 정의되고 측정되는 방식을 이해하는 것은 Web SDK에서 세션 생애 주기를 효과적으로 관리하는 데 핵심입니다. 비활성이란 Braze Web SDK가 사용자로부터 추적된 이벤트를 감지하지 않는 기간을 의미합니다.

비활성이 측정되는 방법

Web SDK는 SDK-추적 이벤트를 기반으로 비활성을 추적합니다. SDK는 추적된 이벤트가 전송될 때마다 재설정되는 내부 타이머를 유지합니다. 구성된 타임아웃 기간 내에 SDK-추적 이벤트가 발생하지 않으면 세션은 비활성으로 간주되고 종료됩니다.

Web SDK에서 세션 생애 주기가 구현되는 방법에 대한 자세한 내용은 Braze Web SDK GitHub 리포지토리의 세션 관리 소스 코드를 참조하십시오.

기본적으로 활동으로 간주되는 것:

• 웹 앱 열기 또는 새로 고침
• Braze 기반 UI 요소와 상호작용하기 (예: 인앱 메시지 또는 콘텐츠 카드)
• 추적된 이벤트를 전송하는 SDK 메서드 호출하기 (예: 커스텀 이벤트 또는 사용자 속성 업데이트)

기본적으로 활동으로 간주되지 않는 것:

• 다른 브라우저 탭으로 전환하기
• 브라우저 창 최소화하기
• 브라우저 포커스 또는 블러 이벤트
• 페이지에서 스크롤 또는 마우스 움직임

세션 타임아웃 구성

기본적으로 웹 SDK는 추적된 이벤트가 없는 경우 30분 후에 세션을 비활성으로 간주합니다. SDK를 초기화할 때 sessionTimeoutInSeconds 매개변수를 사용하여 이 임계값을 사용자 정의할 수 있습니다. 이 매개변수 구성에 대한 자세한 내용은 코드 예제를 포함하여 기본 세션 타임아웃 변경를 참조하십시오.

예시: 비활성 시나리오 이해하기

다음 시나리오를 생각해 보세요:

1. 사용자가 귀하의 웹사이트를 열면 SDK가 braze.openSession()를 호출하여 세션을 시작합니다.
2. 사용자가 다른 웹사이트를 보기 위해 다른 브라우저 탭으로 전환합니다.
3. 이 시간 동안 귀하의 웹사이트에서 SDK로 추적된 이벤트가 발생하지 않습니다.
4. 30분의 비활성 후 세션이 자동으로 종료됩니다.
5. 사용자가 귀하의 웹사이트 탭으로 다시 전환하고 SDK 이벤트(예: 페이지 보기 또는 콘텐츠와의 상호작용)를 트리거하면 새로운 세션이 시작됩니다.

커스텀 비활성 추적

브라우저 가시성 또는 탭 전환을 기반으로 비활성을 추적해야 하는 경우 JavaScript 코드에서 커스텀 이벤트 리스너를 구현하십시오. 사용자가 페이지를 떠날 때를 감지하기 위해 visibilitychange과 같은 브라우저 이벤트를 사용하고, 필요할 때 Braze에 커스텀 이벤트를 수동으로 전송하거나 braze.openSession()를 호출하십시오.

1
2
3
4
5
6
7
8
9
10
11
// Example: Track when user switches away from tab
document.addEventListener('visibilitychange', function() {
  if (document.hidden) {
    // User switched away - optionally log a custom event
    braze.logCustomEvent('tab_hidden');
  } else {
    // User returned - optionally start a new session and/or log an event
    // braze.openSession();
    braze.logCustomEvent('tab_visible');
  }
});

커스텀 이벤트 로깅에 대한 자세한 내용은 커스텀 이벤트 로깅을 참조하십시오. 세션 생명 주기 및 타임아웃 구성에 대한 자세한 내용은 기본 세션 타임아웃 변경를 참조하십시오.

세션 업데이트에 가입

1단계: 업데이트 가입

세션 업데이트를 구독하려면 subscribeToSessionUpdates() 방법을 사용하세요.

• web
• android
• swift
• react native

1
2
3
4
5
6
7
8
Braze.getInstance(this).subscribeToSessionUpdates(new IEventSubscriber<SessionStateChangedEvent>() {
  @Override
  public void trigger(SessionStateChangedEvent message) {
    if (message.getEventType() == SessionStateChangedEvent.ChangeType.SESSION_STARTED) {
      // A session has just been started
    }
  }
});

1
2
3
4
5
Braze.getInstance(this).subscribeToSessionUpdates { message ->
  if (message.eventType == SessionStateChangedEvent.ChangeType.SESSION_STARTED) {
    // A session has just been started
  }
}

1
2
3
4
5
6
7
8
9
10
11
// This subscription is maintained through a Braze cancellable, which will observe changes until the subscription is cancelled.
// You must keep a strong reference to the cancellable to keep the subscription active.
// The subscription is canceled either when the cancellable is deinitialized or when you call its `.cancel()` method.
let cancellable = AppDelegate.braze?.subscribeToSessionUpdates { event in
  switch event {
  case .started(let id):
    print("Session \(id) has started")
  case .ended(let id):
    print("Session \(id) has ended")
  }
}

1
2
3
4
5
6
7
8
for await event in braze.sessionUpdatesStream {
  switch event {
  case .started(let id):
    print("Session \(id) has started")
  case .ended(let id):
    print("Session \(id) has ended")
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// This subscription is maintained through a Braze cancellable, which will observe changes until the subscription is cancelled.
// You must keep a strong reference to the cancellable to keep the subscription active.
// The subscription is canceled either when the cancellable is deinitialized or when you call its `.cancel()` method.
BRZCancellable *cancellable = [AppDelegate.braze subscribeToSessionUpdates:^(BRZSessionEvent * _Nonnull event) {
  switch (event.state) {
    case BRZSessionStateStarted:
      NSLog(@"Session %@ has started", event.sessionId);
      break;
    case BRZSessionStateEnded:
      NSLog(@"Session %@ has ended", event.sessionId);
      break;
    default:
      break;
  }
}];

2단계: 테스트 세션 추적(선택 사항)

세션 추적을 테스트하려면 디바이스에서 세션을 시작한 다음 Braze 대시보드를 열고 관련 사용자를 검색합니다. 사용자 프로필에서 세션 개요를 선택합니다. 메트릭이 예상대로 업데이트되면 세션 추적이 올바르게 작동하는 것입니다.

기본 세션 시간 초과 변경하기

세션이 자동으로 시간 초과되기까지 경과하는 시간을 변경할 수 있습니다.

• web
• android
• swift
• react native

1
2
// Sets the session timeout to 15 minutes instead of the default 30
braze.initialize('YOUR-API-KEY-HERE', { sessionTimeoutInSeconds: 900 });

1
2
<!-- Sets the session timeout to 60 seconds. -->
<integer name="com_braze_session_timeout">60</integer>

1
2
3
4
5
6
7
8
// Sets the session timeout to 60 seconds
let configuration = Braze.Configuration(
  apiKey: "<BRAZE_API_KEY>",
  endpoint: "<BRAZE_ENDPOINT>"
)
configuration.sessionTimeout = 60;
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

1
2
3
4
5
6
7
// Sets the session timeout to 60 seconds
BRZConfiguration *configuration =
  [[BRZConfiguration alloc] initWithApiKey:brazeApiKey
                                  endpoint:brazeEndpoint];
configuration.sessionTimeout = 60;
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];
AppDelegate.braze = braze;