Registra i tuoi clienti

Questa pagina ti accompagna attraverso i seguenti passaggi per registrarti e annullare la registrazione parti al fine di creare risultati predittivi:

  1. Assicurati di essere pronto a registrare le parti
  2. Preparare le tabelle di registrazione del gruppo
  3. Utilizza il metodo projects.locations.instances.importRegisteredParties per registrare o annullare la registrazione delle parti
  4. Convalida la risposta del metodo
  5. (Facoltativo) Esportare una tabella delle parti registrate

Prima di iniziare

Prima di iniziare, devi disporre di un'istanza AI di AML.

Per consentire a un modello di creare previsioni del punteggio di rischio, devi prima registrare parti. Ti consigliamo di registrare le parti quando hai già seguenti:

Quando registrare le parti

Prima di poter creare previsioni per una parte in uno dei tuoi set di dati, devi registrare la parte. La registrazione non è obbligatoria per l'addestramento, la messa a punto o il backtesting.

I risultati di previsione vengono utilizzati per verificare la presenza di attività di riciclaggio di denaro da parte dei clienti in una fase di produzione o di test (parallela). Ti consigliamo inoltre di creare le tue procedure di governance e analisi dei modelli in base ai risultati ottenuti dalle previsioni.

La registrazione delle parti comporta costi mensili aggiuntivi per ogni parte registrata (vedi la pagina Prezzi per ulteriori informazioni).

Come preparare le tabelle di registrazione dei partiti

Leggi la pagina dei prezzi per informazioni sulla registrazione delle parti.

Prepara una tabella per il line of business per cui vuoi registrare le feste. Se alcuni partiti sono già registrati, questa tabella di registrazione del gruppo potrebbe Contenere un sottoinsieme delle parti della tabella Party che hai da usare per i risultati delle previsioni.

Schema dei partiti per la vendita al dettaglio

ColonnaTipoDescrizione
party_idSTRINGIdentificatore univoco della parte nei set di dati dell'istanza
party_sizeSTRINGNULL; i contenuti vengono ignorati per le registrazioni dei rivenditori

Schema delle parti commerciali

ColonnaTipoDescrizione
party_idSTRINGIdentificatore univoco della parte nei set di dati dell'istanza
party_sizeSTRING Numero di persone richieste. Il livello si basa sul numero medio di transazioni mensili per la parte nei 365 giorni precedenti:
  • SMALL per piccole parti commerciali con meno di 500 transazioni mensili in media
  • LARGE per parti commerciali di grandi dimensioni con un volume medio di transazioni mensili superiore o uguale a 500

Tutti i valori sono sensibili alle maiuscole.

Come registrare le parti

Le parti vengono registrate separatamente per ogni istanza di IA AML. Tieni presente quanto segue:

  • I rivenditori e le parti commerciali devono essere registrati separatamente. Utilizza chiamate API e tabelle di registrazione delle parti separate. Se un partito è presente in entrambi gli elenchi, vengono considerate registrazioni distinte.
  • Le previsioni richiedono che tutte le parti siano registrate con line of business associato alla versione del motore utilizzata. Non puoi crea risultati di previsione se viene utilizzato un set di dati che contiene qualsiasi parte registrati con la stessa linea di business.
  • La tabella di registrazione dei partiti fornita viene utilizzata per aggiungere elementi all'elenco esistente di partiti registrati nell'istanza o per sostituire tutti i partiti registrati per la sfera di attività fornita nell'istanza.
  • Una volta registrata, una festa non può essere annullata per un po' di tempo (consulta la pagina Prezzi). Per questo motivo, puoi impostare validateOnly su TRUE. Questo campo ti consente di vedere l'effetto netto e la risposta del metodo senza modificare le parti registrate. Dopo la convalida, puoi eseguire nuovamente l'operazione e impostare il parametro validateOnly su FALSE.
  • Controlla sempre la risposta a una richiesta di registrazione per assicurarti che tutte le parti sono stati registrati correttamente, anche se una precedente richiesta validateOnly riuscito.
  • Per le registrazioni di parti commerciali, un valore diverso da SMALL o LARGE nel campo party_size della tabella di registrazione delle parti attiva un errore (Invalid party_size present in table). Le parti registrate non vengono aggiornate.
  • Per le registrazioni dei partiti di vendita al dettaglio, il campo party_size viene ignorato e tutti i partiti nella tabella di registrazione dei partiti fornita vengono registrati.

Per importare parti registrate, utilizza projects.locations.instances.importRegisteredParties .

Le seguenti informazioni sono disponibili anche in Creare e gestire istanze.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato in le impostazioni IAM
  • LOCATION: la località dell'istanza; usa uno dei seguenti il regioni supportate
    Sedi dei negozi
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID: l'identificatore definito dall'utente per l'istanza
  • BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: un Set di dati BigQuery contenente una tabella che descrive le parti registrate
  • PARTY_REGISTRATION_TABLE: la tabella che elenca le parti registrate
  • UPDATE_MODE: utilizza REPLACE per sostituire parti che sono rimovibili nella tabella delle parti registrate con i nuovi parti oppure usa APPEND per aggiungere nuovi parti al tabella parti registrate
  • LINE_OF_BUSINESS: questo campo deve corrispondere al valore lineOfBusiness nella versione del motore utilizzata dalla configurazione del motore. Utilizza COMMERCIAL per i clienti di banche commerciali (persone giuridiche e fisiche) o RETAIL per i clienti di banche al dettaglio

Corpo JSON della richiesta: 

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente: 

cat > request.json << 'EOF'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Quindi, esegui questo comando per inviare la richiesta REST: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"

PowerShell

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente: 

@'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi, esegui questo comando per inviare la richiesta REST: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Per informazioni su come ottenere il risultato di un'operazione a lunga esecuzione (LRO), consulta Gestire le operazioni a lunga esecuzione.

Risposta alla registrazione

Al termine dell'LRO, la risposta indica il numero di parti aggiunte, rimosse o aggiornate dall'operazione.

Campo di rispostaTipoDescrizione
partiesAddedinteger Numero di parti aggiunte da questa operazione
partiesRemovedinteger Numero di parti rimosse da questa operazione
partiesTotalinteger Numero totale di parti registrate in questa istanza dopo che l'operazione di aggiornamento è stata completata
partiesUptieredinteger Numero totale di parti commerciali di cui è stato eseguito l'upgrade da piccole a grandi
partiesDowntieredinteger Numero totale di parti commerciali che sono scese di livello da quelle più grandi a quelle più piccole
partiesFailedToDowntierinteger Numero totale di parti commerciali che non sono riuscite a eseguire il downgrade da grandi a piccole
partiesFailedToRemoveinteger Numero di parti che non sono state rimosse da questa operazione

Come annullare la registrazione delle parti

Le parti vengono registrate per istanza di IA AML utilizzando lo stesso metodo projects.locations.instances.importRegisteredParties e sostituendo l'elenco esistente di parti. Imposta il campo mode su REPLACE. Questa impostazione annulla la registrazione di tutte le parti attualmente registrate (per la linea di business indicata) che non fanno parte della tabella di registrazione delle parti indicata.

Risposte alla disattivazione

Al termine dell'operazione, controlla la risposta dell'API. per verificare se l'operazione ha portato al risultato previsto in termini di numeri parti aggiunte o rimosse e il numero totale di parti registrate.

La risposta dell'API restituisce anche il numero di parti che non è stato possibile rimuovere a causa di vincoli; ad esempio, un cliente non può essere annullato fino a quando non è trascorso un numero minimo di giorni.

Esporta parti registrate

Per esportare le parti registrate, utilizza il metodo projects.locations.instances.exportRegisteredParties.

Le seguenti informazioni sono disponibili anche in Creare e gestire istanze.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato in le impostazioni IAM
  • LOCATION: la posizione dell'istanza. Utilizza una delle regioni supportate.
    Sedi dei negozi
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID: l'identificatore definito dall'utente per l'istanza
  • BQ_OUTPUT_DATASET_NAME: un Set di dati BigQuery in cui esportare una tabella che descrive le parti registrate
  • PARTY_REGISTRATION_TABLE: la tabella per scrivere le parti registrate
  • WRITE_DISPOSITION: l'azione che si verifica se la tabella di destinazione esiste già. Utilizza uno dei seguenti valori:
    • WRITE_EMPTY: esporta i dati solo se la tabella BigQuery è vuota.
    • WRITE_TRUNCATE: cancella tutti i dati esistenti nella tabella BigQuery prima di scrivere nella tabella.
  • LINE_OF_BUSINESS: utilizza COMMERCIAL per i clienti di banche commerciali (persone giuridiche e fisiche) o RETAIL per i clienti di banche di retail

Corpo JSON della richiesta: 

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente: 

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

Quindi, esegui questo comando per inviare la richiesta REST: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"

PowerShell

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente: 

@'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi, esegui questo comando per inviare la richiesta REST: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Per informazioni su come ottenere il risultato dell'operazione a lunga esecuzione (LRO), consulta Gestire le operazioni a lunga esecuzione.

Questo metodo genera una tabella BigQuery con il seguente schema:

ColonnaTipoDescrizione
party_idSTRINGIdentificatore univoco della parte nei set di dati dell'istanza
party_sizeSTRING Specifica il livello per i clienti commerciali (grandi o piccoli). Questo campo non si applica ai clienti al dettaglio.
  • NULL per tutti i clienti al dettaglio
  • SMALL per piccole parti commerciali con meno di 500 transazioni mensili in media
  • LARGE per parti commerciali di grandi dimensioni con un volume medio di transazioni mensili superiore o uguale a 500

Tutti i valori sono sensibili alle maiuscole.

earliest_remove_timeSTRINGL'ora più prossima in cui la parte può essere rimossa
party_with_prediction_intentSTRINGL'indicatore che suggerisce se è stata prevista una parte in base alla registrazione
registration_or_uptier_timeSTRINGL'ora in cui il cliente è stato registrato o ha effettuato l'upgrade