Comment utiliser les canaux pour les indicateurs de fonctionnalité et les tests A/B

Le système de canaux de CapGo offre un moyen flexible de segmenter les utilisateurs et de contrôler l’accès aux fonctionnalités. Bien que CapGo ne dispose pas de gestion de plan intégrée ou de tests A/B, vous pouvez mettre en œuvre ces fonctionnalités en gérant vous-même les affectations de canaux.

Comprendre les canaux

Les canaux dans CapGo vous permettent de :

Cibler des groupes d’utilisateurs spécifiques avec différentes fonctionnalités
Effectuer des tests A/B en assignant des utilisateurs à différents canaux
Déployer progressivement de nouvelles fonctionnalités
Créer des programmes de test bêta

Méthodes d’affectation des canaux

1. Affectation Backend (Recommandé)

C’est la méthode la plus sécurisée. Elle implique :

Obtenir l’ID de l’appareil depuis l’updater
L’envoyer à votre backend
Votre backend appelle l’API CapGo pour affecter l’appareil

Voici comment l’implémenter :

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

Mise en œuvre Backend

Votre backend doit :

Obtenir une clé API depuis le tableau de bord CapGo
Appeler l’API CapGo pour affecter l’appareil à un canal

Pour obtenir votre clé API :

Connectez-vous à votre tableau de bord CapGo
Allez dans Paramètres > Clés API
Cliquez sur “Générer une nouvelle clé”
Sélectionnez le mode all pour gérer les appareils et les canaux
Copiez la clé générée et conservez-la en toute sécurité dans vos variables d’environnement backend
- La clé sera une chaîne hexadécimale de 32 caractères
- C’est une clé secrète qui ne doit jamais être exposée dans le code côté client

Voici un exemple 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
  }
}

Le backend doit également :

Valider les autorisations de l’utilisateur
Enregistrer toutes les affectations de canaux
Gérer la limitation de débit
Implémenter une logique de réessai pour les affectations échouées

2. Auto-Affectation (Moins Sécurisé)

Cette méthode permet aux appareils de s’auto-affecter directement à un canal. Elle est utile pour les tests mais moins sécurisée pour la production :

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
}

Avant que les utilisateurs puissent s’auto-affecter à un canal, vous devez activer cette fonctionnalité dans le tableau de bord CapGo :

Allez dans la section Canaux de votre tableau de bord CapGo
Cliquez sur le nom du canal que vous souhaitez gérer
Dans les paramètres du canal, activez “Autoriser les appareils à s’auto-associer”
Enregistrez les modifications

Si ce paramètre est faux, toute tentative d’appeler setChannel avec ce canal échouera.

Mise en œuvre des indicateurs de fonctionnalité

Utilisez des canaux pour contrôler l’accès aux fonctionnalités :

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

Mise en œuvre des tests A/B

Effectuez des tests A/B en assignant des utilisateurs à différents canaux :

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
}

Meilleures pratiques

Utiliser l’affectation Backend : Pour la production, utilisez toujours la méthode d’affectation backend
Affectation cohérente : Utilisez des identifiants utilisateur ou d’autres identifiants stables pour une affectation cohérente des canaux
Surveillance : Suivez l’utilisation des fonctionnalités et les métriques de performance pour chaque canal
Déploiements progressifs : Commencez par de petits segments d’utilisateurs et étendez-vous progressivement
Documentation claire : Documentez votre stratégie de canal et vos objectifs

Conclusion

En tirant parti du système de canaux de CapGo, vous pouvez créer des expériences d’application plus personnalisées et réaliser des tests A/B. Pour une utilisation en production, privilégiez toujours la méthode d’affectation backend pour une meilleure sécurité et un meilleur contrôle.

Pour plus de détails sur la gestion des canaux, consultez notre documentation sur les canaux.

Comment utiliser les canaux pour les drapeaux de fonctionnalité et les tests A/B