---
title: forterMobileUID
slug: pCV3-fortermobileuid
createdAt: 2025-07-28T23:08:28.157Z
---

## なぜForterはユニーク識別子が必要なのか？

### SDK内で

ForterのSDKは、SDKによって収集された活動および行動データを特定のデバイスとユーザーに接続するために、ユニークなモバイルデバイス識別子を必要とします。この識別子はAndroidデバイスに特有である必要があります。

### Order API内で

顧客がモバイルアプリから購入を行う場合、ユニーク識別子は**必須**として、`forterMobileUID`の値を`connectionInformation`オブジェクトに含める必要があります。[Forter Orders API](https://docs.forter.com/reference/order-v3)。Orders APIの呼び出しは完全にシステムのバックエンドから行われるため、このIDはHTTPSリクエストヘッダーから取得可能であり、**同じケース**でForter SDKで生成された値と一致する必要があります。

```java
{
  "orderId": "Example_order_fdse0gb449",
  "orderType": "ANDROID",
  "timeSentToForter": 1415287568000,
  "checkoutTime": 1415273168,
  "connectionInformation": {
    "customerIP": "174.255.8.151",
    "userAgent": "testStore 4.92.203 rv:203 (Android; Linux: 24 7.0; en_US; LGL158VL)",
    "forterMobileUID": "2f37b5d22ca986caaaaa4d3b7e02fc152c93186bd4_c2Vzc2lvbnRva2VuaGVyZQ==_CF4_ES4",
    "mobileAppVersion": "4.70.103"
  },
  "totalAmount": {
    "amountUSD": "99.95"
  }
}
```

## ユニーク識別子（MobileUID）を生成して渡す

以下のForter SDKメソッドを使用して、AndroidデバイスIDを取得してください。

```java
ForterIntegrationUtils.getDeviceUID(this)
```

**SDKバージョン3.0.0以上の場合：**

- 返される値は、[Forterトークンリスナーコールバック](https://portal.forter.com/docs/android/android_content/starting_the_sdk/android_application_class#fortersdk-300-and-above)として、`forterMobileUID`を[connectionInformation](https://portal.forter.com/api/data-objects/ConnectionInformation)オブジェクトのサーバーサイドOrder APIに使用する必要があります。

**SDKバージョン3.0.0未満の場合：**

- によって返される値 `ForterIntegrationUtils.getDeviceUID` は `forterMobileUID` として使用されるべきです [connectionInformation](https://portal.forter.com/api/data-objects/ConnectionInformation) サーバーサイドのOrder APIのオブジェクト内で。

### ケース

SDKに渡されるdeviceId（MobileUID）がOrder APIに渡される際にケースが変わらないことを確認してください。Forterのシステムにはケースの好みはありませんが、SDKを介して生成されたmobileUIDは、トランザクション時にOrder APIに渡されるmobileUIDのケースと一致する必要があります。そうしないと、ForterのシステムはSDKデータをバックエンドのOrder APIデータに正しく接続できません。

## アカウント識別子の渡し方

### ログイン時

ユーザーの既存のアカウントIDを **ログイン時** にAndroidアプリに提供してください:

```java
ForterSDK.getInstance().setAccountUID(ForterAccountIDType.MERCHANT_ACCOUNT_ID, accountUid);
```

### ログアウト時

同じ `setAccountUID` メソッドを呼び出し、アカウントIDには空の文字列を渡してください。

:::hint{type="warning"}
アカウント識別子は、Order APIの `merchantDeviceId` フィールドに渡されるべきであり、 `forterMobileUID` フィールドには渡されるべきではありません。
:::

:::hint{type="danger"}
**個人を特定できる情報（PII）を識別子として提供しないでください。[個人を特定できる情報（PII）](https://en.wikipedia.org/wiki/Personally_identifiable_information)**を識別子として提供しないでください。ユーザーのメールアドレスをIDとして使用する場合は、送信する前にエンコード/ハッシュしてください。
:::