React Native SDK - Inicializar el SDK

Opciones de configuración para el método constructor del tracker de iOS React Native

React Native SDK ⁠-⁠ Inicializar el SDK

La siguiente línea instalará el tracker y, con él, el SDK para que puedas aprovechar todas las funciones del tracker.

npm i @openreplay/react-native

Al instanciar el tracker de OpenReplay, hay varias opciones de configuración que puedes proporcionar para personalizar muchos aspectos de la grabación y de la experiencia de grabación. Debes establecer la opción projectKey en el constructor. Puedes obtener este valor desde tu panel de OpenReplay en ‘Preferences > Projects’.

Añadir el código de seguimiento

Section titled Añadir el código de seguimiento

Añade el siguiente código a tu archivo raíz:

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'
	);
}, [])

Para rastrear las interacciones del usuario dentro de la aplicación, deberás añadir los siguientes componentes a tu aplicación:

  • ORTouchTrackingView - añadido a nivel raíz para rastrear las interacciones táctiles
  • ORTrackedInput - wrapper alrededor del Input de React-Native que envía señales cada vez que el usuario termina de escribir
  • ORSanitizedView - difumina el contenido que hay dentro
// 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>
	)
}

Consulta cómo sanear datos en las repeticiones de React Native para más detalles.

Por defecto, todas las opciones están marcadas como true:

  • crashes: Bool Habilita crashlytics.
  • analytics: Bool Habilita el seguimiento analítico de las vistas marcadas.
  • performances: Bool Habilita el listener de rendimiento.
  • logs: Bool Habilita el listener de logs.
  • screen: Bool Habilita el grabador de pantalla.

Conoce los módulos del SDK de React Native

Si tienes alguna pregunta sobre este proceso, no dudes en contactarnos en nuestro Slack o consulta nuestro Foro.