forterMobileUID

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

SDK内で

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

Order API内で

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

{
  "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を取得してください。

ForterIntegrationUtils.getDeviceUID(this)

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

返される値は、Forterトークンリスナーコールバックとして、forterMobileUIDをconnectionInformationオブジェクトのサーバーサイドOrder APIに使用する必要があります。

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

によって返される値 ForterIntegrationUtils.getDeviceUID は forterMobileUID として使用されるべきです connectionInformation サーバーサイドのOrder APIのオブジェクト内で。

ケース

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

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

ログイン時

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

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

ログアウト時

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

アカウント識別子は、Order APIの merchantDeviceId フィールドに渡されるべきであり、 forterMobileUID フィールドには渡されるべきではありません。

個人を特定できる情報（PII）を識別子として提供しないでください。個人を特定できる情報（PII）を識別子として提供しないでください。ユーザーのメールアドレスをIDとして使用する場合は、送信する前にエンコード/ハッシュしてください。