Kunden registrieren

Auf dieser Seite werden Sie durch die folgenden Schritte geführt, mit denen Sie Parteien registrieren und ihre Registrierung aufheben können, um Vorhersageergebnisse zu generieren:

1. Bereite dich darauf vor, Parteien zu registrieren
2. Tabellen zur Partyregistrierung vorbereiten
3. Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um Parteien zu registrieren oder ihre Registrierung aufzuheben
4. Methodenantwort validieren
5. Optional: Tabelle der registrierten Parteien exportieren

Hinweise

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

Damit ein Modell Risikobewertungsvorhersagen erstellen kann, müssen Sie zuerst Parteien registrieren. Wir empfehlen Ihnen, Parteien zu registrieren, wenn Sie bereits Folgendes haben:

• Ein oder mehrere Datasets
• Ein abgestimmtes, trainiertes und rückgetestetes Modell

Wann Sie Parteien registrieren sollten

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

Die Vorhersageergebnisse werden verwendet, um Kunden entweder in einer Produktions- oder Test-/Parallelphase auf Geldwäsche zu untersuchen.

Für die Registrierung von Parteien fallen zusätzliche monatliche Kosten pro registrierter Partei an. Weitere Informationen finden Sie in der Preisübersicht.

Tabellen zur Partyregistrierung vorbereiten

Informationen zur Registrierung von Parteien finden Sie in der Preisübersicht.

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

Schema für Einzelhändler

Spalte	Typ	Beschreibung
party_id	STRING	Eindeutige Kennung der Partei in den Datasets der Instanz
party_size	STRING	NULL; bei Registrierungen von Einzelhändlern wird der Inhalt ignoriert.

Schema für kommerzielle Parteien

Spalte	Typ	Beschreibung
party_id	STRING	Eindeutige Kennung der Partei in den Datasets der Instanz
party_size	STRING	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 Unternehmen mit mindestens 500 monatlichen Transaktionen Bei allen Werten wird die Groß- und Kleinschreibung berücksichtigt.

Parteien registrieren

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

• Einzelhandels- und gewerbliche Parteien müssen separat registriert werden. Verwenden Sie separate API-Aufrufe und separate Tabellen für die Seitenregistrierung. Wenn eine Partei in beiden Listen aufgeführt ist, gilt sie als separate Registrierung.
• Für Vorhersagen müssen alle Parteien in dem Geschäftsbereich registriert sein, der mit der verwendeten Engine-Version verknüpft ist. Sie können keine Vorhersageergebnisse erstellen, wenn ein Dataset verwendet wird, das eine Partei enthält, die nicht in derselben Branche registriert ist.
• Die bereitgestellte Registrierungstabelle wird entweder an die vorhandene Liste der registrierten Parteien in der Instanz angehängt oder alle registrierten Parteien für den angegebenen Geschäftsbereich in der Instanz ersetzt.
• Nach der Registrierung kann eine Partei eine Zeit lang nicht abgemeldet werden. Weitere Informationen finden Sie in der Preisübersicht. Daher können Sie das Feld validateOnly auf TRUE setzen. In diesem Feld können Sie die Wirkung und die Antwort der Methode sehen, ohne die registrierten Parteien zu ändern. Nach der Validierung können Sie den Vorgang noch einmal ausführen und den Parameter validateOnly auf FALSE setzen.
• Prüfe immer die Antwort auf eine Registrierungsanfrage, um sicherzugehen, dass alle Parteien erfolgreich registriert wurden, auch wenn eine vorherige validateOnly-Anfrage erfolgreich war.
• Bei Registrierungen kommerzieller Parteien löst ein anderer Wert als SMALL oder LARGE im Feld party_size in der Tabelle für die Parteiregistrierung einen Fehler aus (Invalid party_size present in table). Registrierte Parteien werden nicht aktualisiert.
• Bei Registrierungen von Einzelhandelsunternehmen wird das Feld party_size ignoriert und alle Parteien in der angegebenen Parteiregistrierungstabelle werden registriert.

Verwenden Sie die Methode projects.locations.instances.importRegisteredParties, um registrierte Parteien zu importieren.

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

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
• LOCATION: Standort der Instanz. Verwenden Sie eine der unterstützten Regionen:
  • 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, das eine Tabelle enthält, in der die registrierten Parteien beschrieben werden
• REGISTERED_PARTIES_TABLE: die Tabelle mit den registrierten Parteien
  Hinweis: Du kannst mehrere Tabellen bereitstellen, in denen die registrierten Parteien aufgeführt sind. Verwenden Sie für jede Tabelle im partyTables-Array das Format "bq://{project}.{bqDatasetID}.{bqTableID}".
• UPDATE_MODE: Verwenden Sie REPLACE, um Parteien, die in der Tabelle der registrierten Parteien entfernt werden können, durch neue Parteien zu ersetzen, oder verwenden Sie APPEND, um neue Parteien zur Tabelle der registrierten Parteien hinzuzufügen
• LINE_OF_BUSINESS: Dieses Feld muss mit dem Wert lineOfBusiness in der Engine-Version übereinstimmen, die von der Engine-Konfiguration verwendet wird. Verwenden Sie COMMERCIAL für kommerzielle Bankkunden (rechtliche und natürliche Rechtssubjekte) oder RETAIL für Privatbankkunden.

JSON-Text anfordern:

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

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

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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.REGISTERED_PARTIES_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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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.REGISTERED_PARTIES_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": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

Antwort auf Registrierung

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

Antwortfeld	Typ	Beschreibung
partiesAdded	integer	Anzahl der durch diesen Vorgang hinzugefügten Parteien
partiesRemoved	integer	Anzahl der Personen, die durch diesen Vorgang entfernt wurden
partiesTotal	integer	Gesamtzahl der Parteien, die in dieser Instanz nach Abschluss des Aktualisierungsvorgangs registriert sind
partiesUptiered	integer	Gesamtzahl der kommerziellen Parteien, die von klein zu groß hochgestuft wurde
partiesDowntiered	integer	Gesamtzahl der kommerziellen Parteien, die von groß auf klein reduziert sind
partiesFailedToDowntier	integer	Gesamtzahl der kommerziellen Parteien, die nicht von groß auf klein heruntergestuft werden konnten
partiesFailedToRemove	integer	Anzahl der Parteien, die bei diesem Vorgang nicht entfernt werden konnten

Registrierung von Parteien aufheben

Die Registrierung von Parteien wird pro AML AI-Instanz mit derselben projects.locations.instances.importRegisteredParties-Methode aufgehoben, die die vorhandene Liste der Parteien ersetzt. Legen Sie das Feld mode auf REPLACE fest. Mit dieser Einstellung werden alle derzeit registrierten Parteien (für die angegebene Branche) abgemeldet, die nicht in der bereitgestellten Parteiregistrierungstabelle enthalten sind.

Hinweis :Es kann eine Mindestanzahl von Tagen gelten, bis eine Partei abgemeldet werden kann. Weitere Informationen finden Sie auf der Preisseite. Die API-Antwort gibt an, welche Parteien erfolgreich abgemeldet wurden.

Antworten auf die Abmeldung

Prüfen Sie nach Abschluss des Vorgangs in der API-Antwort, ob der Vorgang zum gewünschten Ergebnis geführt hat. Dies ist die Anzahl der hinzugefügten oder entfernten Parteien und die Gesamtzahl der registrierten Parteien.

Die API-Antwort gibt auch die Anzahl der Parteien zurück, die aufgrund von Einschränkungen (z. B. aufgrund der Mindestanzahl von Tagen, bis die Registrierung einer Partei aufgehoben werden kann) nicht entfernt werden konnten.

Registrierte Parteien exportieren

Verwenden Sie die Methode projects.locations.instances.exportRegisteredParties, um registrierte Parteien zu exportieren.

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

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
• LOCATION: Standort der Instanz. Verwenden Sie eine der unterstützten Regionen:
  • 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 exportiert werden kann, die die registrierten Parteien beschreibt
• REGISTERED_PARTIES_TABLE: Tabelle, in die die registrierten Parteien geschrieben werden sollen
• 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: Löscht alle vorhandenen Daten in der BigQuery-Tabelle, bevor in die Tabelle geschrieben wird.
• LINE_OF_BUSINESS: Verwenden Sie COMMERCIAL für Geschäftsbankkunden (rechtliche und natürliche Rechtssubjekte) oder RETAIL für Privatkundenkunden

JSON-Text anfordern:

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

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

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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.REGISTERED_PARTIES_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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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.REGISTERED_PARTIES_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": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

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

Spalte	Typ	Beschreibung
party_id	STRING	Eindeutige Kennung der Partei in den Datasets der Instanz
party_size	STRING	Gibt die Stufe für kommerzielle Kunden an (groß oder klein). Dieses Feld gilt nicht für Einzelhandelskunden. NULL für alle Einzelhandelskunden SMALL für kleine kommerzielle Partys mit weniger als 500 monatlichen Transaktionen LARGE für große kommerzielle Unternehmen mit mindestens 500 monatlichen Transaktionen Bei allen Werten wird die Groß- und Kleinschreibung berücksichtigt.
earliest_remove_time	STRING	Wann die Partei frühestens entfernt werden kann
party_with_prediction_intent	STRING	Indikator, der darauf hinweist, ob eine Partei seit der Registrierung vorhergesagt wurde
registration_or_uptier_time	STRING	Der Zeitpunkt, zu dem die Partei registriert oder hochgestuft wurde