トラッキングセッション

Braze SDK では、ユーザーエンゲージメントやユーザーの理解に不可欠なその他の分析を計算するため、Braze ダッシュボードで使用されるセッションデータがレポートされます。SDK では、以下のセッションセマンティクスに基づいて、Braze ダッシュボード内で表示可能なセッションの長さとセッション数を考慮した「セッション開始」と「セッション終了」のデータポイントが生成されます。このリファレンス記事では、Android または FireOS アプリケーションのセッション更新を購読する方法を説明します。

セッションライフサイクル

推奨の アクティビティライフサイクルコールバック統合,] を使用して Braze を統合している場合は、アプリのアクティビティごとに openSession() と closeSession() が自動的に呼び出されます。デフォルトでは、Android のセッションはopenSession()への最初の呼び出し時に開かれ、アプリがフォアグラウンドから10秒以上離れると閉じられます。closeSession()を呼び出しても、すぐにセッションを閉じるわけではないことに注意してください。むしろ、ユーザーが途中でopenSession()を呼び出さないと (別のアクティビティに移動するなど)、10秒でセッションを閉じます。

Android セッションは、ホストアプリケーションからの通信がない状態で10秒後にタイムアウトします。つまり、ユーザーがアプリをバックグラウンドにして9秒後に戻ってきた場合、同じセッションが継続されます。なお、ユーザーがアプリをバックグラウンドで起動している間にセッションが終了してしまうと、アプリを再度開くまでそのデータがサーバーにフラッシュされないことがあります。

セッションタイムアウトをカスタマイズする

セッションタイムアウトをカスタマイズするには、braze.xml] ファイルに com_braze_session_timeout を追加します。NUMBER_OF_SECONDS_UNTIL_SESSION_TIMEOUT の最小値は 1 秒です。

1
2
<!-- The length of time before a session times out in seconds. The session manager will "re-open" otherwise closed sessions if the call to StartSession comes within this interval. (default is 10) -->
<integer name="com_braze_session_timeout">NUMBER_OF_SECONDS_UNTIL_SESSION_TIMEOUT</integer>

セッショントラッキングをテストする

ユーザーを介してセッションを検出するには、ダッシュボードでユーザーを見つけ、ユーザープロファイルの [アプリの利用状況] に移動します。セッション指標が想定どおりに増加していることを確認することで、セッショントラッキングが機能していることを確認できます。

セッション更新の購読

Braze SDK は、セッションの更新をリッスンするsubscribeToSessionUpdatesサブスクライバーを提供しています。

• java
• kotlin

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