PageSense Android フルスタック SDK では、アプリケーション内での SDK の動作を制御できるカスタマイズ設定を提供しています。これらの設定により、実験設定の最新性、ログ出力の詳細度、運用上の安定性をバランスよく保つことができます。
SDK のカスタマイズは任意です。設定を行わない場合、SDK は推奨されるデフォルト値で動作します。
SDK のカスタマイズでは、次の項目を設定できます。
ポーリング間隔(プロジェクト設定の更新頻度)
カスタムロガー(SDK ログの処理方法)
ログレベルの制御(独自のロギング実装を通じて制御)
すべてのカスタマイズは、SDK の初期化時にPageSenseSDKOptionsを使用して適用されます。
SDK はポーリングを使用して、フルスタックプロジェクトの設定を更新します。ポーリングを実行する頻度を設定できます。
デフォルトのポーリング間隔: 5 分
ポーリング間隔は5 分以上である必要があります
5 分以下の値は許可されません
5 分未満の値が指定された場合、自動的に15 分に正規化されます
ポーリングは、アプリが有効な状態のときにのみ実行され、プロジェクト設定ドキュメントで説明されているライフサイクルルールに従います。
ポーリング間隔は分単位で指定します。
JAVA 例
KOTLIN 例
デフォルトでは、SDK は内部ロガーを使用してメッセージを出力します。
アプリケーションで集中管理されたロギングフレームワークを使用している場合は、カスタムロガーを組み込むことで、SDK ログを自分で取得・管理できます。
カスタムロガーを設定すると、次のようになります。
すべての SDK ログが、あなたのロガー経由で出力されます
ログの保存場所や表示方法を自由に制御できます
カスタムロガーは、PageSenseLoggerインターフェイスを実装し、さまざまな重大度レベルのログメッセージを処理する必要があります。
JAVA 例
KOTLIN 例
ポーリングとログの設定が完了したら、SDK を初期化する際に PageSenseSDKOptions オブジェクトを渡します。
JAVA の例
KOTLIN の例
SDK は、次のような複数のログ重大度レベルをサポートしています。
TRACE
DEBUG
INFO
WARN
ERROR
SEVERE
カスタムロガーを使用する場合、ログレベルの処理はすべて実装側で制御できます。
これにより、次のことが可能になります。
本番環境で詳細なログを抑制する
開発中は詳細ログを有効にする
既存のログパイプラインと連携する
特別な理由がない限り、デフォルトのポーリング間隔を使用する
ネットワークとバッテリーの消費を抑えるため、過度なポーリングは避ける
本番環境ではカスタムロガーを使用する
詳細ログ(DEBUG / TRACE)は開発ビルドのみに限定する
SDK 設定を指定しない場合は、次のように動作します。
デフォルトのポーリング動作が適用されます
SDK 内部のログ機能が使用されます
SDK は標準のデフォルト設定で安全に動作します
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。