React Native SDK - Инициализация SDK

Параметры конфигурации для метода-конструктора трекера iOS React Native

React Native SDK ⁠-⁠ Инициализация SDK

Следующая строка установит трекер, а вместе с ним и SDK, чтобы вы могли воспользоваться всеми возможностями трекера.

npm i @openreplay/react-native

При создании экземпляра трекера OpenReplay доступно несколько параметров конфигурации, которые вы можете задать, чтобы настроить многие аспекты записи и процесса записи. Вы должны указать параметр projectKey в конструкторе. Вы можете получить это значение в панели управления OpenReplay в разделе ‘Preferences > Projects’.

Добавление кода отслеживания

Section titled Добавление кода отслеживания

Добавьте следующий код в ваш корневой файл:

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

Добавление расширенных компонентов

Section titled Добавление расширенных компонентов

Чтобы отслеживать взаимодействия пользователя внутри приложения, вам потребуется добавить в ваше приложение следующие компоненты:

  • ORTouchTrackingView - добавляется на корневом уровне для отслеживания касаний
  • ORTrackedInput - обёртка вокруг Input из React-Native, которая отправляет сигналы каждый раз, когда пользователь завершает ввод
  • ORSanitizedView - размывает содержимое внутри
// 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>
	)
}

Подробнее см. как очищать данные в записях React Native.

Параметры инициализации

Section titled Параметры инициализации

По умолчанию все параметры установлены в значение true:

  • crashes: Bool Включает crashlytics.
  • analytics: Bool Включает аналитическое отслеживание помеченных представлений.
  • performances: Bool Включает слушатель производительности.
  • logs: Bool Включает слушатель логов.
  • screen: Bool Включает запись экрана.

Познакомьтесь с модулями React Native SDK

Остались вопросы?

Section titled Остались вопросы?

Если у вас есть какие-либо вопросы по этому процессу, не стесняйтесь обращаться к нам в нашем Slack или загляните на наш Форум.