使用 SendEvent API 操作存放事件資料 - Amazon Fraud Detector

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 SendEvent API 操作存放事件資料

您可以使用 SendEvent API 操作，在 Amazon Fraud Detector 中存放事件，而無需產生這些事件的詐騙預測。例如，您可以使用 SendEvent操作來上傳歷史資料集，之後可用來訓練模型。

SendEvent API 的事件時間戳記格式

使用 SendEvent API 儲存事件資料時，您必須確保事件時間戳記的格式為必要。Amazon Fraud Detector 支援下列日期/時間戳記格式：

  • %yyyy-%mm-%ddT%hh：%mm：%ssZ (ISO 8601 標準，僅限 UTC，無毫秒）

    範例：2019-11-30T13：01：01Z

  • %yyyy/%mm/%dd %hh：%mm：%ss (AM/PM)

    範例：2019/11/30 下午 1：01：01 或 2019/11/30 下午 13：01：01

  • %mm/%dd/%yyyy %hh：%mm：%ss

    範例：11/30/2019 下午 1：01：01、11/30/2019 13：01：01

  • %mm/%dd/%yy %hh：%mm：%ss

    範例：11/30/19 下午 1：01：01、11/30/19 下午 13：01：01

剖析事件時間戳記的日期/時間戳記格式時，Amazon Fraud Detector 會做出下列假設：

  • 如果您使用的是 ISO 8601 標準，則必須完全符合上述規格

  • 如果您使用的是其他格式之一，則有額外的彈性：

    • 對於月和日，您可以提供單位數或雙位數。例如，1/12/2019 是有效的日期。

    • 如果您沒有 hh：mm：ss （也就是說，您可以直接提供日期），則不需要包含 hh：mm：ss。您也可以提供僅小時和分鐘的子集 （例如，hh：mm)。不支援僅提供小時。也不支援毫秒。

    • 如果您提供 AM/PM 標籤，則會假設 12 小時制。如果沒有 AM/PM 資訊，則會假設 24 小時制。

    • 您可以使用 “/” 或 “-” 做為日期元素的分隔符號。時間戳記元素會採用 “：”。

以下是 SendEvent API 呼叫的範例。

import boto3
fraudDetector = boto3.client('frauddetector')

fraudDetector.send_event(
            eventId        = '802454d3-f7d8-482d-97e8-c4b6db9a0428',
            eventTypeName  = 'sample_registration',
            eventTimestamp = '2020-07-13T23:18:21Z',
            eventVariables =  {
    			'email_address' : 'johndoe@exampledomain.com',
    			'ip_address' : '1.2.3.4'},
            assignedLabel  = ‘legit’,
            labelTimestamp = '2020-07-13T23:18:21Z',
            entities       = [{'entityType':'sample_customer', 'entityId':'12345'}],        
)