Assistenza/Guide di installazione
Guide di installazione

React Native / Expo

Integra Flowsery Analytics nella tua app React Native o Expo con l'entrypoint dedicato flowsery/react-native del pacchetto npm di Flowsery Analytics.

1. Installa l'SDK

Installa il pacchetto insieme alle peer dependency richieste:

Terminal
npm install flowsery @react-native-async-storage/async-storage @react-native-community/netinfo expo-constants expo-device

2. Imposta le variabili d'ambiente

Nel tuo progetto Expo, definisci queste variabili d'ambiente (per esempio in .env e nella configurazione di Expo):

  • EXPO_PUBLIC_FLOWSERY_WEBSITE_ID -- l'ID del sito web di Flowsery Analytics (per esempio flid_******)
  • EXPO_PUBLIC_FLOWSERY_DOMAIN -- deve corrispondere al dominio configurato nelle impostazioni del sito in Flowsery Analytics (per le app mobile puoi usare qualcosa come yourapp.com)

3. Avvolgi la tua app con FlowseryProvider

Avvolgi l'albero di navigazione con il componente provider:

JavaScript
import { FlowseryProvider } from 'flowsery/react-native';
 
export default function RootLayout() {
  return (
    <FlowseryProvider
      config={{
        websiteId: process.env.EXPO_PUBLIC_FLOWSERY_WEBSITE_ID!,
        // Must match the domain configured in your Flowsery Analytics website settings
        domain: process.env.EXPO_PUBLIC_FLOWSERY_DOMAIN!,
        debug: __DEV__,
      }}>
      {/* your navigation / screens here */}
    </FlowseryProvider>
  );
}
JavaScript
import { useFlowseryScreen } from 'flowsery/react-native';
 
export default function HomeScreen() {
  useFlowseryScreen('HomeScreen');
  return <YourScreenUI />;
}
JavaScript
import { Pressable, Text } from 'react-native';
import { useFlowseryTrack } from 'flowsery/react-native';
 
export function CTAButton() {
  const track = useFlowseryTrack();
 
  return (
    <Pressable onPress={() => track('cta_click', { source: 'home_screen' })}>
      <Text>Tap to send a test event</Text>
    </Pressable>
  );
}
JavaScript
import { useFlowsery } from 'flowsery/react-native';
 
export async function onLoginSuccess(user) {
  const client = useFlowsery();
  await client?.identify(user.id, {
    email: user.email,
    name: user.name,
  });
}

5. Perché servono i pacchetti aggiuntivi?

L'entrypoint flowsery/react-native si appoggia a:

  • AsyncStorage per l'archiviazione persistente
  • NetInfo per rilevare lo stato della rete
  • Expo Constants / Device (quando disponibili) per i metadati dell'app e del dispositivo

Per questo quei pacchetti React Native / Expo aggiuntivi vanno installati insieme a flowsery.