React Native SDK - SDK initialisieren
Installation
Section titled InstallationMit der folgenden Zeile installieren Sie den Tracker und damit das SDK, sodass Sie alle Funktionen des Trackers nutzen können.
npm i @openreplay/react-native
Initialisierung
Section titled InitialisierungBeim Instanziieren des OpenReplay-Trackers stehen Ihnen mehrere Konfigurationsoptionen zur Verfügung, mit denen Sie viele Aspekte der Aufzeichnung und der Aufzeichnungserfahrung anpassen können. Sie müssen die Option projectKey im Konstruktor festlegen. Diesen Wert finden Sie in Ihrem OpenReplay-Dashboard unter ‘Preferences > Projects’.
Tracking-Code hinzufügen
Section titled Tracking-Code hinzufügenFügen Sie den folgenden Code in Ihre Root-Datei ein:
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'
);
}, [])
Erweiterte Komponenten hinzufügen
Section titled Erweiterte Komponenten hinzufügenUm Benutzerinteraktionen innerhalb der App zu erfassen, müssen Sie Ihrer Anwendung die folgenden Komponenten hinzufügen:
ORTouchTrackingView- wird auf der Root-Ebene hinzugefügt, um Touch-Interaktionen zu erfassenORTrackedInput- Wrapper um den React-Native-Input, der Signale sendet, sobald der Benutzer die Eingabe abgeschlossen hatORSanitizedView- verwischt den darin enthaltenen Inhalt
// 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>
)
}
Daten bereinigen
Section titled Daten bereinigenWeitere Informationen finden Sie unter So bereinigen Sie Daten in React-Native-Replays.
Initialisierungsoptionen
Section titled InitialisierungsoptionenStandardmäßig sind alle Optionen auf true gesetzt:
crashes: BoolAktiviert Crashlytics.analytics: BoolAktiviert das Analytics-Tracking markierter Ansichten.performances: BoolAktiviert den Performance-Listener.logs: BoolAktiviert den Logs-Listener.screen: BoolAktiviert den Screen Recorder.
Methoden
Section titled MethodenDie Module des React Native SDK kennenlernen
Haben Sie Fragen?
Section titled Haben Sie Fragen?Wenn Sie Fragen zu diesem Vorgang haben, melden Sie sich gerne bei uns im Slack .