View a markdown version of this page

オーディエンスルールの作成 - AWS AppConfig

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

オーディエンスルールの作成

対象者ルールセクションには、実験の対象者を対象とするルールを作成するためのルールビルダータブとエディタタブが含まれています。

オーディエンスルールビルダーの使用

ルールビルダーは、式を記述せずに対象者ターゲットルールを定義するためのビジュアルインターフェイスを提供します。属性を使用して条件を作成し、論理演算子と組み合わせて、実験に含めるユーザーを制御できます。ルールビルダーでは、条件とグループを組み合わせてルールを定義します。

  • 条件は 1 つの属性 ( など$plan equals "enterprise") を評価します。

  • グループは、 ANDや などの論理演算子を使用して複数の条件を組み合わせますOR

各グループは、 trueまたは のいずれかに評価されますfalse。ルール全体に一致するユーザーは、ターゲットオーディエンスに含まれます。

次の場合は、ルールビルダーを使用します。

  • 式を記述せずにオーディエンスルールをすばやく定義または変更する

  • 条件のグループ化と評価方法を視覚化する

  • ターゲットロジックを段階的に構築して検証する

次に例を示します。

プレミアムアカウント階層のユーザーをターゲットにするためのルール。

サンプルオーディエンスルールを指定してAWS AppConfig実験中の Rule Builder タブのイメージ。

特定の E メールドメインを使用して、特定の地理的リージョンのユーザーをターゲットにするためのルール。

サンプルオーディエンスルールを指定してAWS AppConfig実験中の Rule Builder タブの 2 番目のイメージ。

ベータプログラムをオプトインしている間に、特定のプランで特定のユーザーをターゲットにしたり、セカンダリプランを使用したりするためのルール。

サンプルオーディエンスルールを指定してAWS AppConfig実験中の Rule Builder タブの 3 番目のイメージ。

エディタとの関係

ルールビルダーとエディタは、異なる形式で同じターゲットロジックを定義します。

  • ルールビルダーは、ルールを視覚的に構築する方法を提供します。

  • エディタには、同等の論理式が表示されます。

一方のビューで行われた変更は、もう一方のビューに反映されます。

ベストプラクティス

  • ルールを読み取り可能にする – グループを使用して条件を論理的に整理し、深くネストされた構造を回避します。

  • 属性値の検証 — 属性名と値がアプリケーションによって提供された値と一致することを確認します。

  • 公開前にテスト — 0% の公開と処理の割り当てオーバーライドを使用して、ルールが期待どおりに動作することを確認します。

エディタの使用

エディタを使用すると、実験に含めるユーザーを決定するターゲティングルールを定義できます。これらのルールは、プラットフォーム、リージョン、アプリケーションバージョンなどのユーザーまたはデバイスの属性を評価する論理式として指定します。実験が実行されると、 は各ユーザーの式AWS AppConfigを評価します。基準に一致するユーザーはターゲットオーディエンスに含まれ、処理に割り当てることができます。

式形式

式はプレフィックス (関数スタイル) 構文を使用します。

(operator argument1 argument2 ...)

例えば、次のようになります。

(and (eq $system "iPhone") (lt $osVersion 1.8) )

この式には、次のユーザーが含まれます。

  • iPhone を使用する

  • オペレーティングシステムのバージョンが 1.8 より前である

エディタは、ルールビルダーと同じターゲットシナリオをサポートします。オーディエンスルールの視覚的な例については、「」を参照してくださいオーディエンスルールビルダーの使用

属性の定義

属性は、評価対象のユーザーまたは環境のプロパティを表します。属性は$プレフィックスで参照されます。

一般的な例としては次のようなものがあります。

  • $system – デバイスまたはプラットフォームタイプ

  • $osVersion – オペレーティングシステムのバージョン

  • $region – 地理的リージョン

  • $appVersion – アプリケーションバージョン

使用可能な属性は、アプリケーションとデータの受け渡し方法によって異なりますAWS AppConfig。

式の記述

論理演算子を使用して複数の条件を組み合わせることができます。

  • を使用してand、すべての条件が true であることを要求します。

  • を使用して任意の条件orを一致させる

  • を使用して条件を除外notする

例:

(and (eq $region "us-east-1") (or (eq $system "iPhone") (eq $system "Android") ) )

この式は、iPhone または Android デバイスを使用している us-east-1 のユーザーを対象としています。

ベストプラクティス

  • シンプルな開始 — 小さな条件から始めて、必要に応じて展開します。

  • 属性の検証 – 式で使用される属性が一貫して入力されていることを確認します。

  • 過度に複雑な表現を避ける – 複雑なロジックでは、ターゲットの理解と維持が困難になる可能性があります。

  • 公開前にテスト — 0% の公開と処理の割り当てオーバーライドを使用して、ルールが期待どおりに動作することを確認します。

式演算子

オーディエンス式では、次の演算子がサポートされています。

論理演算子

演算子 説明

すべての条件が true の場合に true を返します

(and (eq $region "us") (eq $system "iPhone"))

または

条件が true の場合は true を返します

(or (eq $system "iPhone") (eq $system "Android"))

not

条件が false の場合、true を返します。

(not (eq $region "eu-west-1"))

比較演算子

演算子 説明

eq

Equals

(eq $system "iPhone")

ne

等しくない

(ne $region "us-west-2")

lt

Less than

(lt $osVersion 1.8)

lte

Less than or equal

(lte $osVersion 2.0)

gt

Greater than

(gt $appVersion 5.0)

gte

Greater than or equal

(gte $appVersion 5.0)

文字列演算子と集合演算子

演算子 説明

情報

リスト内の任意の値に一致

(in $region ["us-east-1" "us-west-2"])

contains

値に部分文字列が含まれているかどうかを確認します

(contains $deviceName "iPhone")

注記

使用可能な演算子は、アプリケーションで属性が定義および評価される方法によって異なります。