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

Capgo’s sistem saluran 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 asosiasi saluran secara mandiri.

Mengerti Saluran

Saluran di Capgo memungkinkan Anda untuk:

• Targetkan kelompok pengguna spesifik dengan fitur yang berbeda
• Jalankan uji coba A/B dengan mengalokasikan pengguna ke saluran yang berbeda
• Roll out fitur baru secara bertahap
• Buat program tes beta

Metode Pengalokasian Saluran

1. Pengalokasian Backend (Dianjurkan)

Ini adalah metode yang lebih aman. Ini melibatkan:

1. Mengambil ID perangkat dari pembarui
2. Mengirimkannya ke backend Anda
3. Backend Anda memanggil Capgo API untuk mengalokasikan 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:

1. Dapatkan kunci API dari Capgo dashboard
2. Panggil Capgo API untuk menetapkan perangkat ke saluran

Untuk mendapatkan kunci API Anda:

1. Masuk ke dashboard Capgo Anda
2. Pergi ke Pengaturan > API Keys
3. Klik “Generate New Key”
4. Pilih all mode untuk mengelola perangkat dan saluran
5. 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 terungkap di sisi klien code

Contoh Node.js 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:

• Mengvalidasi hak akses pengguna
• Mengikuti semua pengaturan saluran
• Mengatur batasan kecepatan
• Mengimplementasikan logika ulang untuk pengaturan yang gagal

2. Pengasosiasi Sendiri (Lebih Tidak Aman)

Methode ini memungkinkan perangkat untuk langsung mengasosiasi diri mereka ke sebuah 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 mengasosiasi diri mereka ke sebuah saluran, Anda perlu mengaktifkan fitur ini di Capgo dashboard:

1. Pergi ke bagian Saluran di dashboard Capgo Anda
2. Klik nama saluran yang ingin Anda kelola
3. Dalam pengaturan saluran, aktifkan “Izinkan perangkat untuk mengasosiasi sendiri”
4. Simpan perubahan-perubahan ini

Jika pengaturan ini palsu, setiap upaya untuk memanggil setChannel dengan saluran ini akan gagal.

Mengimplementasikan Flag Fitur

Pakai saluran untuk mengontrol akses fitur:

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

Pengimplementasian Uji Coba A/B

Lakukan uji coba A/B dengan mengasosiasikan pengguna ke saluran 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. Pakai Metode Pengasosiasian Backend: Untuk produksi, selalu gunakan metode pengasosiasian backend
2. Penasasan Konsisten: Gunakan ID pengguna atau identifikasi stabil lainnya untuk penasasan saluran yang konsisten
3. PengawasanPantau penggunaan fitur dan metrik kinerja untuk setiap saluran
4. Rollout Berangsur-angsurMulai dengan segmen pengguna kecil dan secara bertahap memperluas
5. Dokumentasi JelasDokumentasikan strategi saluran dan tujuan Anda

Kesimpulan

Dengan memanfaatkan sistem saluran Capgo Anda dapat membuat pengalaman aplikasi yang lebih personal dan menjalankan tes A/B. Untuk penggunaan produksi, selalu prefer metode pengasasan backend untuk keamanan dan kontrol yang lebih baik.

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

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

Jika Anda menggunakan __CAPGO_KEEP_0__ Cara Menggunakan Saluran untuk Flag Fitur dan Uji Coba A/B untuk merencanakan routing saluran dan peluncuran tahap demi tahap, hubungkannya dengan Saluran untuk detail implementasi di Saluran, Saluran untuk detail implementasi di Saluran, Saluran untuk detail implementasi di Saluran, Solusi Uji Coba Beta untuk alur kerja produk di Solusi Uji Coba Beta, dan Solusi Target Versi untuk alur kerja produk di Solusi Target Versi.