---
title: 不正検知モバイルSDK(React Native)
slug: japanese/fraud-react-native-jp
docTags: 
createdAt: 2025-07-02T14:58:37.822Z
---

### 概要 ➿

ForterのReact Nativeプラグインは以下のSDKに対して作成されています。

- [Forter's iOS SDK](https://docs.forter.com/mobile-sdks/ios-sdk-overview)
- [Forter's Android SDK](https://docs.forter.com/mobile-sdks/android-sdk-overview)

### インストール

ご利用の`package.json`ファイルにForterの依存関係を追加します。

```json
{
 "dependencies": {
       "forter-react-plugin": "<forter-plugin-bitbucket-link>#v0.1.17"
  },
}
```

### iOS 📱

1. `ForterSDK` podおよびReact Native podを自身の`Podfile`に追加して、`pod install`を実行します。

```podspec
pod 'ForterSDK', :git => '<forter-ios-sdk-bitbucket-link>forter-ios-sdk.git'
pod 'react-native-forter', :path => '../node_modules/forter-react'
```

:::hint{type="info"}
**ReactNative 0.60より前のバージョンを実行している場合は、**
[こちら](https://facebook.github.io/react-native/docs/next/troubleshooting.html#missing-libraries-for-react)に記載されているように、`Podfile`でReactの依存関係を定義する必要があります。
:::

1. `pod install`を実行する (`ios` ディレクトリ内で).

### Android 💚

1. `android/settings.gradle`
   を編集します。

   ```java
   include ':react-native-forter'
   project(':react-native-forter').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-forter/android')
   ```
2. 以下の`android/app/build.gradle`を追加して、ForterのプライベートMavenリポジトリを追加します。

```java
repositories {
  maven {
    url "https:<forter-android-sdk-link>/android"
    credentials {
      username "username" // provided in Forter's portal documentation
      password "password" // provided in Forter's portal documentation
    }
  }
}
```

:::hint{type="info"}
**🔥**
***注**：ReactNative 0.60以上を使用している場合は、以下のステップは不要です。* 🔥
:::

1. **プロジェクトのリンク**：シェルから`react-native link react-native-forter`をプロジェクトルートで実行するか、または手動で追加します。
2. **依存関係にプロジェクトを追加する**

   ```java
     dependencies {
       ...
       compile project(':react-native-forter')
     }
   ```
3. 最後に、以下のコードをアプリに追加して、Forterのモジュールを登録します。

```java
import com.forter.mobile.reactnative.RNForterPackage;

    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            //...
            new RNForterPackage(MainApplication.this)
            //...
      );
    }
```

### JavaScript設定

アプリケーションの`index.js`に、カスタムイベントトラッキングとともに以下のJavaScriptコードを追加します。

```javascript
import {forterSDK, ForterActionType, ForterNavigationType} from 'react-native-forter';

AppRegistry.registerComponent(appName, () => App);

var myForterID = "1e34987a83" // Modify this with your Forter Site ID

forterSDK.setDevLogsEnabled();
forterSDK.getDeviceUniqueID( (deviceID) => {
    console.warn("deviceID = " + deviceID + " merchant=" + myForterID);
    forterSDK.init(myForterID, deviceID, (successResult) => {
        console.warn("OK: " + successResult);
    }, (errorResult) => {
        console.warn("FAIL: " + errorResult);
    });
});
 
// Examples for custom tracking
forterSDK.trackNavigation('mainpage', ForterNavigationType.PRODUCT);
forterSDK.trackAction(ForterActionType.ADD_TO_CART)
```

### テスト

（サンドボックス環境のSiteIdを使用して）サンドボックス環境でモバイルSDKを連携すると、Sandbox Mobile Events Viewerを使用して、Forterに渡されるイベントの特定のmobileUIDを調べることができます。これにより開発者は、Forterがモバイル イベントをどのように受け取り、保存しているかを可視化することができます。

![](https://files.readme.io/0a2d6ef-mobile_viewer.png)

### バックエンドおよびForter APIリクエストにmobileUIDを含める

ネイティブのモバイルアプリケーションで注文が行われたときにForter SDKで生成されたmobileUIDを、バックエンドに送信します。これによりForterは、モバイル アプリケーションで収集された行動やネットワークに関するデータを、バックエンドから送信された注文データに連結させることができます。

1. **orderType**: ご利用のOSに応じて`"MOBILE"`、`"iOS"`、`"ANDROID"`のいずれか。（`"MOBILE"`は、OSがiOS、Androidいずれの場合も使用できます）
2. **forterMobileUID**: アプリが、決済ページも含めて完全にネイティブなアプリの場合は、`forterTokenCookie`ではなく、このフィールドにデータが挿入されるようにします。決済ページでWebviewを使用している場合は、[Webview Integration](https://docs.forter.com/docs/fraud-webview-integrations-jp)を参照してください。
3. **mobileAppVersion**: ユーザーが使用しているアプリのバージョンが反映されるようにします。

**API実行例**

```javascript
{
  "orderId": "Example_react_or06349",
  "orderType": "MOBILE",
  "timeSentToForter": 1415287568000,
  "checkoutTime": 1415273168,
  "connectionInformation": {
    "customerIP": "107.57.208.5",
    "userAgent": "testStore 18.4.1 rv:184100001 (iPhone; iOS 12.4.1; en_US; iPhone10,3)",
    "forterMobileUID": "6A9798AG16FF41F7B6B9878DD488ADD5", 
    "mobileAppVersion": "18.4.1"
  },
  "totalAmount": {
    "amountUSD": "99.95"
  }
  ...
}
```