forterMobileUID
iOS ユニーク識別子
Forterはなぜユニーク識別子が必要なのか?
SDK内で
ForterのSDKは、SDKによって収集された活動および行動データを特定のデバイスとユーザーに接続するために、ユニークなモバイルデバイス識別子を必要とします。この識別子はiOSデバイスに特有である必要があります。
Order API内で
顧客がモバイルアプリから購入を行う場合、ユニーク識別子は必須として、forterMobileUIDの値をconnectionInformationオブジェクトに含める必要があります。Order API。Order APIの呼び出しは完全にシステムのバックエンドから行われるため、このIDはHTTPSリクエストヘッダーから取得可能であり、Forter SDKで生成された値と同じケースである必要があります。
ネイティブモバイルアプリの注文の場合、以下のフィールドが入力されていることを確認してください:
- orderType: "MOBILE", "iOS", または "ANDROID" あなたのOSに応じて(モバイルはどちらのOSでも使用できます)
- forterMobileUID: あなたのアプリが完全にネイティブである場合、チェックアウトページを含めて、代わりに入力されるべきですforterTokenCookie
- mobileAppVersion: ユーザーが使用しているアプリのバージョンを反映するべきです
{
"orderId": "Example_order_fdse0rr489",
"orderType": "iOS",
"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_c2Vzc2lvbnRva2VuaGVyZQ==_CF4_ES4",
"mobileAppVersion": "18.4.1"
},
"totalAmount": {
"amountUSD": "99.95"
}
...
}SDKバージョン3.0.0以上の場合:
- 返される値は、Forterトークンリスナーコールバックは、サーバーサイドのOrder APIのconnectionInformationオブジェクト内のforterMobileUIDとして使用されるべきです。
SDKバージョン3.0.0以前の場合:
- ForterSDKの setDeviceUniqueIdentifier メソッドに渡される値は、サーバーサイドのOrder APIの connectionInformation オブジェクト内の forterMobileUID として使用されるべきです。
ケース
SDKに渡されるdeviceId(MobileUID)がOrder APIに渡される際にケースが変わらないことを確認してください。Forterのシステムにはケースの好みはありませんが、SDKを介して生成されたmobileUIDは、トランザクション時にOrder APIに渡されるmobileUIDのケースと一致する必要があります。そうしないと、ForterのシステムはSDKデータをバックエンドのOrder APIデータに正しく接続できません。SDKとバックエンドAPIの間でデータが一貫していることを確認するために、toUpperCase() または toLowerCase() のような関連するロジックやメソッドを含めてください。
アカウント識別子を提供する(推奨)
アプリが別のアカウント識別子やソーシャルネットワークコネクタ/サードパーティ認証メカニズムを利用している場合は、それらのサードパーティサービスから受け取ったアカウントIDを提供してください。
注意 アカウント識別子はOrder APIの merchantDeviceId フィールドに渡されるべきであり、NOT forterMobileUIDフィールドには渡されるべきではありません。
例えば: Facebookソーシャルコネクタを使用している場合、次のようにアカウントIDを提供できます:
[[ForterSDK sharedInstance] setAccountIdentifier:@"the FB account id"
withType:FTRSDKAccountIdTypeFacebook];現在のモバイルアプリで使用されている既存のアカウント識別子を渡すには、次のようにします。
[[ForterSDK sharedInstance] setAccountIdentifier:@"The user's account ID"
withType:FTRSDKAccountIdTypeMerchant];個人を特定できる情報(PII)を識別子として提供しないでください。個人を特定できる情報(PII)を識別子として提供しないでください。ユーザーのメールアドレスをIDとして使用する場合は、送信する前にエンコード/ハッシュしてください。