iOS のセッショントラッキング

Braze SDK では、ユーザーエンゲージメントなど、ユーザーについて理解するうえで不可欠な分析情報を計算するために Braze ダッシュボードで使用されるセッションデータがレポートされます。SDK では、以下のセッションセマンティクスに基づいて、Braze ダッシュボード内で表示可能なセッションの長さとセッション数を考慮した「セッション開始」と「セッション終了」のデータポイントが生成されます。

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

[[Appboy sharedInstance] startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions] を呼び出すとセッションが開始されます。その後はデフォルトで、UIApplicationWillEnterForegroundNotification 通知が発行されると (アプリがフォアグラウンドに入ったときなど) セッションが開始され、アプリがフォアグラウンドを離れると (UIApplicationDidEnterBackgroundNotification 通知が発行されたときや、アプリが終了したときなど) セッションが終了します。

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

Braze iOS SDK v3.14.1 以降では、Info.plist ファイルを使用してセッションタイムアウトを設定できます。Braze ディクショナリを Info.plist ファイルに追加します。Braze ディクショナリ内に SessionTimeout 番号サブエントリを追加し、値をカスタムセッションタイムアウトに設定します。なお、Braze iOS SDK v4.0.2 より前のバージョンでは、Braze の代わりにディクショナリキー Appboy を使用する必要があります。

または、startWithApiKey に渡される appboyOptions オブジェクト内の ABKSessionTimeoutKey キーを目的の整数値に設定することもできます。

• objective-c
• swift

1
2
3
4
5
// Sets the session timeout to 60 seconds
[Appboy startWithApiKey:@"YOUR-API_KEY"
          inApplication:application
      withLaunchOptions:options
      withAppboyOptions:@{ ABKSessionTimeoutKey : @(60) }];

1
2
3
4
5
// Sets the session timeout to 60 seconds
Appboy.start(withApiKey: "YOUR-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:[ ABKSessionTimeoutKey : 60 ])

セッションタイムアウトを設定した場合、セッションセマンティクスの長さはすべてそのカスタマイズされたタイムアウトになります。

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

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