How to Menggunakan Saluran untuk Flag Fitur dan Uji Coba A/B

Sistem saluran Capgo menyediakan cara yang fleksibel untuk membagi pengguna dan mengontrol akses fitur. Meskipun Capgo tidak memiliki manajemen rencana bawaan atau uji coba A/B, Anda dapat menerapkan fitur-fitur ini dengan mengelola penugasan saluran sendiri.

Memahami Saluran

Saluran di Capgo memungkinkan Anda:

Mengarahkan kelompok pengguna tertentu dengan fitur yang berbeda
Menggunakan uji coba A/B dengan mengasign pengguna ke saluran yang berbeda
Menggunakan fitur baru secara bertahap
Membuat program tes beta

Cara Mengasign Saluran

1. Pengasignan Backend (Dianjurkan)

Metode ini lebih aman. Ini melibatkan:

Mengambil ID perangkat dari pembarui
Kirimkan ke backend Anda
Backend Anda memanggil Capgo API untuk menetapkan perangkat

Berikut cara melaksanakannya:

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

Pengimplementasian Backend

Backend Anda perlu:

Mendapatkan kunci API dari dashboard Capgo
Panggil Capgo API untuk menetapkan perangkat ke saluran

Untuk mendapatkan kunci API Anda:

Masuk ke dashboard Capgo Anda
Pergi ke Pengaturan > API Keys
Klik "Generate New Key"
Pilih all metode untuk mengelola perangkat dan saluran
Salin kunci yang dihasilkan dan simpan dengan aman di variabel lingkungan backend Anda
- Kunci akan berupa string hexadecimal 32 karakter
- Itu adalah kunci rahasia yang tidak boleh terbuka di sisi klien code

Contoh Node.js berikut ini:

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:

Validasi izin pengguna
Log semua pengaturan saluran
Handle pembatasan kecepatan
Implementasikan logika ulang untuk pengaturan gagal

2. Pengasasan Sendiri (Lebih Tidak Aman)

Metode ini memungkinkan perangkat untuk secara langsung menetapkan diri mereka ke dalam saluran. Ini 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 mereka ke sebuah saluran, Anda perlu mengaktifkan fitur ini di Capgo dashboard:

Pergi ke bagian Saluran di Capgo dashboard Anda
Klik pada nama saluran yang ingin Anda kelola
Dalam pengaturan saluran, aktifkan “Izinkan perangkat untuk berasosiasi sendiri”
Simpan perubahan

Jika pengaturan ini palsu, setiap upaya untuk memanggil setChannel Implementasi Flag Fitur

Gunakan saluran untuk mengontrol akses fitur:

Implementasi Uji Coba A/B

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

Lakukan uji coba A/B dengan menugaskan pengguna ke saluran yang berbeda:

Praktik Terbaik

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
}

Implementasi Flag Fitur

Gunakan Pengasasan Backend: Untuk produksi, selalu gunakan metode pengasasan backend
Pengasasan Konsisten: Gunakan ID pengguna atau identifikasi stabil lainnya untuk pengasasan channel yang konsisten
Pengawasan: Ikuti penggunaan fitur dan metrik kinerja untuk setiap channel
Rollout Berkelanjutan: Mulai dengan segmen pengguna kecil dan secara bertahap memperluas
Dokumentasi Jelas: Dokumentasikan strategi channel dan tujuan Anda

Kesimpulan

: Dengan memanfaatkan sistem channel Capgo’, Anda dapat membuat pengalaman aplikasi yang lebih personal dan menjalankan uji coba A/B. Untuk produksi, selalu prefer metode pengasasan backend untuk keamanan dan kontrol yang lebih baik.

Untuk informasi lebih lanjut tentang pengelolaan saluran, silakan cek dokumentasi kami tentang Dokumentasi Saluran.

Teruskan dari Cara Menggunakan Saluran untuk Flag Fitur dan Pengujian A/B

Jika Anda menggunakan Cara Menggunakan Saluran untuk Flag Fitur dan Pengujian A/B untuk merencanakan routing saluran dan peluncuran tahap demi tahap, hubungkannya dengan Saluran context":"Saluran Capgo fitur nama rilis. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Tampilan Putih Label Solusi). untuk detail implementasi di Saluran, Saluran context":"Saluran Capgo fitur nama rilis. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Tampilan Putih Label Solusi). untuk detail implementasi di Saluran,","Saluran","context":"Saluran Capgo fitur nama rilis. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Tampilan Putih Label Solusi).","untuk detail implementasi di Saluran,","Saluran","context":"Saluran Capgo fitur nama rilis. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Tampilan Putih Label Solusi)." Solusi Pengujian Beta untuk alur kerja produk dalam Solusi Pengujian Beta, dan Solusi Target Versi untuk alur kerja produk dalam Solusi Target Versi.

Cara Menggunakan Saluran untuk Flag Fitur dan Uji Coba A/B