세션 추적

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 메서드 호출(예: 커스텀 이벤트 또는 사용자 속성 업데이트)

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

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

세션 타임아웃 구성

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

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

다음 시나리오를 살펴보겠습니다:

1. 사용자가 웹사이트를 열면 SDK가 braze.openSession()을 호출하여 세션을 시작합니다.
2. 사용자가 다른 웹사이트를 보기 위해 다른 브라우저 탭으로 30분 동안 전환합니다.
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;

문제 해결

고객 프로필의 세션 수가 0인 경우

SDK 외부에서 사용자가 생성된 경우 고객 프로필의 세션 수가 0일 수 있습니다:

• REST API로 생성된 경우: /users/track 엔드포인트를 통해 요청에 app_id를 포함하여 사용자를 생성하면, 프로필은 해당 앱과 연결되어 표시되지만 해당 사용자에 대해 SDK가 초기화된 적이 없으므로 세션 데이터가 없습니다.
• CSV 가져오기로 생성된 경우: 첫 번째 또는 마지막 세션 필드에 값 없이 CSV를 통해 사용자를 가져오면 프로필은 세션 수 0으로 존재합니다.