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 は200 OKステータスで応答し、次の項目を内部的に更新します。
projectVersion
schemaVersion
lastUpdatedTime
これらの値は、新しい構成変更が適用されたことを示します。
プロジェクト構成に変更がない場合、API は204 No Contentレスポンスを返します。
これは次のことを意味します。
SDK は既存のプロジェクト設定を引き続き使用します。
変更は適用されていません。
対応は不要です。
ポーリングは、アプリが有効なときにのみ実行されます。
構成の更新は軽量で、最適化されています。
開発者がバックグラウンドスレッドを手動で管理する必要はありません。
この仕組みにより、ユーザーに古い実験設定が適用されることを防ぎます。
特別な理由がない限り、初期設定のポーリング間隔を維持してください。
バッテリーとネットワーク使用量を抑えるため、頻繁なポーリングを強制しないでください。
SDK にフォアグラウンドとバックグラウンドの遷移管理を自動的に任せてください。
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。