コンテンツにスキップ

セッション

ヒューマンスコアリングユースケースの一部です。

セッションは、ひとつの分類の対象となる操作のひと続きです。 SDK は init 時にセッションを開始します。アプリだけが知る形でセッションが終わるとき(ログアウトや アカウント切り替え)には SDK に知らせてください。そうすることで、あるユーザーの操作が次のユーザーの 分類に数えられることがなくなります。これは、広告ユースケースで DEA が広告 1 件ごとに 開く広告セッションとは別のものです。

使いどころ

  • ユーザーがログアウトする
  • ユーザーがアカウントを切り替える
  • 現在のセッション ID が必要なとき。たとえばサポートへの問い合わせに含める場合

前提条件

使い方

新しいセッションを開始する

import 'package:dea_sdk/dea_sdk.dart';

DeaSdk.instance?.reset();

reset() は現在のセッションを終了し、新しい ID で新しいセッションを開始します。リセット前に集めた証拠は 新しいセッションの分類には数えられません。同意には影響せず、一時停止にも影響しません。一時停止中の SDK は一時停止のままです。

また、アプリが 5 分を超えてバックグラウンドにあった後に戻ってきた場合、SDK は自動的に証拠をやり直し ます。その時点では、同じ人物が端末を持っているとは言えないからです。このときセッション ID は変わり ません。セッションがモデルの求める数の アクション(組み込みモデルでは 8)に達するまで、分類は再び insufficient になります。証拠を参照してください。

現在のセッションを読み取る

final info = DeaSdk.instance!.getSessionInfo();

debugPrint(info.session);            // current session id, a UUID
debugPrint(info.sdk.version);        // SDK version
debugPrint('${info.device.surface}'); // current screen size

getSessionInfo() は軽い読み取りです。報告される画面サイズは、画面が回転したりウィンドウのサイズが 変わったりしても最新の値に保たれます。

SDK をシャットダウンする

DeaSdk.instance?.dispose();

dispose() は取得を停止し、SDK を解放します。まだ処理されていないものは破棄されます。dispose() の後、 DeaSdk.instance は null になり、DeaSdk.init で新しいインスタンスを開始できます。

例

ログアウト時にリセットする

import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';

Future<void> logout(BuildContext context) async {
  await authService.signOut();
  DeaSdk.instance?.reset();
  if (context.mounted) {
    Navigator.of(context).pushNamedAndRemoveUntil('/login', (_) => false);
  }
}

API

メンバー 戻り値 説明
reset() void セッションを終了し、新しいセッションを開始する
getSessionInfo() SessionInfo セッション ID、端末、SDK バージョン
dispose() void 取得を停止し、SDK を解放する