使用變體功能旗標

Variant 功能旗標可讓您的應用程式支援功能的多個變體。 功能的變化可以指派給特定使用者、群組或百分位數貯體。 這些旗標對於功能首度發行、組態推出和功能實驗（也稱為 A/B 測試）很有用。

什麼是變體功能旗標？

Variant 功能旗標是支援多個狀態或變化的增強功能旗標。 雖然它仍然可以開啟或關閉，但它也允許不同的變體與組態。 變數是使用 Name 和選擇性的組態值來定義。 名稱是用來區分變體的標識碼。 組態值的範圍可以從簡單的 JSON 基本類型到複雜的 JSON 物件。 您可以使用變體來區分功能或用戶體驗，並選擇性地使用變體組態值來設定這些功能或用戶體驗。 此外，變體功能旗標包含配置規則，這些規則會定義每個變體的目標物件。

變體

下列範例示範使用組態值的 JSON 物件來使用兩個變體。

Variant 名稱	Variant 組態值
最小	{ “maxitems”： 10， “showAds”： false }
標準	{ “maxitems”： 30， “showAds”： true }

配置

配置可控制使用者取得每個變體的區段。 下列範例會配置 10% 的使用者，以取得 最小 變體，90% 以取得 標準 變體。

變數	配置	備註
最小	10%	將變體指派給第0到第10個百分位數的使用者。
標準	90%	將變體指派給第10到第100個百分位數的使用者。

Overrides

您可以指派變體給特定群組或使用者，而不論配置百分比為何。 下列範例會將 Beta Tester 群組中的使用者指派為 Minimal 變體。

群組名稱	變數
Beta 測試人員	最小

默認變體和終止參數

Variant 功能旗標有兩個 Variant 預設值： DefaultWhenEnabled 和 DefaultWhenDisabled。

• 如果已啟用旗標，但配置未指派所有百分位數，DefaultWhenEnabled 變體就會生效。 任何置於未指派百分位數的使用者都 會收到 DefaultWhenEnabled 變體。
• 如果停用旗標，則 DefaultWhenDisabled 變體會生效，方法是將 Enabled 字段設定為 false，也稱為使用 “kill switch”。

kill 參數是用來阻止使用者配置。 當一或多個變體有問題時使用，無論是 Bug、回歸還是效能不佳。 若要使用 kill 參數，請將 Variant 旗標的 Enabled 欄位設定為 false。 所有用戶現在都會獲得 DefaultWhenDisabled 變體，而不論他們所屬的使用者/群組為何。

使用變體功能旗標建置應用程式

在本教學課程中，您會建立名為 Quote of the Day 的 Web 應用程式。 應用程式載入時會顯示引用。 用戶可以與心臟按鈕互動，使其喜歡。 若要改善用戶參與度，您想要探索個人化問候語訊息是否會增加喜歡報價的用戶數目。 收到 None 變體的使用者看不到問候語。 收到 Simple Variant 的使用者會收到簡單的問候訊息。 收到 Long 變體的使用者會收到稍微較長的問候語。

必要條件

• Azure 訂用帳戶。 如果沒有，請免費建立一個。
• 應用程式組態存放區。

建立變體功能旗標

1. 在 應用程式組態 存放區中建立稱為 Greeting 的變體功能旗標，且沒有標籤。 它包含三個變體： None、 Simple 和 Long，分別對應至不同的問候語訊息。 請參閱下表，以取得其組態值和配置設定。 如需如何新增變體功能旗標的詳細資訊，請參閱 建立變體功能旗標。

   Variant 名稱	Variant 組態值	配置
   沒有 （預設值）	null	50%
   簡易	“Hello！”	25%
   Long	“我希望這讓你的一天！	25%

2. 請繼續進行下列指示，針對您所使用的語言或平臺，在應用程式中使用 Variant 功能旗標。

   • ASP.NET Core