Cara Menggunakan Channel untuk Feature Flags dan A/B Testing

Sistem channel CapGo menyediakan cara yang fleksibel untuk mensegmentasi pengguna dan mengontrol akses fitur. Meskipun CapGo tidak memiliki manajemen rencana atau A/B testing bawaan, Anda dapat mengimplementasikan fitur-fitur ini dengan mengelola penugasan channel sendiri.

Memahami Channel

Channel di CapGo memungkinkan Anda untuk:

• Menargetkan grup pengguna tertentu dengan fitur berbeda
• Menjalankan A/B test dengan menugaskan pengguna ke channel yang berbeda
• Meluncurkan fitur baru secara bertahap
• Membuat program pengujian beta

Metode Penugasan Channel

1. Penugasan Backend (Direkomendasikan)

Ini adalah metode yang lebih aman yang melibatkan:

1. Mendapatkan ID perangkat dari updater
2. Mengirimkannya ke backend Anda
3. Backend Anda memanggil API CapGo untuk menugaskan perangkat

Berikut cara mengimplementasikannya:

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)
}

Implementasi Backend

Backend Anda perlu:

1. Mendapatkan API key dari dashboard CapGo
2. Memanggil API CapGo untuk menugaskan perangkat ke channel

Untuk mendapatkan API key Anda:

1. Login ke dashboard CapGo Anda
2. Pergi ke Settings > API Keys
3. Klik “Generate New Key”
4. Pilih mode all untuk mengelola perangkat dan channel
5. Salin key yang dihasilkan dan simpan dengan aman di environment variables backend Anda
   • Key tersebut akan berupa string heksadesimal 32 karakter
   • Ini adalah key rahasia yang tidak boleh terekspos di kode sisi klien

Berikut contoh 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
  }
}

Backend juga harus:

• Memvalidasi izin pengguna
• Mencatat semua penugasan channel
• Menangani pembatasan rate
• Mengimplementasikan logika pengulangan untuk penugasan yang gagal

2. Penugasan Mandiri (Kurang Aman)

Metode ini memungkinkan perangkat untuk menugaskan diri mereka sendiri ke channel. Berguna untuk pengujian tetapi kurang aman untuk produksi:

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
}

Sebelum pengguna dapat menugaskan diri ke channel, Anda perlu mengaktifkan fitur ini di dashboard CapGo:

1. Pergi ke bagian Channels di dashboard CapGo Anda
2. Klik nama channel yang ingin Anda kelola
3. Di pengaturan channel, aktifkan “Allow devices to self associate”
4. Simpan perubahan

Jika pengaturan ini false, setiap upaya untuk memanggil setChannel dengan channel ini akan gagal

Mengimplementasikan Feature Flags

Gunakan channel untuk mengontrol akses fitur:

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

Implementasi A/B Testing

Jalankan A/B test dengan menugaskan pengguna ke channel yang berbeda:

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
}

Praktik Terbaik

1. Gunakan Penugasan Backend: Untuk produksi, selalu gunakan metode penugasan backend
2. Penugasan Konsisten: Gunakan ID pengguna atau identifier stabil lainnya untuk penugasan channel yang konsisten
3. Pemantauan: Lacak penggunaan fitur dan metrik kinerja untuk setiap channel
4. Peluncuran Bertahap: Mulai dengan segmen pengguna kecil dan perluas secara bertahap
5. Dokumentasi Jelas: Dokumentasikan strategi dan tujuan channel Anda

Kesimpulan

Dengan memanfaatkan sistem channel CapGo, Anda dapat membuat pengalaman aplikasi yang lebih personal dan menjalankan A/B test. Untuk penggunaan produksi, selalu pilih metode penugasan backend untuk keamanan dan kontrol yang lebih baik.

Untuk detail lebih lanjut tentang manajemen channel, lihat dokumentasi channel kami.