React Native SDK - Inicializando o SDK

Opções de configuração do método construtor do tracker React Native para iOS

React Native SDK ⁠-⁠ Inicializando o SDK

A linha a seguir instala o tracker e, com ele, o SDK, para que você aproveite todos os recursos do tracker.

npm i @openreplay/react-native

Ao instanciar o tracker do OpenReplay, há várias opções de configuração que você pode fornecer para personalizar muitos aspectos da gravação e da experiência de gravação. Você deve definir a opção projectKey no construtor. Você pode obter esse valor no dashboard do OpenReplay, em ‘Preferences > Projects’.

Adicionando o código de rastreamento

Section titled Adicionando o código de rastreamento

Adicione o código a seguir ao seu arquivo raiz:

import Openreplay from '@openreplay/react-native';

// ...
useEffect(() => {
	Openreplay.tracker.startSession(
		'yourProjectKey',
		options, // explained below, set {} if empty
		'https://local.openreplay.instance/ingest' // if you're using our Serverless/SaaS plan then 'https://api.openreplay.com/ingest'
	);
}, [])

Adicionando componentes aprimorados

Section titled Adicionando componentes aprimorados

Para rastrear as interações dos usuários dentro do app, você precisará adicionar os componentes a seguir à sua aplicação:

  • ORTouchTrackingView - adicionado no nível raiz para rastrear interações de toque
  • ORTrackedInput - wrapper em torno do Input do React-Native que envia sinais sempre que o usuário termina de preencher o input
  • ORSanitizedView - desfoca o conteúdo interno
// App.tsx
import Openreplay from '@openreplay/react-native';

function App() {
	const start = () => {
	    Openreplay.tracker.startSession(
	      process.env.REACT_APP_KEY!,
	      {},
	      process.env.REACT_APP_INGEST
	    );
	    Openreplay.tracker.setMetadata('key', 'value');
	    Openreplay.tracker.setUserID('user-id');
	    Openreplay.patchNetwork(global, () => false, {});
	};
	
	React.useEffect(() => start(), []);
	
	return (
		// this top-level view is required to track touch interactions
		<Openreplay.ORTouchTrackingView style={styles.container}> 
		      <View style={styles.container}>
		         <Openreplay.ORTrackedInput
		          style={styles.input}
		          onChangeText={onChangeNumber}
		          value={number}
		          placeholder="Trackable input"
		          numberOfLines={1}
		        />
		
		        <Openreplay.ORSanitizedView style={styles.sanitizedView}>
		          <Text>Contents of this view are sanitized and invisible on the recording</Text>
		        </Openreplay.ORSanitizedView>
		      </View>
		</Openreplay.ORTouchTrackingView>
	)
}

Consulte como sanitizar dados em replays do React Native para mais detalhes.

Por padrão, todas as opções estão definidas como true:

  • crashes: Bool Habilita o crashlytics.
  • analytics: Bool Habilita o rastreamento de analytics das views marcadas.
  • performances: Bool Habilita o listener de desempenho.
  • logs: Bool Habilita o listener de logs.
  • screen: Bool Habilita o gravador de tela.

Conheça os módulos do SDK React Native

Se você tiver alguma dúvida sobre este processo, fique à vontade para entrar em contato conosco no nosso Slack.