プロジェクトの設定の取得と更新機能により、Androidアプリケーションは、PageSenseで定義された最新のFull Stack設定と常に同期されます。

プロジェクトの設定には、次の項目が含まれます。

• 有効なテスト

• バリエーションとトラフィックの割り当て

• 目標

• オーディエンスのターゲティングルール

テストは随時更新される可能性があるため、SDKには、ポーリングベースの仕組みが用意されており、最新の設定を自動的に取得できます。

プロジェクトの設定の更新方法  

Android SDKでは、フォアグラウンドの状態を考慮したポーリング方式を使用し、不要なネットワーク通信を抑えながらプロジェクトの設定を効率的に更新します。

Android Full Stack SDKは、ウェブフックに対応していません。
すべての更新は、制御されたポーリングによって処理されます。

ポーリング方式  

初期設定の動作  

• 初期設定のポーリング間隔：5分

• プロジェクトの設定は、次の場合に自動的に更新されます。
  アプリがフォアグラウンドになった場合
  ネットワーク接続が利用可能になった場合

これにより、ユーザーがアプリを開くと、常に最新の設定で起動します。

ポーリング間隔のルール  

ポーリング間隔はユーザーが設定できますが、次の制限があります。

• 設定可能な最短間隔：5分

• 5分以上の値を設定できます

• ポーリング間隔を5分未満に設定することはできません

• 5分未満の値を設定した場合は、自動的に5分に調整されます

これにより、過剰なネットワーク使用を防ぎ、SDKの安定した動作を確保できます。

ポーリングのライフサイクル  

ポーリングが開始されるタイミング  

• アプリがフォアグラウンドになったとき

• ネットワーク接続が利用可能になったとき

ポーリングが停止するタイミング  

• アプリがバックグラウンドになったとき

• アプリのプロセスが終了したとき

• アプリを閉じたとき

アプリがバックグラウンドからフォアグラウンドに移行するたびに、次の処理が行われます。

• プロジェクトの設定がすぐに更新されます

• ポーリングタイマーがリセットされます

アプリが5分を超えてアクティブな状態を維持すると、設定された間隔に基づいてポーリングが再度自動的に更新を取得します。

プロジェクトの設定の更新を手動で実行する方法  

次のAPIを使用して、最新のプロジェクトの設定を手動で要求できます。このAPI呼び出しでは、PageSenseから最新の設定を取得し、それに応じてSDKの状態を更新します。

pageSenseClient.getAndUpdateProjectSettings('accountName','sdkKey','projectName')

パラメーターの詳細  

APIの応答時の動作  

更新がある場合  

プロジェクトの新規設定が検出されると、APIは200 OKステータスで応答し、内部で次の項目を更新します。

• projectVersion

• schemaVersion

• lastUpdatedTime

これらの値は、新規の設定変更が適用されたことを示します。

更新がない場合  

プロジェクトの設定に変更がない場合、APIは204 No Contentの応答を返します。

これは次を意味します。

• SDKは既存のプロジェクトの設定を引き続き使用します

• 変更は適用されません

• 対応は不要です

重要事項  

• ポーリングは、アプリがアクティブな場合にのみ実行されます

• 設定の更新は軽量化・最適化されています

• 開発者がバックグラウンドスレッドを手動で管理する必要はありません

• この仕組みにより、古い実験設定がユーザーに提供されるのを防ぎます

推奨事項  

• 変更する明確な理由がない限り、既定のポーリング間隔を維持してください

• バッテリーとネットワークの使用量を抑えるため、頻繁なポーリングの強制は避けてください

• フォアグラウンドとバックグラウンドの切り替えは、SDKに自動的に管理させてください