連携の前提条件

1. Node.js
   
2. npm
   
3. Watchman
   
4. React Native CLI
   

1. Android Studio
   
2. Android SDK
   
3. Gradle
   
4. Java Development Kit（JDK）
   

連携の前提条件

React NativeアプリケーションへのPageSense Android SDKのインストール

Android向けReact Nativeライブラリー

1. react-android – JavaScript実行環境とネイティブモジュールとの通信を可能にする、Android向けのコアReact Nativeランタイムライブラリーです。
2. hermes-android（任意）– パフォーマンス向上と起動時間短縮のためにReact Nativeアプリケーションで使用されるJavaScriptエンジンです。

1. ReactContextBaseJavaModule
   
2. ReactMethod
   
3. PromiseReadableMap
   
4. ReactPackage
   
5. ReactApplicationContext
   

1. ReactContextBaseJavaModule
   
2. ReactMethod
   
3. Promise
   
4. ReadableMap
   
5. ReactPackage
   
6. ReactApplicationContext
   

ネイティブブリッジモジュールの作成

1. Kotlinネイティブモジュールの実装
   
2. React Nativeパッケージの実装
   
3. React Nativeパッケージの登録
   

1. インポート { NativeModules } from 'react-native';
2.  
3. // React Nativeブリッジを通じて公開されているネイティブモジュールを抽出します。
4. const { PageSenseSDKModule } = NativeModules;
5.  
6. /**
7. * PageSenseSDKWrapperは、JavaScriptインターフェイスを提供します。
8. * React Nativeのネイティブブリッジを介してPageSense SDKと連携するためのものです。
9. */
10. class PageSenseSDKWrapper {
11.  
12. /**
13. * PageSense SDKを初期化します。アプリケーションの起動時に1回だけ呼び出してください。
14. * @param {string} accountId - PageSenseアカウントの識別子。
15. * @param {string} sdkKey - 認証に使用するSDKキー。
16. * @param {string} projectName - PageSenseプロジェクトの名前。
17. * @returns {Promise<boolean>} true = 初期化成功、false = 失敗
18. */
19. async initialiseSDK(accountId, sdkKey, projectName) {
20. try {
21. this._validateString(accountId, 'accountId');
22. this._validateString(sdkKey, 'sdkKey');
23. this._validateString(projectName, 'projectName');
24. const result = await PageSenseSDKModule.initialiseSDK(accountId, sdkKey, projectName);
25. return result === true;
26. } catch (error) {
27. console.log('[PageSenseSDK] initialiseSDK error:', error);
28. return false;
29. }
30. }
31.  
32. /**
33. * エクスペリメントを有効化し、割り当てられたバリエーションを返します。
34. * @param {string} experimentName - エクスペリメントの名前。
35. * @param {string} userId - 一意のユーザー識別子。
36. * @param {Object.<string, string>} [attributes] - 任意のユーザー属性。
37. * @returns {Promise<string|null>} バリエーション名。バリエーションがない場合またはエラーの場合はnull
38. */
39. async activateExperiment(experimentName, userId, attributes) {
40. try {
41. this._validateString(experimentName, 'experimentName');
42. this._validateString(userId, 'userId');
43. this._validateAttributes(attributes);
44. const safeAttributes = attributes || {};
45. const variation = await PageSenseSDKModule.activateExperiment(
46. experimentName, userId, safeAttributes
47. );
48. return variation ?? null;
49. } catch (error) {
50. console.log('[PageSenseSDK] activateExperiment error:', error);
51. return null;
52. }
53. }
54.  
55. /**
56. * エクスペリメントを有効化せずにバリエーション名を取得します。
57. * @param {string} experimentName - エクスペリメントの名前。
58. * @param {string} userId - 一意のユーザー識別子。
59. * @param {Object.<string, string>} [attributes] - 任意のユーザー属性。
60. * @returns {Promise<string|null>} バリエーション名。利用できない場合またはエラーの場合はnull
61. */
62. async getVariationName(experimentName, userId, attributes) {
63. try {
64. this._validateString(experimentName, 'experimentName');
65. this._validateString(userId, 'userId');
66. this._validateAttributes(attributes);
67. const safeAttributes = attributes || {};
68. const variation = await PageSenseSDKModule.getVariationName(
69. experimentName, userId, safeAttributes
70. );
71. return variation ?? null;
72. } catch (error) {
73. console.log('[PageSenseSDK] getVariationName error:', error);
74. return null;
75. }
76. }
77.  
78. /**
79. * エクスペリメントのゴールイベントをトラッキングします。
80. * @param {string} experimentName - エクスペリメントの名前。
81. * @param {string} userId - 一意のユーザー識別子。
82. * @param {string} goalName - ゴールの名前。
83. * @param {Object.<string, string>} [attributes] - 任意のゴール属性。
84. * @returns {void}
85. */
86. trackGoal(experimentName, userId, goalName, attributes) {
87. try {

1. /**
2. * ルートアプリケーションコンポーネントは、アプリの起動時に PageSense SDK を初期化します。
3. * SDK の初期化が完了してから UI をレンダリングします。
4. */
5. export default function App() {
6.  
7. const [sdkReady, setSdkReady] = useState(false);
8.  
9. useEffect(() => {
10. async function initializeSDK() {
11. try {
12. const result = await PageSenseSDKWrapper.initialiseSDK(
13. 'PAGESENSE_ACCOUNT_ID', // PageSense アカウントID
14. 'PAGESENSE_SDK_KEY', // SDKキー
15. 'PAGESENSE_PROJECT_NAME', // プロジェクト名
16. );
17. console.log('PageSense SDK の初期化に成功しました：', result);
18. setSdkReady(true);
19. } catch (error) {
20. console.log('PageSense SDK の初期化エラー：', error);
21. // SDK の初期化に失敗してもアプリの処理は続行します
22. setSdkReady(true);
23. }
24. }
25. initializeSDK();
26. }, []);
27.  
28. if (!sdkReady) {
29. return (
30. <View style={styles.loadingContainer}>
31. <ActivityIndicator size='large' />
32. <Text style={styles.loadingText}>アプリを初期化しています...</Text>
33. </View>
34. );
35. }
36.  
37. return (
38. ....アプリケーション UI の実装
39. );
40. }
    

実験の有効化

目標の追跡