---
title: 統合ガイド
slug: NR8zr5Bx8bPNNuYRAYKeK
createdAt: 2025-07-28T23:08:28.157Z
---

## 前提条件

この **ForterSDK** は、アプリケーションのメインコンテキストから初期化する必要があります。まだアプリケーションクラスを設定していない場合は:

1. 次の [アプリケーションクラスを作成します](https://developer.android.com/reference/android/app/Application.html)
2. [AndroidManifest.xmlに登録します](http://stackoverflow.com/questions/2929562/register-application-class-in-manifest)

## 統合手順

### 1. SDKを初期化する

アプリケーションクラスの `onCreate()` メソッドに次の初期化コードを追加します:

```java
String deviceUid = ForterIntegrationUtils.getDeviceUID(this);

// Get ForterSDK instance and initiate it with the application context
IForterSDK ftr = ForterSDK.getInstance();
ftr.init(this,
        AppConstants.FORTER_SITE_ID,
        deviceUid 
);
```

:::hint{type="warning"}
次の情報を提供する必要があります:

1. 有効なForterサイトID（デバッグ目的でのみテストサイトIDを使用してください）
2. 現在のAndroidデバイスに特有のユニークなデバイス識別子、できれば `ForterIntegrationUtils.getDeviceUID`
:::

:::hint{type="info"}
SDKの高度な設定は、カスタマイズされたForterSDKConfigurationでSDKを初期化することによって行うことができます。デフォルトの設定を変更する前に、Forterの実装エンジニアに相談してください。
:::

### 2. コールバックを登録する

アプリケーションクラスの `onCreate()` メソッドでSDKを初期化した後、ForterSDKのコールバックを登録してください。

コールバック登録プロセスは、あなたのForterSDKのバージョンによって異なります。

**ForterSDK 3.0.0以上**

組み込みのトークン更新リスナーを使用してトークン更新に登録します。ここで受け取ったトークンは、[Order API](https://docs.forter.com/mobile-sdks/fortermobileuid#-6ZrK)に必要であり、`forterMobileUID`属性の値である必要があります。

```java
ForterSDK.getInstance().registerForterTokenListener(new ForterTokenListener() {
      @Override
      public void onForterTokenUpdate(@NonNull String forterToken) {
           // This block is called whenever the Forter token is updated.
           // Use `forterToken` for the Order API.
      }
});
```

**ForterSDK 3.0.0未満のバージョン**

古いSDKバージョンの場合、初期化後にアクティビティライフサイクルコールバックを登録します:

```java
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
	registerActivityLifecycleCallbacks(ftr.getActivityLifecycleCallbacks());
}
```

***

## 完全な統合例

上記の手順を実行した後、あなたの`onCreate()`メソッドは次のようになります:

```java
@Override
public void onCreate() {
    super.onCreate();
    String mobileId = ForterIntegrationUtils.getDeviceUID(this);
    
    // Get ForterClient instance and initiate it
    IForterSDK ftr = ForterSDK.getInstance();
    ftr.init(this,
            AppConstants.FORTER_SITE_ID, // your unique Forter site ID
            mobileId // your device identifier
    );
    
    // Register for token updates (ForterSDK >= 3.0.0)
    ForterSDK.getInstance().registerForterTokenListener(new ForterTokenListener() {
        @Override
        public void onForterTokenUpdate(String forterMobileUID) {
            // Forter token updated
        }
    });

    // Start generic activity-based navigation tracking (ForterSDK < 3.0.0)
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
        registerActivityLifecycleCallbacks(ftr.getActivityLifecycleCallbacks());
    }
}
```
