プロジェクト設定の取得と更新

プロジェクト設定の取得と更新

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Android アプリが PageSense で定義された最新のフルスタック構成と常に同期されるようにするのが、プロジェクト設定の取得と更新機能です。

プロジェクト設定には、次の内容が含まれます:

  • 有効な実験

  • バリエーションとトラフィック配分

  • 目標(ゴール)

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

実験は時間とともに更新される可能性があるため、SDK では最新の構成を自動的に取得するためのポーリングベースの仕組みを提供しています。

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

Android SDK は、不要なネットワーク使用を避けつつ効率的にプロジェクト設定を更新するために、フォアグラウンド認識型のポーリング戦略を使用します。

Android フルスタック SDK では、Webhook はサポートされていません
すべての更新は、制御されたポーリングによって処理されます。

ポーリング戦略  

デフォルトの動作  

  • デフォルトのポーリング間隔: 5 分

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

これにより、ユーザーがアプリを開いたときに、常に最新の構成で起動されます。

ポーリング間隔のルール  

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

  • 許可される最小間隔: 5 分

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

  • 5 分より短いポーリング間隔は使用できません。

  • 5 分未満の値が設定された場合は、自動的に 5 分に正規化されます

これにより、過度なネットワーク使用を防ぎ、SDK の動作を安定させます。

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

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

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

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

ポーリングが停止されるタイミング:  

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

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

  • アプリが完全に終了したとき

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

  • プロジェクト設定が即座に更新されます。

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

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

プロジェクト設定の更新を手動でトリガーする  

次の API を使用して、最新のプロジェクト設定を手動で取得することもできます。この呼び出しにより、PageSense から最新の構成が取得され、SDK の状態がそれに応じて更新されます。

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

パラメーターの詳細:  

パラメーター

種類

必須

説明

accountName

String

はい

お使いの PageSense アカウントの一意の識別子。

sdkKey

String

はい

環境用のセキュアキー。PageSense アプリケーションの[Environment]セクションで確認できます。

projectName

String

はい

PageSense アカウントで定義されているプロジェクト名。

 

API レスポンスの動作  

更新がある場合  

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

  • projectVersion

  • schemaVersion

  • lastUpdatedTime

これらの値は、新しい構成変更が適用されたことを示します。

更新がない場合  

プロジェクト構成に変更がない場合、API は204 No Contentレスポンスを返します。

これは次のことを意味します。

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

  • 変更は適用されていません。

  • 対応は不要です。

重要なメモ  

  • ポーリングは、アプリが有効なときにのみ実行されます。

  • 構成の更新は軽量で、最適化されています。

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

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

ベストプラクティス  

  • 特別な理由がない限り、初期設定のポーリング間隔を維持してください。

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

  • SDK にフォアグラウンドとバックグラウンドの遷移管理を自動的に任せてください。