次の方法で共有

バリアント機能フラグを使用する

  • [アーティクル]

バリアント機能フラグにより、アプリケーションで機能の複数のバリアントをサポートできるようになります。 機能のバリアントは、特定のユーザー、グループ、またはパーセンタイル バケットに割り当てることができます。 これらのフラグは、機能のロールアウト、構成のロールアウト、機能の実験 (A/B テストとも呼ばれます) に役立ちます。

バリアント機能フラグとは

バリアント機能フラグは、複数の状態またはバリエーションをサポートする拡張機能フラグです。 オンまたはオフを切り替えることができますが、構成を使用して異なるバリアントを使用することもできます。 バリアントは、名前とオプションの構成値で定義されます。 この名前は、バリアントを区別するための識別子です。 構成値の範囲は、単純な JSON プリミティブから複雑な JSON オブジェクトまでさまざまです。 バリアントを使用して、機能またはユーザー エクスペリエンスを区別し、必要に応じてバリアント構成値を使用してこれらの機能またはユーザー エクスペリエンスを構成できます。 さらに、バリアント機能フラグには、各バリアントの対象ユーザーを定義する割り当てルールが含まれています。

バリアント

次の例は、構成値に JSON オブジェクトを使用する 2 つのバリアントを示しています。

バリアント名 バリアント構成値
最小 { "maxitems": 10, "showAds": false }
Standard { "maxitems": 30, "showAds": true }

配賦

割り当てにより、各バリアントを取得するユーザーのセグメントが制御されます。 次の例では、10% のユーザーにMinimalバリアントを、90% のユーザーにStandardバリアントを割り当てます。

Variant 配賦 解説
最小 10% バリアントを 0 パーセンタイルから 10 パーセンタイルのユーザーに割り当てます。
Standard 90% バリアントを 10 パーセンタイルから 100 パーセンタイルのユーザーに割り当てます。

上書き

パーセンテージの割り当てに関係なく、特定のグループまたはユーザーにバリアントを割り当てることができます。 次の例では、ベータ版テスト担当者グループのユーザーにMinimalバリアントを割り当てます。

グループ名 Variant
ベータ版テスト担当者 最小

既定値のバリアントとキル スイッチ

バリアント機能フラグには、DefaultWhenEnabled と DefaultWhenDisabled の 2 つのバリアントの既定値があります。

  • DefaultWhenEnabled バリアントは、フラグが有効になっているが、割り当てによってすべてのパーセンタイルが割り当てられない場合に有効になります。 割り当てられていないパーセンタイルに配置されたユーザーは、DefaultWhenEnabled バリアントを受け取ります。
  • DefaultWhenDisabled バリアントは、フラグが無効になっている場合に有効になります。これを行うには、[有効] フィールドを "false" に設定します ("キル スイッチ" の使用とも呼ばれます)。

キル スイッチは、ユーザーの割り当てを停止するために使用されます。 バグ、回帰、パフォーマンスの低下など、1 つ以上のバリアントに問題がある場合に使用されます。 キル スイッチを使用するには、バリアント フラグの [有効] フィールドを "false" に設定します。 パーセンタイルまたはオーバーライドされたユーザー/グループに関係なく、すべてのユーザーに DefaultWhenDisabled バリアントが与えられるようになりました。

バリアント機能フラグを備えたアプリの構築

このチュートリアルでは、"今日の名言" という名前の Web アプリを作成します。 このアプリを読み込むと、名言が表示されます。 ユーザーは、ハート ボタンを押して "いいね!" を付けることができます。 ユーザー エンゲージメントを向上させるには、パーソナライズされたあいさつメッセージを採用した場合に、名言に "いいね!" を付けるユーザーが増加するかどうかを調べる必要があります。 None バリアントを受け取ったユーザーには、あいさつは表示されません。 Simple バリアントを受け取ったユーザーは、簡単なあいさつメッセージを受け取ります。 Long バリアントを受け取ったユーザーは、もう少し長いあいさつを受け取ります。

前提条件

バリアント機能フラグを作成する

  1. App Configuration ストアにラベルのない Greeting と呼ばれるバリアント機能フラグを作成します。 これには、None、Simple、Longの 3 つのバリエーションがあり、それぞれ異なるあいさつメッセージに対応しています。 構成値と割り当ての設定については、次の表を参照してください。 バリアント機能フラグを追加する方法の詳細については、「バリアント機能フラグを作成する」を参照してください。

    バリアント名 バリアント構成値 配賦
    None (既定値) null 50%
    簡易 "こんにちは!" 25%
    Long “これであなたの 1 日がハッピーになりますように!” 25%

  2. アプリケーションで、使用している言語またはプラットフォームに合わせて機能フラグを使用するには、次の手順に進んでください。