Questa pagina è stata tradotta dall'API Cloud Translation.

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:

Prepararsi a registrare i partiti
Preparare le tabelle di registrazione del gruppo
Utilizza la projects.locations.instances.importRegisteredParties metodo per registrare o annullare la registrazione parti
Convalida la risposta del metodo
(Facoltativo) Esportare una tabella delle parti registrate

Prima di iniziare

Prima di iniziare, ti serve una Istanza AML AI.

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:

Uno o più set di dati
R ottimizzato, addestrato e sottoposto a backtesting

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 è necessaria per la formazione, all'ottimizzazione o al backtesting.

I risultati delle previsioni vengono utilizzati per esaminare i clienti relativi al riciclaggio di denaro in in fase di produzione o di test/parallelo.

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 del gruppo

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

Colonna	Tipo	Descrizione
`party_id`	`STRING`	Identificatore univoco della parte nei set di dati dell'istanza
`party_size`	`STRING`	NULL; i contenuti vengono ignorati per le registrazioni dei rivenditori

Schema dei soggetti commerciali

Colonna Tipo Descrizione

party_id STRING Identificatore univoco della parte nei set di dati dell'istanza

party_size

STRING

Numero di persone richieste. Il livello si basa sul numero medio di transazioni mensili per il gruppo nei 365 giorni precedenti:

SMALL per piccoli soggetti commerciali con una media di transazioni mensili inferiore a 500
LARGE per grandi parti commerciali con una media di transazioni mensili superiore o uguale a 500

Tutti i valori sono sensibili alle maiuscole.

Come registrare le parti

Le parti sono registrate separatamente per ogni istanza di AML AI. Nota le seguenti:

I rivenditori e i soggetti commerciali devono essere registrati separatamente. Usa separato Chiamate API e tabelle separate per la registrazione dei partecipanti. Se una parte è in entrambi vengono considerati registrazioni separate.
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 del gruppo fornita viene utilizzata per aggiungere elementi al l'elenco esistente di parti registrate nell'istanza o sostituiscile parti registrate per il settore di attività indicato nell'istanza.
Una volta effettuata la registrazione, non sarà possibile annullare la registrazione di una parte per un certo periodo di tempo (vedi il pagina Prezzi). Per questo motivo, puoi impostare validateOnly su TRUE. Questo campo consente di vedere l'effetto e la risposta netti il metodo senza cambiare 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 in Il campo party_size nella tabella di registrazione del partito attiva un errore (Invalid party_size present in table). Le parti registrate non sono aggiornato.
Per le registrazioni dei rivenditori, il campo party_size viene ignorato e tutte presenti nella tabella di registrazione del partito fornita.

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

(Le seguenti informazioni sono disponibili anche in Crea e gestisci le 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 località dell'istanza; usa uno dei seguenti il regioni supportate
Mostra località
- 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 riporta l'elenco delle parti registrate
Nota: puoi fornire più tabelle in cui sono elencate le parti registrate. Utilizza la formato "bq://{project}.{bqDatasetID}.{bqTableID}" per ogni tabella in partyTables un array di dati.
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 nel valore versione motore utilizzata configurazione motore; utilizzare COMMERCIAL per clienti bancari commerciali (persone giuridiche e fisiche) oppure utilizzare RETAIL per i clienti di retail banking

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

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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 registrazione

Una volta completato l'LRO, la risposta indica il numero di parti interessate aggiunti, rimossi o aggiornati dall'operazione.

Campo di risposta	Tipo	Descrizione
`partiesAdded`	`integer`	Numero di parti aggiunte da questa operazione
`partiesRemoved`	`integer`	Numero di parti rimosse da questa operazione
`partiesTotal`	`integer`	Numero totale di parti registrate in questa istanza dopo che l'operazione di aggiornamento è stata completata
`partiesUptiered`	`integer`	Numero totale di soggetti commerciali aumentati da piccoli a grandi
`partiesDowntiered`	`integer`	Numero totale di parti commerciali che sono scese di livello da quelle più grandi a quelle più piccole
`partiesFailedToDowntier`	`integer`	Numero totale di parti commerciali che non sono riuscite a scendere dal livello più alto al più piccolo
`partiesFailedToRemove`	`integer`	Numero di parti che non è stato possibile rimuovere da questa operazione

Come annullare la registrazione delle parti

La registrazione delle parti per ogni istanza di AML AI utilizza lo stesso projects.locations.instances.importRegisteredParties e sostituendo l'elenco esistente delle parti. Imposta il campo mode su REPLACE. Questa impostazione annulla la registrazione di eventuali parti attualmente registrate (ad settore di attività indicato) che non fanno parte della parte indicata tabella di registrazione.

Risposte relative all'annullamento della registrazione

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, a causa del numero minimo di giorni prima che può essere annullata).

Esporta parti registrate

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

(Le seguenti informazioni sono disponibili anche in Crea e gestisci le 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 località dell'istanza; usa uno dei seguenti il regioni supportate
Mostra località
- 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: usa COMMERCIAL per clienti bancari commerciali (persone giuridiche e naturali) o utilizza RETAIL per il retail banking clienti

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 di un'operazione a lunga esecuzione (LRO), consulta Gestire le operazioni a lunga esecuzione.

Questo metodo genera una tabella BigQuery con il seguente schema:

Colonna	Tipo	Descrizione
`party_id`	`STRING`	Identificatore univoco della parte nei set di dati dell'istanza
`party_size`	`STRING`	Specifica il livello per i clienti commerciali (grandi o piccoli). Questo campo non è applicabile per i clienti nel settore della vendita al dettaglio. `NULL` per tutti i clienti retail `SMALL` per piccoli soggetti commerciali con una media di transazioni mensili inferiore a 500 `LARGE` per grandi parti commerciali con una media di transazioni mensili superiore o uguale a 500 Tutti i valori sono sensibili alle maiuscole.
`earliest_remove_time`	`STRING`	Il primo momento in cui è possibile rimuovere il gruppo
`party_with_prediction_intent`	`STRING`	L'indicatore che suggerisce se è stata prevista una parte in base alla registrazione
`registration_or_uptier_time`	`STRING`	L'ora in cui la parte è stata registrata o aggiornata