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-device2. 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 esempioflid_******)EXPO_PUBLIC_FLOWSERY_DOMAIN-- deve corrispondere al dominio configurato nelle impostazioni del sito in Flowsery Analytics (per le app mobile puoi usare qualcosa comeyourapp.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.