Amazon Fraud Detector は、2025 年 11 月 7 日をもって新規顧客に公開されなくなりました。Amazon Fraud Detector と同様の機能については、Amazon SageMaker、AutoGluon、および を参照してください AWS WAF。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 変数 変数は、不正予測で使用するデータ要素を表します。これらの変数は、モデルのトレーニング用に準備したイベントデータセット、Amazon Fraud Detector モデルのリスクスコア出力、または Amazon SageMaker AI モデルから取得できます。イベントデータセットから取得される変数の詳細については、「」を参照してください[データモデルエクスプローラーを使用してイベントデータセットの要件を取得する](create-event-dataset.md#prepare-event-dataset)。 不正予測で使用する変数は、まず作成し、イベントタイプを作成するときにイベントに追加する必要があります。作成する各変数には、データ型、デフォルト値、およびオプションで変数型を割り当てる必要があります。Amazon Fraud Detector は、IP アドレス、銀行識別番号 (BINs)、電話番号など、指定した変数の一部を強化して、追加の入力を作成し、これらの変数を使用するモデルのパフォーマンスを向上させます。 ## データ型 変数には、変数が表すデータ要素のデータ型が必要です。オプションで、事前定義された のいずれかを割り当てることができます[変数タイプ](#variable-types)。変数タイプに割り当てられた変数の場合、データ型が事前に選択されています。可能なデータ型には、次の型が含まれます。 | データ型 | 説明 | デフォルトの値 | 値の例 | | --- | --- | --- | --- | | String | 文字、整数、またはその両方の任意の組み合わせ | <空> | abc、123、1D3B | | 整数 | 正または負の整数 | 0 | 1、-1 | | ブール値 | True または False | 誤 | True、False | | DateTime | ISO 8601 標準 UTC 形式で指定された日時のみ | <空> | 2019-11-30T13:01:01Z | | 浮動小数点数 | 小数点のある数字 | 0.0 | 4.01、0.10 | ## デフォルトの値 変数にはデフォルト値が必要です。Amazon Fraud Detector が不正予測を生成する場合、Amazon Fraud Detector が変数の値を受信しない場合、このデフォルト値はルールまたはモデルを実行するために使用されます。指定するデフォルト値は、選択したデータ型と一致する必要があります。AWS コンソールでは、Amazon Fraud Detector は整数`0`の場合は 、ブール値`false`の場合は 、浮動小数点`0.0`数の場合は 、文字列の場合は (空) のデフォルト値を割り当てます。これらのデータ型のいずれかにカスタムデフォルト値を設定できます。 ## 変数タイプ 変数を作成するときは、オプションで変数タイプに変数を割り当てることができます。変数型は、モデルのトレーニングと不正予測の生成に使用される一般的なデータ要素を表します。モデルトレーニングに使用できるのは、関連する変数タイプを持つ変数のみです。モデルトレーニングプロセスの一環として、Amazon Fraud Detector は変数に関連付けられた変数タイプを使用して、変数エンリッチメント、特徴量エンジニアリング、リスクスコアリングを実行します。 Amazon Fraud Detector には、変数に割り当てるために使用できる次の変数タイプが事前に定義されています。 - **Session** - **変数タイプ:** IP\_ADDRESS / **説明:** イベント中に収集される IP アドレス / **データ型:** String / **例:** 192.0.2.0 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[位置情報エンリッチメント](#geolocation-enrichment)を参照してください。 - **変数タイプ:** USERAGENT / **説明:** イベント中に収集されるユーザーエージェント / **データ型:** String / **例:** Mozilla 5.0 (Windows NT 10.0、Win64、x64、rv:68.0)" 20100101 - **変数タイプ:** FINGERPRINT / **説明:** イベントに使用されるデバイスの一意の識別子 / **データ型:** String / **例:** sadfow987u234 - **変数タイプ:** SESSION\_ID / **説明:** イベントのアクティブなセッションのセッション ID / **データ型:** String / **例:** sid123456789 - **変数タイプ:** ARE\_CREDENTIALS\_VALID / **説明:** イベントログインに使用される認証情報が有効かどうかを示します / **データ型:** ブール値 / **例:** 正 - **ユーザー** - **変数タイプ:** EMAIL\_ADDRESS / **説明:** イベント中に収集された E メールアドレス / **データ型:** String / **例:** abc@domain.com - **変数タイプ:** PHONE\_NUMBER / **説明:** イベント中に収集された電話番号 / **データ型:** String / **例:** \+1 555-0100 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[電話番号エンリッチメント](#phone-number-enrichment)を参照してください。 - **料金** - **変数タイプ:** BILLING\_NAME / **説明:** 請求先住所に関連付けられている名前 / **データ型:** String / **例:** John Doe - **変数タイプ:** BILLING\_PHONE / **説明:** 請求先住所に関連付けられている電話番号 / **データ型:** String / **例:** \+1 555-0100 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[電話番号エンリッチメント](#phone-number-enrichment)を参照してください。 - **変数タイプ:** BILLING\_ADDRESS\_L1 / **説明:** 請求先住所の最初の行 / **データ型:** String / **例:** 任意の通り - **変数タイプ:** BILLING\_ADDRESS\_L2 / **説明:** 請求先住所の 2 行目 / **データ型:** String / **例:** 任意のユニット 123 - **変数タイプ:** BILLING\_CITY / **説明:** 請求先住所の市区町村 / **データ型:** String / **例:** 任意の市区町村 - **変数タイプ:** BILLING\_STATE / **説明:** 請求先住所にある州または都道府県 / **データ型:** String / **例:** 任意の州または都道府県 - **変数タイプ:** BILLING\_COUNTRY / **説明:** 請求先住所の国 / **データ型:** String / **例:** 任意の国 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[位置情報エンリッチメント](#geolocation-enrichment)を参照してください。 - **変数タイプ:** BILLING\_ZIP / **説明:** 請求先住所にある郵便番号 / **データ型:** String / **例:** 01234 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[位置情報エンリッチメント](#geolocation-enrichment)を参照してください。 - **配送** - **変数タイプ:** SHIPPING\_NAME / **説明:** 配送先住所に関連付けられている名前 / **データ型:** String / **例:** John Doe - **変数タイプ:** SHIPPING\_PHONE / **説明:** 配送先住所に関連付けられている電話番号 / **データ型:** String / **例:** \+1 555-0100 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[電話番号エンリッチメント](#phone-number-enrichment)を参照してください。 - **変数タイプ:** SHIPPING\_ADDRESS\_L1 / **説明:** 配送先住所の最初の行 / **データ型:** String / **例:** 123 Any Street - **変数タイプ:** SHIPPING\_ADDRESS\_L2 / **説明:** 配送先住所の 2 行目 / **データ型:** String / **例:** Unit 123 - **変数タイプ:** SHIPPING\_CITY / **説明:** 配送先住所の市区町村 / **データ型:** String / **例:** 任意の市区町村 - **変数タイプ:** SHIPPING\_STATE / **説明:** 配送先住所にある州または都道府県 / **データ型:** String / **例:** 任意の状態 - **変数タイプ:** SHIPPING\_COUNTRY / **説明:** 配送先住所の国 / **データ型:** String / **例:** 任意の国 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[位置情報エンリッチメント](#geolocation-enrichment)を参照してください。 - **変数タイプ:** SHIPPING\_ZIP / **説明:** 配送先住所にある郵便番号 / **データ型:** String / **例:** 01234 **注:** Amazon Fraud Detector はこのデータを強化します。詳細については、[位置情報エンリッチメント](#geolocation-enrichment)を参照してください。 - **Payment** - **変数タイプ:** ORDER\_ID / **説明:** トランザクションの一意の識別子 / **データ型:** String / **例:** LUX60 - **変数タイプ:** 料金 / **説明:** 合計注文価格 / **データ型:** String / **例:** 560.00 - **変数タイプ:** CURRENCY / **説明:** ISO 4217 通貨コード / **データ型:** String / **例:** USD - **変数タイプ:** PAYMENT\_TYPE / **説明:** イベント中の支払いに使用される支払い方法 / **データ型:** String / **例:** クレジットカード - **変数タイプ:** AUTH\_CODE / **説明:** クレジットカード発行者または発行銀行によって送信される英数字コード / **データ型:** String / **例:** 0000 - **変数タイプ:** AVS / **説明:** カードプロセッサからのアドレス検証システム (AVS) レスポンスコード / **データ型:** String / **例:** はい - **製品** - **変数タイプ:** PRODUCT\_CATEGORY - **説明:** 注文項目の製品カテゴリ - **データ型:** String - **例:** キッチン - **カスタム** - **変数タイプ:** NUMERIC / **説明:** 実数として表現できる任意の変数 / **データ型:** 浮動小数点数 / **例:** 1.224 - **変数タイプ:** CATEGORICAL / **説明:** カテゴリ、セグメント、またはグループを記述する変数 / **データ型:** String / **例:** 大 - **変数タイプ:** FREE\_FORM\_TEXT / **説明:** イベントの一部としてキャプチャされた自由形式のテキスト (顧客レビューやコメントなど) / **データ型:** String / **例:** フリーフォームテキスト入力の例 ### 変数タイプへの変数の割り当て モデルのトレーニングに変数を使用する場合は、変数に割り当てる適切な変数タイプを選択することが重要です。変数タイプの割り当てが正しくないと、モデルのパフォーマンスに悪影響を及ぼす可能性があります。また、特に複数のモデルやイベントが 変数を使用している場合は、後で割り当てを変更するのが非常に難しくなる可能性があります。 変数は、事前定義された変数型のいずれか、または `FREE_FORM_TEXT`、、 `CATEGORICAL`のいずれかのカスタム変数型を割り当てることができます`NUMERIC`。 **適切な変数タイプに変数を割り当てるための重要な注意事項** 1. 変数が事前定義された変数タイプの 1 つと一致する場合は、それを使用します。変数タイプが 変数に対応していることを確認します。たとえば、*ip\_address* 変数を`EMAIL_ADDRESS`変数型に割り当てると、ip\_address 変数は ASN、ISP、地理的位置、リスクスコアなどのエンリッチメントで強化されません。詳細については、「[変数エンリッチメント](#variable-enrichments)」を参照してください。 1. 変数が事前定義された変数タイプのいずれとも一致しない場合は、以下の推奨事項に従って、カスタム変数タイプのいずれかを割り当てます。 1. 通常、自然な順序がなく、カテゴリ、セグメント、またはグループに配置できる変数に変数`CATEGORICAL`タイプを割り当てます。モデルのトレーニングに使用するデータセットには、 *merchant\_id*、 *campaign\_id*、*policy\_id* などの ID 変数がある場合があります。これらの変数はグループを表します (たとえば、同じ policy\_id を持つすべての顧客はグループを表します）。次のデータを持つ変数には、CATEGORICAL 変数タイプ - を割り当てる必要があります。 + *customer\_ID*、*segment\_ID*、*color\_ID*、*Department\_code*、*product\_ID* などのデータを含む変数。 + true、false、または null 値を持つブールデータを含む変数。 + 会社名、製品カテゴリ、カードタイプ、紹介メディアなどのグループまたはカテゴリに含めることができる変数。 **注記** `ENTITY_ID` は、Amazon Fraud Detector が ENTITY\_ID 変数に割り当てるために使用される予約変数タイプです。ENTITY\_ID 変数は、評価するアクションを開始するエンティティの ID です。トランザクション不正インサイト (TFI) モデルタイプを作成する場合は、ENTITY\_ID 変数を指定する必要があります。データ内のどの変数がアクションを開始したエンティティを一意に識別し、それを ENTITY\_ID 変数として渡すかを決定する必要があります。CATEGORICAL 変数タイプが存在する場合、およびモデルトレーニングに使用している場合は、データセット内の他のすべての IDs に CATEGORICAL 変数タイプを割り当てます。データセット内のエンティティではない他の IDs の例は、 *merchant\_ID*、*policy\_ID*、および *campaign\_ID* です。 1. テキストのブロックを含む`FREE_FORM_TEXT`変数に変数タイプを割り当てます。Free\_FORM\_TEXT 変数タイプの例: *ユーザーレビュー*、*コメント*、*日付*、*紹介コード*。Free\_FORM\_TEXT データには、区切り記号で区切られた複数のトークンが含まれています。区切り文字は、英数字とアンダースコア記号以外の任意の文字にすることができます。たとえば、ユーザーレビューとコメントは「スペース」区切り文字で区切ることができ、日付と参照コードは区切り文字としてハイフンを使用してプレフィックス、サフィックス、中間部分を区切ることができます。Amazon Fraud Detector は、区切り記号を使用して、FreeFree\_FORM\_TEXT 変数からデータを抽出します。 1. *NUMERIC* 変数タイプを実数であり、固有の順序を持つ変数に割り当てます。NUMERIC 変数の例としては、*day\_of\_the\_week*、*incident\_severity*、*customer\_rating* などがあります。これらの変数には CATEGORICAL 変数タイプを割り当てることができますが、固有の順序を持つすべての実数変数を NUMERIC 変数タイプに割り当てることを強くお勧めします。 ## 変数エンリッチメント Amazon Fraud Detector は、IP アドレス、銀行識別番号 (BINs)、電話番号など、提供する未加工のデータ要素の一部を強化して、追加の入力を作成し、これらのデータ要素を使用するモデルのパフォーマンスを向上させます。エンリッチメントは、疑わしい可能性のある状況を特定し、モデルがより多くの不正をキャプチャするのに役立ちます。 ### 電話番号エンリッチメント Amazon Fraud Detector は、位置情報、元のキャリア、電話番号の有効性に関連する追加情報で電話番号データを強化します。電話番号エンリッチメントは、2*021 年 12 月 13 日以降にトレーニングされ、*国コード (\+xxx) を含む電話番号を持つすべてのモデルで自動的に有効になります。モデルに電話番号変数を含め、2*021 年 12 月 13 *日より前にトレーニングした場合は、このエンリッチメントを活用できるようにモデルを再トレーニングしてください。 電話番号変数に次の形式を使用して、データが正常に強化されるようにすることを強くお勧めします。 | 変数 | 形式 | 説明 | | --- | --- | --- | | PHONE\_NUMBER | [E.164](https://en.wikipedia.org/wiki/E.164) 標準 | 電話番号に国コード (\+xxx) を必ず含めてください。 | | BILLING\_PHONE と SHIPPING\_PHONE | [E.164](https://en.wikipedia.org/wiki/E.164) 標準 | 電話番号に国コード (\+xxx) を必ず含めてください。 | ### 位置情報エンリッチメント *2022 年 2 月 8 日以降、*Amazon Fraud Detector は、イベントに指定した IP\_ADDRESS、BILLING\_ZIP、および SHIPPING\_ZIP 値の物理的な距離を計算します。計算された距離は、不正検出モデルへの入力として使用されます。 位置情報エンリッチメントを有効にするには、イベントデータに IP\_ADDRESS、BILLING\_ZIP、または SHIPPING\_ZIP の 3 つの変数の少なくとも 2 つが含まれている必要があります。さらに、各 BILLING\_ZIP および SHIPPING\_ZIP 値には、それぞれ有効な BILLING\_COUNTRY コードと SHIPPING\_COUNTRY コードが必要です。2*022 年 2 月 8 日より前にトレーニングされたモデルがあり、*これらの変数が含まれている場合は、そのモデルを再トレーニングして位置情報エンリッチメントを有効にする必要があります。 データが無効であるために、Amazon Fraud Detector がイベントの IP\_ADDRESS、BILLING\_ZIP、または SHIPPING\_ZIP 値に関連付けられている場所を特定できない場合、代わりに特別なプレースホルダー値が使用されます。たとえば、イベントに有効な IP\_ADDRESS 値と BILLING\_ZIP 値があるが、SHIPPING\_ZIP 値が無効であるとします。この場合、エンリッチメントは IP\_ADDRESS–> BILLING\_ZIP に対してのみ行われます。エンリッチメントは、IP\_ADDRESS–>SHIPPING\_ZIP および BILLING\_ZIP–>SHIPPING\_ZIP では行われません。代わりに、プレースホルダー値が代わりに使用されます。モデルで位置情報エンリッチメントが有効になっているかどうかにかかわらず、モデルのパフォーマンスは変わりません。 BILLING\_ZIP 変数と SHIPPING\_ZIP 変数を CUSTOM\_CATEGORICAL 変数タイプにマッピングすることで、位置情報エンリッチメントをオプトアウトできます。変数タイプを変更しても、モデルのパフォーマンスには影響しません。 **位置情報変数形式** 位置情報データが正常に強化されるように、位置情報変数には次の形式を使用することを強くお勧めします。 | 変数 | 形式 | 説明 | | --- | --- | --- | | IP\_ADDRESS | [IPv4 アドレス](https://en.wikipedia.org/wiki/IP_address#IPv4_addresses) | 例 - 1.1.1.1 | | BILLING\_ZIP と SHIPPING\_ZIP | 指定された国の [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 郵便番号 | 詳細については、このトピックの「国と地域のコード」セクションを参照してください。 | | BILLING\_COUNTRY と SHIPPING\_COUNTRY | [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 2 文字の標準国コード | 詳細については、このトピックの「国と地域のコード」セクションを参照してください。Amazon Fraud Detector は、国名の一般的なバリエーションをすべて ISO 3166-1 2 文字の標準国コードと照合しようとします。ただし、それらが正しく一致することを保証することはできません。 | #### 国と地域のコード 次の表は、Amazon Fraud Detector で位置情報エンリッチメントがサポートされている国と地域の詳細なリストです。各国と地域には、国コード (特に ISO 3166-1 alpha-2 2 文字の国コード) と郵便番号が割り当てられます。 **郵便番号形式** + 9 - 数値 + a - 文字 + [X] - X はオプションです。例えば、ガースニーGY9[9] 9aa」はGY9 9aa」とGY99 9aa」の両方が有効であることを意味します。1 つの形式を使用します。 + [X/XX] - X または XX を使用できます。たとえば、「aa[aa/99]」とは、「aa aa」と「aa 99」の両方が有効であることを意味します。これらの形式のいずれかを使用しますが、両方*を使用しないでください*。 + 一部の国では、プレフィックスが固定されています。例えば、Andorra の郵便番号は AD999 です。つまり、国コードは *AD* 文字で始まり、その後に 3 つの数字が続く必要があります。 | コード | 名前 | 郵便番号 | | --- | --- | --- | | AD | アンドラ | AD999 | | AR | オランダ領アンティル | 9999 | | AT | オーストリア | 9999 | | AU | オーストラリア | 9999 | | AZ | アゼルバイジャン | AZ 9999 | | BD | バングラデシュ | 9999 | | BE | ベルギー | 9999 | | BG | ブルガリア | 9999 | | BM | バミューダ | aa[aa/99] | | BY | ベラルーシ | 999999 | | CA | カナダ | a9a 9a9 | | CH | スイス | 9999 | | CL | チリ | 9999999 | | CO | コロンビア | 999999 | | CR | コスタリカ | 99999 | | CY | キプロス | 9999 | | CZ | チェコ共和国 | 999 99 | | DE | ドイツ | 99999 | | DK | デンマーク | 9999 | | DO | ドミニカ共和国 | 99999 | | DZ | アルジェリア | 99999 | | EE | エストニア | 99999 | | ES | スペイン | 99999 | | FI | フィンランド | 99999 | | FM | ミクロネシア連邦 | 99999 | | FO | フェロー諸島 | 999 | | FR | フランス | 99999 | | GB | 英国 | a[a]9[a/9] 9aa | | GG | ガーンジー代官管轄区 | GY9[9] 9aa | | GL | グリーンランド | 9999 | | GP | グアドループ | 99999 | | GT | グアテマラ | 99999 | | GU | グアム | 99999 | | HR | クロアチア | 99999 | | hu | ハンガリー | 9999 | | IE | アイルランド | a99[a/9][a/9][a/9][a/9] | | IM | マン島 | IM9[9]9aa | | IN | インド | 999999 | | IS | Iceland | 999 | | IT | イタリア | 99999 | | JE | Jersey | JE9[9]9aa | | JP | 日本 | 999-9999 | | KR | 韓国 | 99999 | | LI | リヒテンシュタイン | 9999 | | LK | スリランカ | 99999 | | LT | リトアニア | 99999 | | LU | ルクセンブルグ | L-9999 | | LV | ラトビア | LV-9999 | | MC | モナコ | 99999 | | MD | モルドバ共和国 | 9999 | | MH | マーシャル諸島共和国 | 99999 | | MK | 北マケドニア | 9999 | | MP | 北マリアナ諸島 | 99999 | | MQ | マティニーク | 99999 | | MT | マルタ | aaa 9999 | | MX | メキシコ | 99999 | | MY | マレーシア | 99999 | | NL | オランダ | 9999 aa | | いいえ | ノルウェー | 9999 | | NZ | ニュージーランド | 9999 | | PH | フィリピン | 9999 | | PK | パキスタン | 99999 | | PL | ポーランド | 99-999 | | PR | プエルトリコ | 99999 | | PT | ポルトガル | 9999-999 | | PW | パラオ | 99999 | | RE | レユニオン | 99999 | | RO | ルーマニア | 999999 | | RU | ロシア連邦 | 999999 | | SE | スウェーデン | 999 99 | | SG | シンガポール | 999999 | | SI | スロベニア | 9999 | | SK | スロバキア | 999 99 | | SM | サンマリノ | 99999 | | TH | タイ | 99999 | | TR | トルコ | 99999 | | UA | ウクライナ | 99999 | | 米国 | アメリカ | 99999 | | UY | ウルグアイ | 99999 | | VI | 米領バージン諸島 | 99999 | | WF | ウォリス・フツナ | 99999 | | YT | マヨット | 99999 | | ZA | 南アフリカ | 9999 | ### ユーザーエージェントのエンリッチメント Account Takeover Insights (ATI) モデルを作成する場合は、データセットに変数タイプの`useragent`変数を指定する必要があります。この変数には、ログインイベントのブラウザ、デバイス、OS データが含まれます。Amazon Fraud Detector は、`OS_family`、、 `user_agent_family` などの追加情報でユーザーエージェントデータを強化します`device_family`。