Variables - Amazon Fraud Detector

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Variables

Le variabili rappresentano elementi di dati che desideri utilizzare in una previsione di frode. Queste variabili possono essere prese dal set di dati degli eventi che hai preparato per addestrare il tuo modello, dai risultati del punteggio di rischio del tuo modello Amazon Fraud Detector o dai modelli Amazon. SageMaker Per ulteriori informazioni sulle variabili prese dal set di dati dell'evento, vedereOttieni i requisiti dei set di dati di eventi utilizzando Data models explorer.

Le variabili che desideri utilizzare nella previsione delle frodi devono prima essere create e quindi aggiunte all'evento durante la creazione del tipo di evento. A ogni variabile creata deve essere assegnato un tipo di dati, un valore predefinito e, facoltativamente, un tipo di variabile. Amazon Fraud Detector arricchisce alcune delle variabili fornite, come indirizzi IP, numeri di identificazione bancaria (BIN) e numeri di telefono, per creare input aggiuntivi e migliorare le prestazioni dei modelli che utilizzano queste variabili.

Tipi di dati

Le variabili devono avere un tipo di dati per l'elemento di dati che la variabile rappresenta e, facoltativamente, possono essere assegnati a uno dei valori predefiniti. Tipi variabili Per le variabili assegnate a un tipo di variabile, il tipo di dati è preselezionato. I tipi di dati possibili includono i seguenti tipi:

Tipo di dati Descrizione Valore predefinito Valori di esempio
Stringa Qualsiasi combinazione di lettere, numeri interi o entrambi <empty>

abc, 123, 1D3B

Numero intero Numeri interi positivi o negativi 0 1, -1
Boolean Vero o falso False Vero, falso
DateTime Data e ora specificate solo nel formato UTC standard ISO 8601 <empty> 2019-11-30T 13:01:01 Z
Float Numeri con punti decimali 0,0 4,01, 0,10

Valore predefinito

Le variabili devono avere un valore predefinito. Quando Amazon Fraud Detector genera previsioni di frode, questo valore predefinito viene utilizzato per eseguire una regola o un modello se Amazon Fraud Detector non riceve un valore per una variabile. I valori predefiniti forniti devono corrispondere al tipo di dati selezionato. Nella console AWS, Amazon Fraud Detector assegna il valore predefinito di numeri 0 false interi, booleani, 0.0 float e (vuoto) stringhe. È possibile impostare un valore predefinito personalizzato per ognuno di questi tipi di dati.

Tipi variabili

Quando si crea una variabile, è possibile assegnarla facoltativamente a un tipo di variabile. Il tipo di variabile rappresenta gli elementi di dati comuni utilizzati per addestrare modelli e generare previsioni di frode. Per l'addestramento dei modelli è possibile utilizzare solo le variabili con un tipo di variabile associato. Come parte del processo di formazione del modello, Amazon Fraud Detector utilizza il tipo di variabile associato alla variabile per eseguire arricchimenti delle variabili, ingegneria delle funzionalità e valutazione del rischio.

Amazon Fraud Detector ha predefinito i seguenti tipi di variabili che possono essere utilizzati per assegnare le tue variabili.

Categoria Tipo variabile Descrizione Tipo di dati Esempio
Sessione IP_ADDRESS L'indirizzo IP che viene raccolto durante l'evento Stringa 192.0.2.0

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento della geolocalizzazione.

UTENTE/AGENTE L'agente utente che viene raccolto durante l'evento Stringa Mozilla 5.0 (Windows NT 10.0, Win64, x64, versione: 68.0) Gecko 20100101
IMPRONTA DIGITALE L'identificatore univoco di un dispositivo utilizzato per l'evento Stringa sadfo987u234
SESSION_ID L'ID di sessione per la sessione attiva dell'evento Stringa sid123456789
LE CREDENZIALI SONO VALIDE Indica se le credenziali utilizzate per l'accesso all'evento sono valide Boolean True
Utente INDIRIZZO_EMAIL L'indirizzo email che viene raccolto durante l'evento Stringa abc@domain.com
PHONE_NUMBER Il numero di telefono raccolto durante l'evento Stringa +1 555-0100

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento del numero di telefono.

Fatturazione NOME_FATTURAZIONE Il nome associato all'indirizzo di fatturazione Stringa John Doe
TELEFONO DI FATTURAZIONE Il numero di telefono associato all'indirizzo di fatturazione Stringa +1 555-0100

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento del numero di telefono.

INDIRIZZO_DI FATTURAZIONE L1 La prima riga dell'indirizzo di fatturazione Stringa Qualsiasi strada
INDIRIZZO_DI FATTURAZIONE L2 La seconda riga dell'indirizzo di fatturazione Stringa Qualsiasi unità 123
CITTÀ DI FATTURAZIONE La città indicata nell'indirizzo di fatturazione Stringa Qualsiasi città
STATO_DI FATTURAZIONE Lo stato o la provincia che si trova nell'indirizzo di fatturazione Stringa Qualsiasi stato o provincia
PAESE DI FATTURAZIONE Il paese indicato nell'indirizzo di fatturazione Stringa Qualsiasi paese

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento della geolocalizzazione.

FATTURAZIONE ZIP Il codice postale che si trova nell'indirizzo di fatturazione Stringa 01234

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento della geolocalizzazione.

Spedizioni NOME_SPEDIZIONE Il nome associato all'indirizzo di spedizione Stringa John Doe
TELEFONO DI SPEDIZIONE Il numero di telefono associato all'indirizzo di spedizione Stringa +1 555-0100

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento del numero di telefono.

INDIRIZZO_DI SPEDIZIONE_L1 La prima riga dell'indirizzo di spedizione Stringa 123 Qualsiasi strada
INDIRIZZO_DI SPEDIZIONE_L2 La seconda riga dell'indirizzo di spedizione Stringa Unità 123
CITTÀ_DI SPEDIZIONE La città che si trova nell'indirizzo di spedizione Stringa Qualsiasi città
STATO_DI SPEDIZIONE Lo stato o la provincia che si trova nell'indirizzo di spedizione Stringa Qualsiasi stato
PAESE_DI SPEDIZIONE Il paese in cui si trova è indicato nell'indirizzo di spedizione Stringa Qualsiasi Paese

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento della geolocalizzazione.

ZIP DI SPEDIZIONE Il codice postale che si trova nell'indirizzo di spedizione Stringa 01234

Nota: Amazon Fraud Detector arricchisce questi dati. Per ulteriori informazioni, consulta Arricchimento della geolocalizzazione.

Pagamento ORDER_ID L'identificatore univoco della transazione Stringa LUX60
PREZZO Il prezzo totale dell'ordine Stringa 560,00
CODICE_VALUTA Il codice valuta ISO 4217 Stringa USD
TIPO DI PAGAMENTO Il metodo di pagamento utilizzato per il pagamento durante l'evento Stringa Carta di credito
CODICE DI AUTENTICAZIONE Il codice alfanumerico inviato dall'emittente della carta di credito o dalla banca emittente Stringa 0000
AVS Il codice di risposta del sistema di verifica degli indirizzi (AVS) del processore della carta Stringa Y
Prodotto CATEGORIA_PRODOTTO La categoria di prodotto dell'articolo dell'ordine Stringa Cucina
Personalizza NUMERIC Qualsiasi variabile che può essere rappresentata come numero reale Float 1.224
CATEGORICAL Qualsiasi variabile che descrive categorie, segmenti o gruppi Stringa Large
FORM_TESTO_LIBERO Qualsiasi testo in formato libero acquisito come parte dell'evento (ad esempio, una recensione o un commento di un cliente) Stringa Esempio di immissione di testo in formato libero

Assegnazione di una variabile a un tipo di variabile

Se si prevede di utilizzare una variabile per addestrare il modello, è importante scegliere il tipo di variabile corretto da assegnare alla variabile. L'assegnazione errata del tipo di variabile può influire negativamente sulle prestazioni del modello. Può anche diventare molto difficile modificare l'assegnazione in un secondo momento, soprattutto se più modelli ed eventi hanno utilizzato la variabile.

È possibile assegnare alla variabile uno qualsiasi dei tipi di variabili predefiniti o uno dei tipi di variabili personalizzate:FREE_FORM_TEXT,CATEGORICAL, o. NUMERIC

Note importanti per l'assegnazione di variabili ai tipi di variabili corretti

  1. Se la variabile corrisponde a uno dei tipi di variabili predefiniti, utilizzala. Assicurati che il tipo di variabile corrisponda alla variabile. Ad esempio, se assegni una variabile ip_address a un tipo di variabile, la EMAIL_ADDRESS variabile ip_address non verrà arricchita con arricchimenti come ASN, ISP, geolocalizzazione e punteggio di rischio. Per ulteriori informazioni, consulta Arricchimenti variabili.

  2. Se la variabile non corrisponde a nessuno dei tipi di variabili predefiniti, segui i consigli elencati di seguito per assegnare uno dei tipi di variabili personalizzate.

  3. Assegna il tipo di CATEGORICAL variabile a variabili che in genere non hanno un ordine naturale e possono essere inserite in categorie, segmenti o gruppi. Il set di dati che stai utilizzando per addestrare il tuo modello potrebbe avere variabili ID come merchant_id, campaign_id o policy_id. Queste variabili rappresentano i gruppi (ad esempio, tutti i clienti con lo stesso policy_id rappresentano un gruppo). Alle variabili con i seguenti dati deve essere assegnato il tipo di variabile CATEGORICA -

    • Variabili che contengono dati come Customer_ID, segment_ID, color_ID, department_code o Product_ID.

    • Variabili che contengono dati booleani con valori true, false o nulle.

    • Variabili che possono essere suddivise in gruppi o categorie come il nome dell'azienda, la categoria di prodotto, il tipo di carta o il mezzo di riferimento.

    Nota

    ENTITY_IDè un tipo di variabile riservato utilizzato da Amazon Fraud Detector per assegnare alla variabile ENTITY_ID. La variabile ENTITY_ID è l'ID dell'entità che avvia l'azione che desideri valutare. Se stai creando un tipo di modello Transaction Fraud Insight (TFI), devi fornire la variabile ENTITY_ID. Dovrai decidere quale variabile nei tuoi dati identifica in modo univoco l'entità che avvia l'azione e trasmetterla come variabile ENTITY_ID. Assegna il tipo di variabile CATEGORICAL a tutti gli altri ID nel tuo set di dati, se sono presenti e se li stai utilizzando per l'addestramento dei modelli. Esempi di altri ID che non sono un'entità nel set di dati possono essere Merchant_ID, Policy_ID e Campaign_ID.

  4. Assegna il tipo di FREE_FORM_TEXT variabile alle variabili che contengono un blocco di testo. Esempi di tipi di variabili FREE_FORM_TEXT sono: recensioni degli utenti, commenti, date e codici di riferimento. I dati FREE_FORM_TEXT contengono più token separati da un delimitatore. I delimitatori possono essere qualsiasi carattere diverso dal simbolo alfanumerico e dal carattere di sottolineatura. Ad esempio, le recensioni e i commenti degli utenti possono essere separati da un delimitatore «spazio», le date e i codici di riferimento possono utilizzare trattini come delimitatori per separare prefisso, suffisso e parti intermedie. Amazon Fraud Detector utilizza i delimitatori per estrarre dati dalle variabili FREE_FORM_TEXT.

  5. Assegna il tipo di variabile NUMERIC a variabili che sono numeri reali e hanno un ordine intrinseco. Esempi di variabili NUMERICHE includono day_of_the_week, incident_severity, customer_rating. Sebbene sia possibile assegnare il tipo di variabile CATEGORICAL a queste variabili, si consiglia vivamente di assegnare tutte le variabili numeriche reali con ordine intrinseco al tipo di variabile NUMERIC.

Arricchimenti variabili

Amazon Fraud Detector arricchisce alcuni degli elementi di dati grezzi che fornisci, come indirizzi IP, numeri di identificazione bancaria (BIN) e numeri di telefono, per creare input aggiuntivi e migliorare le prestazioni dei modelli che utilizzano questi elementi di dati. L'arricchimento aiuta a identificare situazioni potenzialmente sospette e aiuta i modelli a rilevare ulteriori frodi.

Arricchimento del numero di telefono

Amazon Fraud Detector arricchisce i dati dei numeri di telefono con informazioni aggiuntive relative alla geolocalizzazione, al corriere originale e alla validità del numero di telefono. L'arricchimento del numero di telefono viene abilitato automaticamente per tutti i modelli formati a partire dal 13 dicembre 2021 e che dispongono di un numero di telefono che include un prefisso internazionale (+xxx). Se hai incluso la variabile del numero di telefono nel tuo modello e l'hai addestrata prima del 13 dicembre 2021, riqualificalo in modo che possa sfruttare questo arricchimento.

Ti consigliamo vivamente di utilizzare il seguente formato per le variabili dei numeri di telefono per assicurarti che i tuoi dati vengano arricchiti correttamente.

Variabile Formato Descrizione
PHONE_NUMBER Lo standard E.164 Assicurati di includere il prefisso internazionale (+xxx) con il numero di telefono.
BILLING_PHONE e SHIPPING_PHONE Lo standard E.164 Assicurati di includere il prefisso internazionale (+xxx) con il numero di telefono.

Arricchimento della geolocalizzazione

A partire dall'8 febbraio 2022, Amazon Fraud Detector calcola la distanza fisica tra i valori IP_ADDRESS, BILLING_ZIP e SHIPPING_ZIP che fornisci per un evento. Le distanze calcolate vengono utilizzate come input per il tuo modello di rilevamento delle frodi.

Per abilitare l'arricchimento della geolocalizzazione, i dati dell'evento devono includere almeno due delle tre variabili: IP_ADDRESS, BILLING_ZIP o SHIPPING_ZIP. Inoltre, ogni valore BILLING_ZIP e SHIPPING_ZIP deve avere rispettivamente un codice BILLING_COUNTRY e un codice SHIPPING_COUNTRY validi. Se disponi di un modello che è stato addestrato prima dell'8 febbraio 2022 e include queste variabili, devi riqualificarlo per abilitare l'arricchimento della geolocalizzazione.

Se Amazon Fraud Detector non è in grado di determinare la posizione associata ai valori IP_ADDRESS, BILLING_ZIP o SHIPPING_ZIP per un evento a causa della non validità dei dati, viene utilizzato invece un valore segnaposto speciale. Ad esempio, supponiamo che un evento abbia valori IP_ADDRESS e BILLING_ZIP validi, ma il valore SHIPPING_ZIP non sia valido. In questo caso, l'arricchimento viene eseguito solo per IP_ADDRESS—> BILLING_ZIP. L'arricchimento non viene eseguito per IP_ADDRESS—>SHIPPING_ZIP e BILLING_ZIP—>SHIPPING_ZIP. Invece, i valori segnaposto vengono utilizzati al loro posto. Indipendentemente dal fatto che l'arricchimento della geolocalizzazione sia abilitato o meno per il tuo modello, le prestazioni del tuo modello non cambiano.

Puoi disattivare l'arricchimento della geolocalizzazione mappando le variabili BILLING_ZIP e SHIPPING_ZIP al tipo di variabile CUSTOM_CATEGORICAL. La modifica del tipo di variabile non influisce sulle prestazioni del modello.

Formato variabile di geolocalizzazione

Ti consigliamo vivamente di utilizzare il seguente formato per le variabili di geolocalizzazione per garantire che i dati sulla posizione vengano arricchiti correttamente.

Variabile Formato Descrizione
IP_ADDRESS Indirizzo IPv4 Ad esempio: 1.1.1.1
BILLING_ZIP e SHIPPING_ZIP Il codice postale ISO 3166-1 alpha-2 per il paese specificato Per ulteriori informazioni, consulta la sezione Codici di Paese e territorio in questo argomento.
BILLING_COUNTRY e SHIPPING_COUNTRY Il codice del paese standard ISO 3166-1 alpha-2 a due lettere Per ulteriori informazioni, consulta la sezione Codici di Paese e territorio in questo argomento. Amazon Fraud Detector cerca di abbinare tutte le varianti più comuni del nome di un paese al codice internazionale standard di due lettere ISO 3166-1. Tuttavia, non possiamo garantire che vengano abbinati correttamente.

La tabella seguente fornisce un elenco completo dei paesi e dei territori supportati da Amazon Fraud Detector per l'arricchimento della geolocalizzazione. A ogni paese e territorio è assegnato un codice paese (in particolare, il prefisso internazionale a due lettere ISO 3166-1 alpha-2) e un codice postale.

Formato del codice postale

  • 9 - numero

  • a - lettera

  • [X] - X è opzionale. Ad esempio, «GY9 [9] 9aa» di Guersney significa che sia «GY9 9aa» che «GY99 9aa» sono validi. Usa un formato.

  • [X/XX]: è possibile utilizzare X o XX. Ad esempio, «aa [aa/99]» delle Bermuda significa che sia «aa aa» che «aa 99" sono validi. Utilizzate uno di questi formati, ma non entrambi.

  • Alcuni paesi hanno un prefisso fisso. Ad esempio, il codice postale di Andorra è AD999. Ciò significa che il prefisso internazionale deve iniziare con le lettere AD seguite da tre numeri.

Codice Nome Codice postale
AD Andorra ANNUNCIO 999
AR Antille Olandesi 9999
AT Austria 9999
AU Australia 9999
AZ Azerbaigian A PARTIRE DA 9999
LETTO Bangladesh 9999
ESSERE Belgio 9999
BG Bulgaria 9999
BM Bermuda aa [aa/99]
BY Bielorussia 999999
CA Canada a9a 9a9
CH Svizzera 9999
CL Cile 9999999
CO Colombia 999999
CR Costa Rica 99999
CY Cipro 9999
CZ Cechia 999 99
DE Germania 99999
DK Danimarca 9999
DO Repubblica Dominicana 99999
DZ Algeria 99999
EE Estonia 99999
ES Spagna 99999
SE Finlandia 99999
FM Stati Federati di Micronesia 99999
PER Isole Fær Øer 999
FR Francia 99999
GB Regno Unito a [a] 9 [a/9] 9aa
GG Guernsey GY9 [9] 9aa
GL Groenlandia 9999
GP Guadalupa 99999
GT Guatemala 99999
GU Guam 99999
ORE Croazia 99999
HU Ungheria 9999
IE Irlanda a99 [a/9] [a/9] [a/9]
IM Isola di Man IM9 [9] 9aa
IN India 999999
IS Islanda 999
ESSO Italia 99999
JE Jersey JE9 [9] 9aa
JP Giappone 999-9999
KR Repubblica di Corea 99999
LI Liechtenstein 9999
OK Sri Lanka 99999
LT Lituania 99999
LU Lussemburgo L-9999
LV Lettonia LV-9999
MC Monaco 99999
MD Repubblica di Moldavia 9999
MH Isole Marshall 99999
KM Nrd Macedonia del Nord 9999
MP Isole Marianne Settentrionali 99999
MQ Matinica 99999
MT Malta aaa 9999
MX Messico 99999
MIA Malesia 99999
NL Paesi Bassi 999 aa
NO Norvegia 9999
NZ Nuova Zelanda 9999
PH Filippine 9999
PK Pakistan 99999
PL Polonia 99-999
PR Porto Rico 99999
PT Portogallo 9999-999
PW Palau 99999
RE

Riunione

99999
O Romania 999999
RU Federazione Russa 999999
VEDERE Svezia 999 99
SG Singapore 999999
SI Slovenia 9999
SK Slovacchia 999 99
SM San Marino 99999
TH Tailandia 99999
TR Turchia 99999
UA Ucraina 99999
USA Stati Uniti 99999
COMPRARE Uruguay 99999
VI Isole Vergini americane 99999
WF Wallis e Futuna 99999
EPPURE Mayotte 99999
ZA Sudafrica 9999

Arricchimento dell'agente utente

Se crei il modello Account Takeover Insights (ATI), devi fornire una variabile del tipo di useragent variabile nel tuo set di dati. Questa variabile contiene i dati del browser, del dispositivo e del sistema operativo di un evento di accesso. Amazon Fraud Detector arricchisce i dati dell'agente utente con informazioni aggiuntive come, e user_agent_familyOS_family. device_family