チャンネルを使用した機能フラグとA/Bテストの方法

Capgoのチャンネルシステムは、ユーザーを分割し機能へのアクセスを制御するための柔軟な方法を提供します。 Capgoには、プランの管理やA/Bテストの機能は組み込まれていませんが、チャンネル割り当てを管理することで、これらの機能を実装できます。

チャンネルの理解

Capgoのチャンネルでは、次のことができます。

特定のユーザーグループに異なる機能を対象にする
ユーザーを異なるチャンネルに割り当ててA/Bテストを実行する
新しい機能を段階的にロールアウトする
ベータテストのプログラムを作成する

チャンネル割り当ての方法

1. バックエンド割り当て（推奨）

この方法はより安全です。以下の手順が含まれます。

デバイスIDを取得する
デバイスIDをバックエンドに送信する
バックエンドはCapgo APIを呼び出してデバイスを割り当てる

実装方法については以下のとおりです。

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Get device ID
const getDeviceId = async () => {
  const { deviceId } = await CapacitorUpdater.getDeviceId()
  return deviceId
}

// Send device ID to your backend
const assignToChannel = async (channel: string) => {
  const deviceId = await getDeviceId()
  // Your backend will call Capgo API to assign the device
  await yourBackend.assignDeviceToChannel(deviceId, channel)
}

バックエンド実装

バックエンドには以下のことが必要です。

APIキーをCapgoダッシュボードから取得する
Capgo APIを呼び出してデバイスをチャンネルに割り当てる

APIキーを取得するには

Capgoダッシュボードにログインする
設定>APIキーに移動する
Click “新しいキーを生成”をクリック
選択 all モードを選択してデバイスとチャンネルの管理を行う
生成されたキーを安全にバックエンド環境変数に保存する
- キーは32桁の16進数の文字列になります
- クライアントサイドで code を公開してはならない秘密鍵です

Node.jsの例です:

import axios from 'axios'

const CAPGO_API_KEY = 'your_api_key'
const CAPGO_API_URL = 'https://api.capgo.app'

async function assignDeviceToChannel(deviceId: string, channel: string) {
  try {
    const response = await axios.post(
      `${CAPGO_API_URL}/device`,
      {
        app_id: 'YOUR_APP_ID',
        device_id: deviceId,
        channel: channel
      },
      {
        headers: {
          'authorization': CAPGO_API_KEY,
          'Content-Type': 'application/json'
        }
      }
    )
    return response.data
  } catch (error) {
    console.error('Failed to assign device to channel:', error)
    throw error
  }
}

バックエンド側も

ユーザーの権限を検証する
チャンネル割り当てのログを取る
レート制限を実装する
失敗した割り当てに対してリトライロジックを実装する

2. 自己割り当て (セキュリティが低い)

この方法では、デバイスは直接チャネルに割り当てられる。テストに便利ですが、生産環境ではセキュリティが低い:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Assign device to channel
const assignToChannel = async (channel: string) => {
  await CapacitorUpdater.setChannel(channel)
}

// Get current channel
const getCurrentChannel = async () => {
  const { channel } = await CapacitorUpdater.getChannel()
  return channel
}

ユーザーがチャネルに自己割り当てる前に、この機能を Capgo ダッシュボードで有効にする必要があります:

Capgo ダッシュボードのチャネルセクションに移動
管理したいチャネル名をクリック
チャネル設定で、「デバイスが自己関連付けを許可する」にチェックを入れる
変更を保存

この設定がfalseの場合、チャネルを指定して呼び出そうとすると失敗します。 setChannel 機能フラグの実装

チャネルを使用して機能へのアクセスを制御する:

A/B テストの実装

const isFeatureEnabled = async (feature: string) => {
  // Example: Check if user is in beta channel
  const channel = await getCurrentChannel()
  return channel === 'beta'
}

A/B Testing Implementation

チャンネルにユーザーを異なるグループに割り当てて、A/Bテストを実行してください:

const assignToABTest = async (userId: string) => {
  // Use consistent hashing to assign users
  const hash = await hashUserId(userId)
  const variant = hash % 2 === 0 ? 'variant-a' : 'variant-b'
  
  await assignToChannel(variant)
  return variant
}

ベストプラクティス

バックエンド割り当てを使用してください:生産環境では、常にバックエンド割り当てメソッドを使用してください
一貫した割り当て:ユーザーIDや他の安定した識別子を使用して、一貫したチャンネル割り当てを実行してください
監視:各チャンネルで機能の使用状況とパフォーマンスメトリックを追跡してください
段階的なロールアウト:小さなユーザーセグメントから始めて、段階的に拡大してください
明確なドキュメント:チャンネル戦略と目的をドキュメント化してください

まとめ

Capgoのチャンネルシステムを活用することで、より個別のアプリエクスペリエンスを実現し、A/Bテストを実行できます。生産環境では、セキュリティとコントロールのために、バックエンドの割り当て方法を優先してください。

チャンネル管理の詳細については、以下のドキュメントを参照してください。チャンネル管理のドキュメント.

機能フラグとA/Bテストのためにチャンネルを使用する方法から続きましょう。

機能フラグとA/Bテストのためにチャンネルを使用する方法機能フラグとA/Bテストのためにチャンネルを使用する方法を使用している場合、チャンネルルーティングとステージドロールアウトを計画するには、__CAPGO_KEEP_0__と接続してください。チャンネルチャンネルチャンネルチャンネルチャンネルチャンネルチャンネルの実装詳細のためベータテストソリューションベータテストソリューションの製品ワークフローバージョン対象ソリューションバージョン対象ソリューションの製品ワークフロー

機能フラグとA/Bテストのためのチャンネルの使用方法