Pomoc/Przewodniki instalacji
Przewodniki instalacji

React Native / Expo

Zintegruj Flowsery Analytics z aplikacją React Native lub Expo za pomocą dedykowanego punktu wejścia flowsery/react-native z pakietu npm Flowsery Analytics.

1. Zainstaluj SDK

Zainstaluj pakiet wraz z wymaganymi zależnościami peer:

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

2. Ustaw zmienne środowiskowe

W projekcie Expo zdefiniuj te zmienne środowiskowe (na przykład w pliku .env i konfiguracji Expo):

  • EXPO_PUBLIC_FLOWSERY_WEBSITE_ID: identyfikator witryny we Flowsery Analytics (np. flid_******)
  • EXPO_PUBLIC_FLOWSERY_DOMAIN: musi odpowiadać domenie skonfigurowanej w ustawieniach witryny we Flowsery Analytics (w aplikacjach mobilnych możesz użyć np. yourapp.com)

3. Opakuj aplikację komponentem FlowseryProvider

Opakuj drzewo nawigacji komponentem providera:

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. Dlaczego potrzebne są dodatkowe pakiety?

Punkt wejścia flowsery/react-native korzysta z:

  • AsyncStorage do trwałego przechowywania danych
  • NetInfo do wykrywania stanu sieci
  • Expo Constants / Device (jeśli są dostępne) do metadanych aplikacji i urządzenia

Dlatego te dodatkowe pakiety React Native / Expo trzeba zainstalować razem z flowsery.