統合ガイド

前提条件

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

統合手順

1. SDKを初期化する

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

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 
);

次の情報を提供する必要があります:

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

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

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

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

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

ForterSDK 3.0.0以上

組み込みのトークン更新リスナーを使用してトークン更新に登録します。ここで受け取ったトークンは、Order APIに必要であり、forterMobileUID属性の値である必要があります。

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バージョンの場合、初期化後にアクティビティライフサイクルコールバックを登録します:

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

完全な統合例

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

@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());
    }
}