截至 2025 年 11 月 7 日，亚马逊 Fraud Detector 不再向新客户开放。要获得与 Amazon Fraud Detector 类似的功能 SageMaker，请浏览亚马逊 AutoGluon、和 AWS WAF。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 变量
变量表示您要在欺诈预测中使用的数据元素。这些变量可以取自您为训练模型准备的事件数据集、Amazon Fraud Detector 模型的风险评分输出或亚马逊 SageMaker AI 模型。有关从事件数据集中获取的变量的更多信息，请参阅[使用数据模型浏览器获取事件数据集要求](create-event-dataset.md#prepare-event-dataset)。
必须先创建要在欺诈预测中使用的变量，然后在创建事件类型时将其添加到事件中。您创建的每个变量都必须分配一个数据类型、一个默认值以及一个可选的变量类型。Amazon Fraud Detector 丰富了您提供的一些变量，例如 IP 地址、银行识别码 (BINs) 和电话号码，以创建更多输入并提高使用这些变量的模型的性能。
## 数据类型
变量必须具有变量所表示的数据元素的数据类型，并且可以选择为其分配一个预定义的数据类型[变量类型](#variable-types)。对于分配给变量类型的变量，会预先选择数据类型。可能的数据类型包括以下类型：
| 数据类型 | 说明 | 默认 值 | 示例值 |
| --- | --- | --- | --- |
| 字符串 | 字母、整数或两者的任意组合 | | abc、123、1D3B |
| 整数 | 正整数或负整数 | 0 | 1, -1 |
| 布尔值 | 对还是错 | False | True, False |
| DateTime | 仅以 ISO 8601 标准 UTC 格式指定的日期和时间 | | 2019-11-30T 13:01:01 Z |
| 浮点型 | 带小数点的数字 | 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 已预先定义了以下变量类型，这些变量类型可用于分配给您的变量。
- **会话**
- **变量类型:** IP\_ADDRESS / **说明:** 活动期间收集的 IP 地址 / **数据类型:** 字符串 / **示例:** 192.0.2.0 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [丰富地理定位](#geolocation-enrichment)。
- **变量类型:** 用户代理 / **说明:** 活动期间收集的用户代理 / **数据类型:** 字符串 / **示例:** Mozilla 5.0（Windows NT 10.0、Win64、x64、rv: 68.0）Gecko 20100101
- **变量类型:** 指纹 / **说明:** 用于事件的设备的唯一标识符 / **数据类型:** 字符串 / **示例:** sadfow987u234
- **变量类型:** SESSION\_ID / **说明:** 活动会话的会话 ID / **数据类型:** 字符串 / **示例:** sid123456789
- **变量类型:** 证书是否有效 / **说明:** 表示用于活动登录的凭据是否有效 / **数据类型:** 布尔值 / **示例:** True
- **用户**
- **变量类型:** 电子邮件地址 / **说明:** 活动期间收集的电子邮件地址 / **数据类型:** 字符串 / **示例:** abc@domain.com
- **变量类型:** PHONE\_NUMBER / **说明:** 活动期间收集的电话号码 / **数据类型:** 字符串 / **示例:** \+1 555-0100 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [电话号码充实](#phone-number-enrichment)。
- **计费**
- **变量类型:** 账单名称 / **说明:** 与账单地址关联的名称 / **数据类型:** 字符串 / **示例:** John Doe
- **变量类型:** 账单\_电话 / **说明:** 与账单地址关联的电话号码 / **数据类型:** 字符串 / **示例:** \+1 555-0100 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [电话号码充实](#phone-number-enrichment)。
- **变量类型:** 账单地址\_L1 / **说明:** 账单地址的第一行 / **数据类型:** 字符串 / **示例:** 任何街道
- **变量类型:** 账单地址\_L2 / **说明:** 账单地址的第二行 / **数据类型:** 字符串 / **示例:** 任何单位 123
- **变量类型:** BILLING\_CITY / **说明:** 账单地址中的城市 / **数据类型:** 字符串 / **示例:** 任何城市
- **变量类型:** 账单状态 / **说明:** 账单地址中的州或省 / **数据类型:** 字符串 / **示例:** 任何州或省
- **变量类型:** 账单国家 / **说明:** 账单地址中的国家/地区 / **数据类型:** 字符串 / **示例:** 任何国家 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [丰富地理定位](#geolocation-enrichment)。
- **变量类型:** BILLING\_ZIP / **说明:** 账单地址中的邮政编码 / **数据类型:** 字符串 / **示例:** 01234 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [丰富地理定位](#geolocation-enrichment)。
- **运输**
- **变量类型:** 配送名称 / **说明:** 与送货地址相关的名称 / **数据类型:** 字符串 / **示例:** John Doe
- **变量类型:** 配送电话 / **说明:** 与送货地址关联的电话号码 / **数据类型:** 字符串 / **示例:** \+1 555-0100 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [电话号码充实](#phone-number-enrichment)。
- **变量类型:** 配送地址\_L1 / **说明:** 收货地址的第一行 / **数据类型:** 字符串 / **示例:** 123 Any Street
- **变量类型:** 配送地址\_L2 / **说明:** 收货地址的第二行 / **数据类型:** 字符串 / **示例:** 123 号单元
- **变量类型:** 配送城市 / **说明:** 收货地址中的城市 / **数据类型:** 字符串 / **示例:** 任何城市
- **变量类型:** 配送状态 / **说明:** 收货地址中的州或省 / **数据类型:** 字符串 / **示例:** 任何州
- **变量类型:** 配送国家 / **说明:** 收货地址中显示的是所在的国家/地区 / **数据类型:** 字符串 / **示例:** 任何国家 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [丰富地理定位](#geolocation-enrichment)。
- **变量类型:** 配送\_ZIP / **说明:** 收货地址中的邮政编码 / **数据类型:** 字符串 / **示例:** 01234 **注意：**Amazon Fraud Detector 丰富了这些数据。有关更多信息，请参阅 [丰富地理定位](#geolocation-enrichment)。
- **Payment**
- **变量类型:** 订单编号 / **说明:** 交易的唯一标识符 / **数据类型:** 字符串 / **示例:** LUX60
- **变量类型:** 价格 / **说明:** 订单总价 / **数据类型:** 字符串 / **示例:** 560.00
- **变量类型:** 货币代码 / **说明:** ISO 4217 货币代码 / **数据类型:** 字符串 / **示例:** USD
- **变量类型:** 付款类型 / **说明:** 活动期间用于付款的付款方式 / **数据类型:** 字符串 / **示例:** 信用卡
- **变量类型:** AUTH\_CODE / **说明:** 由信用卡发卡机构或发卡行发送的字母数字代码 / **数据类型:** 字符串 / **示例:** 0000
- **变量类型:** AVS / **说明:** 来自卡处理器的地址验证系统 (AVS) 响应码 / **数据类型:** 字符串 / **示例:** Y
- **产品**
- **变量类型:** 产品\_类别
- **说明:** 订单商品的商品类别
- **数据类型:** 字符串
- **示例:** 厨房
- **自定义**
- **变量类型:** NUMERIC / **说明:** 任何可以表示为实数的变量 / **数据类型:** 浮点型 / **示例:** 1.224
- **变量类型:** CATEGORICAL / **说明:** 描述类别、区段或群组的任何变量 / **数据类型:** 字符串 / **示例:** 大型
- **变量类型:** 免费表单文本 / **说明:** 作为活动一部分捕获的任何自由格式文本（例如，客户评论或评论） / **数据类型:** 字符串 / **示例:** 自由格式文本输入示例
### 将变量赋给变量类型
如果您计划使用变量来训练模型，请务必选择正确的变量类型来分配给该变量。不正确的变量类型分配可能会对模型性能产生负面影响。以后更改赋值也可能变得非常困难，尤其是在多个模型和事件都使用了该变量的情况下。
您可以为变量分配任何一种预定义变量类型或其中一种自定义变量类型 — `FREE_FORM_TEXT` `CATEGORICAL`、或`NUMERIC`。
**为正确的变量类型分配变量的重要注意事项**
1. 如果该变量与预定义的变量类型之一匹配，请使用它。确保变量类型与变量相对应。例如，如果您为变量类型分配一个 *ip\_addr* ess `EMAIL_ADDRESS` 变量，则 ip\_address 变量将不会充实 ASN、ISP、地理位置和风险评分等丰富内容。有关更多信息，请参阅 [变量丰富](#variable-enrichments)。
1. 如果变量与任何预定义的变量类型都不匹配，请按照下面列出的建议分配其中一个自定义变量类型。
1. 为`CATEGORICAL`变量分配变量类型，这些变量通常没有自然排序，可以归入类别、区段或组。*您用来训练模型的数据集可能有 ID 变量，例如 m *erchant\_id、campaign\_id* 或 policy *\_i* d。*这些变量代表群组（例如，所有具有相同 policy\_id 的客户都代表一个群组）。必须为具有以下数据的变量分配分类变量类型-
+ **包含*客户 ID、细分市场 ID、col *or\_* ID* *、部门代码或产品 ID* 等数据的变量。**
+ 包含布尔值为真、假或空值的变量。
+ 可以分组或类别的变量，例如公司名称、产品类别、卡片类型或推荐媒介。
**注意**
`ENTITY_ID`是 Amazon Fraud Detector 用来分配给 ENTITY\_ID 变量的保留变量类型。ENTITY\_ID 变量是启动要评估的操作的实体的 ID。如果您要创建 “交易欺诈洞察” (TFI) 模型类型，则需要提供 ENTITY\_ID 变量。您需要决定数据中的哪个变量唯一标识启动操作的实体，并将其作为 ENTITY\_ID 变量传递。将 CATEGORICAL 变量类型分配给数据集 IDs 中的所有其他变量，前提是它们存在并且您是否正在使用它们进行模型训练。*其他不 IDs 属于您的数据集实体的示例可以是*卖家 ID、P *olicy\_ID 和 Campaign\_* ID*。*
1. 为包含文本块的变量分配`FREE_FORM_TEXT`变量类型。*FREE\_FORM\_TEXT 变量类型的示例有：*用户评论*、*评论*、*日期和推荐码*。*FREE\_FORM\_TEXT 数据包含多个由分隔符分隔的标记。分隔符可以是除字母数字和下划线符号以外的任何字符。例如，用户评论和评论可以用 “空格” 分隔符分隔，日期和推荐代码可以使用连字符作为分隔符来分隔前缀、后缀和中间部分。Amazon Fraud Detector 使用分隔符从 FREE\_FORM\_TEXT 变量中提取数据。
1. 为实*数且具有固有顺序的变量赋值 NUMER* IC 变量类型。**数字变量的示例包括 *day\_of\_the\_week、事件严重性、客户评级*。**尽管您可以为这些变量分配 CATEGORICAL 变量类型，但我们强烈建议将所有具有固有顺序的实数变量赋给 NUMERIC 变量类型。
## 变量丰富
Amazon Fraud Detector 丰富了您提供的一些原始数据元素，例如 IP 地址、银行识别号码 (BINs) 和电话号码，以创建更多输入并提高使用这些数据元素的模型的性能。丰富功能有助于识别潜在的可疑情况，并帮助模型捕获更多的欺诈行为。
### 电话号码充实
Amazon Fraud Detector 通过与地理位置、原始运营商和电话号码有效性相关的其他信息来丰富电话号码数据。所有在 *2021 年 12 月 13 日*当天或之后接受培训且电话号码包含国家/地区代码 (\+xxx) 的模特都会自动启用电话号码扩充功能。如果您在模型中加入了电话号码变量，并且在 *2021 年 12 月 13 日*之前对其进行了训练，请重新训练您的模型，使其能够利用此增强功能。
我们强烈建议您对电话号码变量使用以下格式，以确保成功丰富您的数据。
| 变量 | Format | 说明 |
| --- | --- | --- |
| PHONE\_NUMBER | [E.164 标准](https://en.wikipedia.org/wiki/E.164) | 请务必在电话号码中包含国家/地区代码 (\+xxx)。 |
| 账单\_电话和配送\_电话 | [E.164 标准](https://en.wikipedia.org/wiki/E.164) | 请务必在电话号码中包含国家/地区代码 (\+xxx)。 |
### 丰富地理定位
从 *2022 年 2 月 8 日起，*Amazon Fraud Detector 将计算您为活动提供的 IP 地址、账单邮政编码和 SHIPPING\_ZIP 值之间的物理距离。计算出的距离用作欺诈检测模型的输入。
要启用地理位置丰富功能，您的事件数据必须至少包含三个变量中的两个：IP\_ADDRESS、BILLING\_ZIP 或 SHIPPING\_ZIP。此外，每个 BILLING\_ZIP 和 SHIPPING\_ZIP 值必须分别具有有效的账单国家/地区代码和 SHIPPING\_COUNTRY 代码。如果您的模型在 *2022 年 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 变量类型来选择退出地理位置扩展。更改变量类型不会影响模型的性能。
**地理定位变量格式**
我们强烈建议您对地理位置变量使用以下格式，以确保成功丰富您的位置数据。
| 变量 | Format | 说明 |
| --- | --- | --- |
| IP\_ADDRESS | [IPv4](https://en.wikipedia.org/wiki/IP_address#IPv4_addresses)地址 | 例如-1.1.1.1 |
| 账单邮政编码和配送邮政编码 | 指定国家/地区的 [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 邮政编码 | 有关更多信息，请参阅本主题中的国家和地区代码部分。 |
| 账单所在国家/地区和配送国家 | [ISO 3166-1 alpha-2 双字母](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)标准国家/地区代码 | 有关更多信息，请参阅本主题中的国家和地区代码部分。Amazon Fraud Detector 试图将一个国家/地区名称的所有常见变体与其 ISO 3166-1 两个字母的标准国家/地区代码进行匹配。但是，我们不能保证它们会正确匹配。 |
#### 国家和地区代码
下表提供了 Amazon Fraud Detector 支持用于丰富地理位置的国家和地区的完整列表。每个国家和地区都有指定的国家/地区代码（具体而言，ISO 3166-1 alpha-2 由两个字母组成的国家/地区代码）和一个邮政编码。
**邮政编码格式**
+ 9-数字
+ a-字母
+ [X]-X 是可选的。例如，Guersney “GY9[9] 9aa” 表示 “9aa” 和 “GY9 9aa” 均有效GY99 。使用一种格式。
+ [X/XX]-可以使用 X 或 XX。例如，百慕大 “aa [aa/99]” 表示 “aa aa” 和 “aa 99” 均有效。使用其中任何一种格式，但*不要*同时使用这两种格式。
+ 有些国家/地区有固定的前缀。例如，安道尔的 AD999邮政编码是。这意味着国家/地区代码必须以字母 *AD* 开头，后跟三个数字。
| 代码 | Name | 邮政编码 |
| --- | --- | --- |
| 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 | Federated States of Micronesia | 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 | Matinique | 99999 |
| MT | 马耳他 | aaa 9999 |
| MX | 墨西哥 | 99999 |
| MY | 马来西亚 | 99999 |
| NL | 荷兰 | 999 aa |
| NO | 挪威 | 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 |
### 用户代理充实
如果您创建账户接管见解 (ATI) 模型，则必须在数据集中提供`useragent`变量类型的变量。此变量包含登录事件的浏览器、设备和操作系统数据。Amazon Fraud Detector 使用其他信息（例如`user_agent_family``OS_family`、和）丰富了用户代理数据。`device_family`