Cómo usar Canales para Feature Flags y Pruebas A/B

El sistema de canales de CapGo proporciona una forma flexible de segmentar usuarios y controlar el acceso a funcionalidades. Aunque CapGo no tiene gestión de planes o pruebas A/B integradas, puedes implementar estas características gestionando tú mismo las asignaciones de canales.

Entendiendo los Canales

Los canales en CapGo te permiten:

• Dirigirte a grupos específicos de usuarios con diferentes funcionalidades
• Ejecutar pruebas A/B asignando usuarios a diferentes canales
• Implementar nuevas funcionalidades gradualmente
• Crear programas de pruebas beta

Métodos de Asignación de Canales

1. Asignación desde Backend (Recomendado)

Este es el método más seguro. Implica:

1. Obtener el ID del dispositivo desde el actualizador
2. Enviarlo a tu backend
3. Tu backend llama a la API de CapGo para asignar el dispositivo

Así es como implementarlo:

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

Implementación del Backend

Tu backend necesita:

1. Obtener una clave API del panel de CapGo
2. Llamar a la API de CapGo para asignar el dispositivo a un canal

Para obtener tu clave API:

1. Inicia sesión en tu panel de CapGo
2. Ve a Configuración > Claves API
3. Haz clic en “Generar Nueva Clave”
4. Selecciona el modo all para gestionar dispositivos y canales
5. Copia la clave generada y guárdala de forma segura en las variables de entorno de tu backend
   • La clave será una cadena hexadecimal de 32 caracteres
   • Es una clave secreta que nunca debe exponerse en código del lado del cliente

Aquí hay un ejemplo en 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
  }
}

El backend también debe:

• Validar los permisos del usuario
• Registrar todas las asignaciones de canales
• Manejar la limitación de velocidad
• Implementar lógica de reintento para asignaciones fallidas

2. Auto-asignación (Menos Seguro)

Este método permite que los dispositivos se asignen directamente a un canal. Es útil para pruebas pero menos seguro para producción:

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
}

Antes de que los usuarios puedan auto-asignarse a un canal, necesitas habilitar esta función en el panel de CapGo:

1. Ve a la sección de Canales en tu panel de CapGo
2. Haz clic en el nombre del canal que quieres gestionar
3. En la configuración del canal, habilita “Permitir que los dispositivos se auto-asocien”
4. Guarda los cambios

Si esta configuración es falsa, cualquier intento de llamar a setChannel con este canal fallará.

Implementando Feature Flags

Usa canales para controlar el acceso a funcionalidades:

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

Implementación de Pruebas A/B

Ejecuta pruebas A/B asignando usuarios a diferentes canales:

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
}

Mejores Prácticas

1. Usa Asignación desde Backend: Para producción, siempre usa el método de asignación desde backend
2. Asignación Consistente: Usa IDs de usuario u otros identificadores estables para una asignación consistente de canales
3. Monitoreo: Rastrea el uso de funcionalidades y métricas de rendimiento para cada canal
4. Implementaciones Graduales: Comienza con segmentos pequeños de usuarios y expande gradualmente
5. Documentación Clara: Documenta tu estrategia y propósitos de canales

Conclusión

Al aprovechar el sistema de canales de CapGo, puedes crear experiencias de aplicación más personalizadas y ejecutar pruebas A/B. Para uso en producción, siempre prefiere el método de asignación desde backend para mejor seguridad y control.

Para más detalles sobre la gestión de canales, consulta nuestra documentación de canales.