Mendaftarkan pelanggan Anda

Halaman ini memandu Anda melalui langkah-langkah berikut untuk mendaftarkan dan membatalkan pendaftaran pihak guna membuat hasil prediksi:

1. Pastikan Anda siap mendaftarkan pihak
2. Menyiapkan tabel pendaftaran partai
3. Gunakan metode projects.locations.instances.importRegisteredParties untuk mendaftarkan atau membatalkan pendaftaran pihak
4. Memvalidasi respons metode
5. (Opsional) Mengekspor tabel pihak terdaftar

Sebelum memulai

Sebelum memulai, Anda memerlukan instance AML AI.

Agar model dapat membuat prediksi skor risiko, Anda harus mendaftarkan pihak terlebih dahulu. Sebaiknya daftarkan pihak jika Anda sudah memiliki hal berikut:

• Satu atau beberapa set data
• Model yang disesuaikan, dilatih, dan diuji ulang

Kapan harus mendaftarkan pihak

Sebelum dapat membuat prediksi untuk pesta di salah satu set data, Anda harus mendaftarkan pesta. Pendaftaran tidak diperlukan untuk pelatihan, penyesuaian, atau backtesting.

Hasil prediksi digunakan dalam menyelidiki pelanggan terkait pencucian uang dalam fase produksi atau pengujian (paralel). Anda juga dapat membuat proses analisis tata kelola dan model Anda sendiri berdasarkan hasil yang Anda peroleh dari prediksi.

Pihak yang terdaftar akan dikenai biaya bulanan tambahan per pihak yang terdaftar (lihat halaman Harga untuk mengetahui informasi selengkapnya).

Cara menyiapkan tabel pendaftaran partai

Baca halaman Harga untuk mengetahui informasi tentang cara mendaftarkan pihak.

Siapkan tabel untuk bidang bisnis yang ingin Anda daftarkan untuk pihak. Jika Anda telah mendaftarkan beberapa pihak, tabel pendaftaran pihak ini dapat berisi sebagian pihak dari tabel Pihak yang ingin Anda gunakan untuk hasil prediksi.

Skema pihak retail

Kolom	Jenis	Deskripsi
party_id	STRING	ID unik pihak dalam set data instance
party_size	STRING	NULL; konten diabaikan untuk pendaftaran pihak retail

Skema pihak komersial

Kolom	Jenis	Deskripsi
party_id	STRING	ID unik pihak dalam set data instance
party_size	STRING	Jumlah tamu yang diminta. Tingkat ini didasarkan pada jumlah rata-rata transaksi bulanan untuk pihak tersebut selama 365 hari sebelumnya: SMALL untuk pihak komersial kecil dengan rata-rata transaksi bulanan kurang dari 500 LARGE untuk pihak komersial skala besar dengan rata-rata transaksi bulanan lebih dari atau sama dengan 500 Semua nilai peka huruf besar/kecil.

Cara mendaftarkan pihak

Pihak didaftarkan secara terpisah untuk setiap instance AML AI. Perhatikan hal berikut:

• Pihak retail dan komersial harus terdaftar secara terpisah. Gunakan panggilan API terpisah dan tabel pendaftaran pihak terpisah. Jika pihak tersebut ada dalam kedua daftar, mereka dianggap sebagai pendaftaran terpisah.
• Prediksi mengharuskan semua pihak terdaftar dengan lini bisnis yang terkait dengan versi mesin yang digunakan. Anda tidak dapat membuat hasil prediksi jika set data yang digunakan berisi pihak yang tidak terdaftar dengan lini bisnis yang sama.
• Tabel pendaftaran pihak yang diberikan digunakan untuk menambahkan ke daftar pihak terdaftar yang ada di instance atau mengganti semua pihak terdaftar untuk lini bisnis yang diberikan di instance.
• Setelah terdaftar, pihak tidak dapat dibatalkan pendaftarannya selama beberapa waktu (lihat halaman Harga). Oleh karena itu, Anda dapat menetapkan kolom validateOnly ke TRUE. Kolom ini memungkinkan Anda melihat efek bersih dan respons metode tanpa mengubah pihak terdaftar. Setelah divalidasi, Anda dapat menjalankan kembali operasi dan menetapkan parameter validateOnly ke FALSE.
• Selalu periksa respons permintaan pendaftaran untuk memastikan semua pihak berhasil terdaftar, meskipun permintaan validateOnly sebelumnya berhasil.
• Untuk pendaftaran pihak komersial, nilai selain SMALL atau LARGE di kolom party_size dalam tabel pendaftaran pihak akan memicu error (Invalid party_size present in table). Pihak terdaftar tidak diperbarui.
• Untuk pendaftaran pihak retail, kolom party_size diabaikan dan semua pihak dalam tabel pendaftaran pihak yang diberikan akan terdaftar.

Untuk mengimpor pihak terdaftar, gunakan metode projects.locations.instances.importRegisteredParties.

(Informasi berikut juga tersedia di Membuat dan mengelola instance.)

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus telah diberi izin berikut:

Izin

• financialservices.v1instances.importRegisteredParties

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda yang tercantum di Setelan IAM
• LOCATION: lokasi instance; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• INSTANCE_ID: ID yang ditentukan pengguna untuk instance
• BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: set data BigQuery yang berisi tabel yang mendeskripsikan pihak terdaftar
• PARTY_REGISTRATION_TABLE: tabel yang mencantumkan pihak terdaftar
  Catatan: Anda dapat memberikan beberapa tabel yang mencantumkan pihak terdaftar. Gunakan format "bq://{project}.{bqDatasetID}.{bqTableID}" untuk setiap tabel dalam array partyTables.
• UPDATE_MODE: gunakan REPLACE untuk mengganti pihak yang dapat dihapus di tabel pihak terdaftar dengan pihak baru, atau gunakan APPEND untuk menambahkan pihak baru ke tabel pihak terdaftar
• LINE_OF_BUSINESS: kolom ini harus cocok dengan nilai lineOfBusiness dalam versi mesin yang digunakan oleh konfigurasi mesin; gunakan COMMERCIAL untuk pelanggan perbankan komersial (entitas hukum dan perorangan), atau gunakan RETAIL untuk pelanggan perbankan retail

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

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

Kemudian, jalankan perintah berikut untuk mengirim permintaan REST Anda:

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

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

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$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

Anda akan melihat respons JSON seperti berikut:

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

Untuk informasi tentang cara mendapatkan hasil operasi yang berjalan lama (LRO), lihat Mengelola operasi yang berjalan lama.

Respons pendaftaran

Saat LRO selesai, respons akan menunjukkan jumlah pihak yang ditambahkan, dihapus, atau diperbarui oleh operasi.

Kolom respons	Jenis	Deskripsi
partiesAdded	integer	Jumlah pihak yang ditambahkan oleh operasi ini
partiesRemoved	integer	Jumlah pihak yang dihapus oleh operasi ini
partiesTotal	integer	Jumlah total pihak yang terdaftar dalam instance ini, setelah operasi pembaruan selesai
partiesUptiered	integer	Jumlah total pihak komersial yang diupgrade dari kecil ke besar
partiesDowntiered	integer	Total jumlah pihak komersial yang diturunkan tingkatnya dari besar menjadi kecil
partiesFailedToDowntier	integer	Jumlah total pihak komersial yang gagal mendowngrade dari besar ke kecil
partiesFailedToRemove	integer	Jumlah pihak yang gagal dihapus oleh operasi ini

Cara membatalkan pendaftaran pihak

Pihak dibatalkan pendaftarannya per instance AML AI menggunakan metode projects.locations.instances.importRegisteredParties yang sama dan mengganti daftar pihak yang ada. Tetapkan kolom mode ke REPLACE. Setelan ini membatalkan pendaftaran pihak yang saat ini terdaftar (untuk bidang bisnis yang diberikan) yang bukan bagian dari tabel pendaftaran pihak yang diberikan.

Catatan: Mungkin ada jumlah minimum hari sebelum pihak dapat dibatalkan pendaftarannya; lihat halaman Harga. Respons API menunjukkan pihak mana yang berhasil dibatalkan pendaftarannya.

Respons penghapusan pendaftaran

Setelah operasi selesai, periksa respons API untuk memeriksa apakah operasi menghasilkan hasil yang diinginkan dalam hal jumlah pihak yang ditambahkan atau dihapus, dan jumlah total pihak yang terdaftar.

Respons API juga menampilkan jumlah pihak yang tidak dapat dihapus karena batasan; misalnya, pelanggan tidak dapat dibatalkan pendaftarannya hingga jumlah hari minimum berlalu.

Mengekspor pihak terdaftar

Untuk mengekspor pihak terdaftar, gunakan metode projects.locations.instances.exportRegisteredParties.

(Informasi berikut juga tersedia di Membuat dan mengelola instance.)

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus telah diberi izin berikut:

Izin

• financialservices.v1instances.exportRegisteredParties

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda yang tercantum di Setelan IAM
• LOCATION: lokasi instance; gunakan salah satu region yang didukung
  Menampilkan lokasi
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• INSTANCE_ID: ID yang ditentukan pengguna untuk instance
• BQ_OUTPUT_DATASET_NAME: set data BigQuery tempat mengekspor tabel yang menjelaskan pihak terdaftar
• PARTY_REGISTRATION_TABLE: tabel tempat menulis pihak terdaftar
• WRITE_DISPOSITION: tindakan yang terjadi jika tabel tujuan sudah ada; gunakan salah satu nilai berikut:
  • WRITE_EMPTY: Hanya ekspor data jika tabel BigQuery kosong.
  • WRITE_TRUNCATE: Menghapus semua data yang ada di tabel BigQuery sebelum menulis ke tabel.
• LINE_OF_BUSINESS: gunakan COMMERCIAL untuk pelanggan perbankan komersial (entitas hukum dan perorangan), atau gunakan RETAIL untuk pelanggan perbankan retail

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

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

Kemudian, jalankan perintah berikut untuk mengirim permintaan REST Anda:

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

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

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$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

Anda akan melihat respons JSON seperti berikut:

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

Untuk informasi tentang cara mendapatkan hasil operasi yang berjalan lama (LRO), lihat Mengelola operasi yang berjalan lama.

Metode ini menghasilkan tabel BigQuery dengan skema berikut:

Kolom	Jenis	Deskripsi
party_id	STRING	ID unik pihak dalam set data instance
party_size	STRING	Menentukan tingkat untuk pelanggan komersial (besar versus kecil). Kolom ini tidak berlaku untuk pelanggan retail. NULL untuk semua pelanggan retail SMALL untuk pihak komersial kecil dengan rata-rata transaksi bulanan kurang dari 500 LARGE untuk pihak komersial skala besar dengan rata-rata transaksi bulanan lebih dari atau sama dengan 500 Semua nilai peka huruf besar/kecil.
earliest_remove_time	STRING	Waktu paling awal saat pihak dapat dihapus
party_with_prediction_intent	STRING	Indikator yang menunjukkan apakah pihak telah diprediksi sejak pendaftaran
registration_or_uptier_time	STRING	Waktu saat pihak didaftarkan atau diupgrade