React Native SDK - Inicializando o SDK
Instalação
Section titled InstalaçãoA 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
Inicialização
Section titled InicializaçãoAo 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 rastreamentoAdicione 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 aprimoradosPara 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 toqueORTrackedInput- wrapper em torno do Input do React-Native que envia sinais sempre que o usuário termina de preencher o inputORSanitizedView- 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>
)
}
Sanitizar dados
Section titled Sanitizar dadosConsulte como sanitizar dados em replays do React Native para mais detalhes.
Opções de inicialização
Section titled Opções de inicializaçãoPor padrão, todas as opções estão definidas como true:
crashes: BoolHabilita o crashlytics.analytics: BoolHabilita o rastreamento de analytics das views marcadas.performances: BoolHabilita o listener de desempenho.logs: BoolHabilita o listener de logs.screen: BoolHabilita o gravador de tela.
Métodos
Section titled MétodosConheça os módulos do SDK React Native
Tem dúvidas?
Section titled Tem dúvidas?Se você tiver alguma dúvida sobre este processo, fique à vontade para entrar em contato conosco no nosso Slack.