Suporte/Guias de instalação
Guias de instalação

React Native / Expo

Integre o Flowsery Analytics no seu aplicativo React Native ou Expo usando o entrypoint dedicado flowsery/react-native do pacote npm do Flowsery Analytics.

1. Instalar o SDK

Instale o pacote junto com as dependências peer necessárias:

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

2. Definir variáveis de ambiente

No seu projeto Expo, defina estas variáveis de ambiente (por exemplo em .env e na sua configuração Expo):

  • EXPO_PUBLIC_FLOWSERY_WEBSITE_ID -- seu website ID do Flowsery Analytics (ex.: flid_******)
  • EXPO_PUBLIC_FLOWSERY_DOMAIN -- deve corresponder ao domínio configurado nas configurações do seu website no Flowsery Analytics (para aplicativos móveis, você pode usar algo como yourapp.com)

3. Envolver seu aplicativo com FlowseryProvider

Envolva sua árvore de navegação com o 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. Por que os pacotes extras?

O entrypoint flowsery/react-native depende de:

  • AsyncStorage para armazenamento persistente
  • NetInfo para detectar o estado da rede
  • Expo Constants / Device (quando disponíveis) para metadata do aplicativo e do dispositivo

É por isso que esses pacotes adicionais de React Native / Expo devem ser instalados junto com o flowsery.