Kunden registrieren

Auf dieser Seite werden Sie durch die folgenden Schritte geführt, um sich an- und abzumelden um Vorhersageergebnisse zu erhalten:

  1. Bereite dich darauf vor, Parteien zu registrieren
  2. Tabellen für die Parteiregistrierung vorbereiten
  3. Verwenden Sie die Methode projects.locations.instances.importRegisteredParties zum Registrieren oder Aufheben der Registrierung Parteien
  4. Methode – Antwort validieren
  5. Optional: Tabelle mit registrierten Parteien exportieren

Hinweise

Bevor Sie beginnen, benötigen Sie eine AML AI-Instanz.

Damit ein Modell Vorhersagen für Risikobewertungen erstellen kann, müssen Sie sich zuerst registrieren Parteien. Wir empfehlen Ihnen, Partys zu registrieren, wenn Sie bereits Folgendes:

Wann müssen Parteien registriert werden?

Bevor Sie in einem Ihrer Datasets Vorhersagen für eine Partei erstellen können, müssen Sie die Partei registrieren. Für die Schulung, Optimierung oder das Backtesting ist keine Registrierung erforderlich.

Anhand der Vorhersageergebnisse werden Kunden im Hinblick auf Geldwäsche in eine Produktions- oder eine (parallele) Testphase. Sie können auch eigene Governance- und Modellanalyseprozesse anhand der Ergebnisse erstellen, die Sie aus den Vorhersagen erhalten.

Für die Registrierung von Parteien fallen zusätzliche monatliche Kosten pro registrierter Partei an (siehe Weitere Informationen zu den Preisen

Tabellen zur Partyregistrierung vorbereiten

Informationen zur Registrierung von Gruppen finden Sie auf der Preisseite.

Bereiten Sie eine Tabelle für den Geschäftsbereich vor, für den Sie Parteien registrieren möchten. Wenn sich bereits einige Parteien registriert haben, kann diese Tabelle eine Teilmenge der Parteien aus der Tabelle Party enthalten, die Sie die Sie für Vorhersageergebnisse verwenden möchten.

Schema für Einzelhändler

SpalteTypBeschreibung
party_idSTRINGDie eindeutige Kennung der Partei in den Datasets der Instanz
party_sizeSTRINGNULL; Der Inhalt wird bei Registrierungen von Einzelhandelsunternehmen ignoriert.

Schema für kommerzielle Parteien

SpalteTypBeschreibung
party_idSTRINGDie eindeutige Kennung der Partei in den Datasets der Instanz
party_sizeSTRING Angeforderte Gruppengröße. Die Stufe basiert auf der durchschnittlichen Anzahl der monatlichen Transaktionen für die Partei in den letzten 365 Tagen:
  • SMALL für kleine kommerzielle Partys mit weniger als 500 monatlichen Transaktionen
  • LARGE für große kommerzielle Rechtssubjekte mit durchschnittlich mindestens 500 Transaktionen pro Monat

Bei allen Werten wird die Groß- und Kleinschreibung berücksichtigt.

Parteien registrieren

Parteien werden für jede AML AI-Instanz separat registriert. Wichtige Hinweise:

  • Einzelhändler und kommerzielle Parteien müssen separat registriert werden. Separate API-Aufrufe und Tabellen zur Registrierung separater Parteien. Wenn eine Partei in beiden werden als separate Registrierungen betrachtet.
  • Für Vorhersagen müssen alle Parteien beim Geschäftsbereich, der der verwendeten Suchmaschinenversion zugeordnet ist. Sie können Erstellen von Vorhersageergebnissen, wenn ein Dataset verwendet wird, das eine Partei enthält, die nicht die in derselben Branche registriert sind.
  • Die bereitgestellte Tabelle für die Parteiregistrierung wird verwendet, um entweder an die vorhandene Liste registrierter Parteien in der Instanz oder ersetzen Sie alle registrierten Parteien für den in der Instanz angegebenen Geschäftssparte.
  • Nach der Registrierung kann die Registrierung einer Partei für einige Zeit nicht aufgehoben werden (siehe Preisübersicht). Aus diesem Grund können Sie das Feld validateOnly auf TRUE setzen. In diesem Feld sehen Sie den Nettoeffekt und die Reaktion der Methode, ohne die registrierten Teilnehmer zu ändern. Nach der Validierung können Sie den Vorgang noch einmal ausführen und den Parameter validateOnly auf FALSE setzen.
  • Prüfen Sie immer die Antwort auf eine Registrierungsanfrage, um sicherzustellen, dass alle Parteien wurden registriert, auch wenn bei einer vorherigen validateOnly-Anfrage erfolgreich war.
  • Bei kommerziellen Parteiregistrierungen führt ein anderer Wert als SMALL oder LARGE im Feld party_size in der Tabelle für die Parteiregistrierung zu einem Fehler (Invalid party_size present in table). Registrierte Parteien werden nicht aktualisiert.
  • Bei Registrierungen von Einzelhandelsparteien wird das Feld party_size ignoriert und alle Parteien in der bereitgestellten Tabelle für die Parteiregistrierung werden registriert.

Verwenden Sie zum Importieren registrierter Parteien die projects.locations.instances.importRegisteredParties .

(Die folgenden Informationen sind auch verfügbar in Instanzen erstellen und verwalten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
  • LOCATION ist der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten Regionen
    Standorte anzeigen
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
  • BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: ein BigQuery-Dataset mit einer Tabelle, die die registrierten Parteien beschreibt
  • PARTY_REGISTRATION_TABLE: die Tabelle, die eine Liste der registrierten Parteien
  • UPDATE_MODE: Verwenden Sie REPLACE, um Parteien zu ersetzen, die können in der Tabelle der registrierten Parteien mit neuen Parteien entfernt werden oder verwenden Sie APPEND, um neue Parteien zum Tabelle „Registrierte Parteien“
  • LINE_OF_BUSINESS: Dieses Feld muss mit dem lineOfBusiness-Wert in der Engine-Version übereinstimmen, die von der Engine-Konfiguration verwendet wird. Verwenden Sie COMMERCIAL für Kunden des kommerziellen Bankgewerbes (Rechtssubjekte und natürliche Personen) oder RETAIL für Kunden des Privatkundengeschäfts.

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben: 

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben: 

@'
{
  "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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden: 

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Informationen zum Abrufen des Ergebnisses des lang andauernden Vorgangs finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Antwort auf die Registrierung

Wenn der LRO abgeschlossen ist, gibt die Antwort die Anzahl der Parteien an, die durch den Vorgang hinzugefügt, entfernt oder aktualisiert wurden.

AntwortfeldTypBeschreibung
partiesAddedinteger Anzahl der Parteien, die durch diesen Vorgang hinzugefügt wurden
partiesRemovedinteger Anzahl der Personen, die durch diesen Vorgang entfernt wurden
partiesTotalinteger Gesamtzahl der Parteien, die in dieser Instanz registriert sind, nachdem der Aktualisierungsvorgang abgeschlossen wurde
partiesUptieredinteger Gesamtzahl der kommerziellen Parteien, die von klein zu groß hochgestuft wurde
partiesDowntieredinteger Gesamtzahl der kommerziellen Parteien, die von „Groß“ auf „Klein“ herabgestuft wurden
partiesFailedToDowntierinteger Gesamtzahl der kommerziellen Parteien, die nicht von groß auf klein heruntergestuft werden konnten
partiesFailedToRemoveinteger Anzahl der Parteien, die bei diesem Vorgang nicht entfernt werden konnten

Parteien abmelden

Parteien werden pro AML-KI-Instanz mit derselben projects.locations.instances.importRegisteredParties-Methode abgemeldet und die vorhandene Liste der Parteien wird ersetzt. Setzen Sie das Feld mode auf REPLACE. Durch diese Einstellung werden alle derzeit registrierten Parteien (für angegebene Geschäftssparte), die nicht zur angegebenen Partei gehören Registrierungstabelle.

Antworten auf die Abmeldung

Prüfen Sie nach Abschluss des Vorgangs die API-Antwort. um zu prüfen, ob der Vorgang in Form einer Anzahl von hinzugefügte oder entfernte Parteien und die Gesamtzahl der registrierten Parteien

Die API-Antwort gibt auch die Anzahl der Parteien zurück, die nicht entfernt werden konnten aufgrund von Einschränkungen. So kann die Registrierung eines Kunden erst aufgehoben werden, die Mindestanzahl von Tagen verstrichen ist.

Registrierte Parteien exportieren

Exportieren Sie registrierte Parteien mit dem projects.locations.instances.exportRegisteredParties .

(Die folgenden Informationen sind auch verfügbar in Instanzen erstellen und verwalten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
  • LOCATION ist der Standort der Instanz. eine der folgenden Funktionen verwenden: die unterstützten Regionen
    Standorte anzeigen
    • us-central1
    • us-east1
    • asia-south1
    • europe-west1
    • europe-west2
    • europe-west4
    • northamerica-northeast1
    • southamerica-east1
  • INSTANCE_ID: die benutzerdefinierte Kennung für die Instanz
  • BQ_OUTPUT_DATASET_NAME: ein BigQuery-Dataset, in das eine Tabelle mit den registrierten Parteien exportiert werden soll
  • PARTY_REGISTRATION_TABLE: die Tabelle für die registrierten Parteien an
  • WRITE_DISPOSITION: Die Aktion, die ausgeführt wird, wenn die Zieltabelle bereits vorhanden ist. Verwenden Sie einen der folgenden Werte:
    • WRITE_EMPTY: Nur Daten exportieren, wenn die Zieltabelle leer ist.
    • WRITE_TRUNCATE: Alle vorhandenen Daten in der BigQuery-Tabelle werden gelöscht, bevor Daten in die Tabelle geschrieben werden.
  • LINE_OF_BUSINESS: COMMERCIAL verwenden für Kunden von gewerblichen Banken (rechtliche und natürliche Rechtssubjekte) oder RETAIL für Privatkundenkonten verwenden Kunden

JSON-Text der Anfrage:

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

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben: 

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben: 

@'
{
  "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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden: 

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Informationen zum Abrufen des Ergebnisses des lang andauernden Vorgangs finden Sie unter Vorgänge mit langer Ausführungszeit verwalten.

Mit dieser Methode wird eine BigQuery-Tabelle mit dem folgenden Schema ausgegeben:

SpalteTypBeschreibung
party_idSTRINGEindeutige Kennung der Partei in den Datasets der Instanz
party_sizeSTRING Gibt die Stufe für kommerzielle Kunden an (groß oder klein). Dieses Feld gilt nicht für Einzelhandelskunden.
  • NULL für alle Einzelkunden
  • SMALL für kleine kommerzielle Partys mit weniger als 500 monatlichen Transaktionen
  • LARGE für große kommerzielle Rechtssubjekte mit durchschnittlich mindestens 500 Transaktionen pro Monat

Bei allen Werten wird die Groß- und Kleinschreibung beachtet.

earliest_remove_timeSTRINGDas früheste Datum, an dem die Partei entfernt werden kann
party_with_prediction_intentSTRINGIndikator, der darauf hinweist, ob eine Partei seit der Registrierung vorhergesagt wurde
registration_or_uptier_timeSTRINGZeitpunkt, zu dem die Partei registriert oder hochgestuft wurde