Mendaftarkan pelanggan Anda

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

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

Sebelum memulai

Sebelum memulai, Anda memerlukan instance AML AI.

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

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

Kapan harus mendaftarkan pihak

Sebelum dapat membuat prediksi untuk party di salah satu set data, Anda harus mendaftarkan pihak tersebut. Pendaftaran tidak diperlukan untuk pelatihan, tuning, atau backtesting.

Hasil prediksi digunakan dalam menyelidiki pelanggan terkait pencucian uang dalam fase produksi atau pengujian/paralel.

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

Cara menyiapkan tabel pendaftaran pihak

Baca halaman Harga untuk mengetahui informasi tentang pendaftaran pihak.

Siapkan tabel untuk lini bisnis yang ingin Anda daftarkan pihak untuknya. Tabel pendaftaran pihak ini dapat menjadi subset dari tabel Party.

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. Tingkatan 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 besar dengan rata-rata transaksi bulanan lebih dari atau sama dengan 500 Semua nilai peka huruf besar/kecil.

Cara mendaftarkan pihak

Para pihak terdaftar secara terpisah untuk setiap instance AML AI. Perhatikan hal berikut:

• Retail dan pihak komersial harus terdaftar secara terpisah. Menggunakan panggilan API terpisah dan tabel pendaftaran pihak yang terpisah. Jika salah satu pihak ada dalam kedua daftar, keduanya dianggap sebagai pendaftaran terpisah.
• Prediksi mengharuskan semua pihak terdaftar di 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 sudah ada dalam instance atau menggantikan semua pihak yang terdaftar untuk lini bisnis yang disediakan dalam instance.
• Setelah terdaftar, pendaftaran pihak tidak dapat dibatalkan untuk beberapa waktu (lihat halaman Harga). Karena alasan ini, Anda dapat menetapkan kolom validateOnly ke TRUE. Kolom ini memungkinkan Anda melihat efek bersih dan respons metode tanpa mengubah pihak yang 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 pada tabel pendaftaran pihak akan memicu error (Invalid party_size present in table). Pihak yang terdaftar tidak diupdate.
• Untuk pendaftaran pihak retail, kolom party_size diabaikan dan semua pihak dalam tabel pendaftaran pihak yang diberikan akan terdaftar.

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

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

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:
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
• INSTANCE_ID: ID yang ditentukan pengguna untuk instance
• BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME: set data BigQuery yang berisi tabel yang menjelaskan pihak yang terdaftar
• REGISTERED_PARTIES_TABLE: tabel yang mencantumkan pihak yang terdaftar
  Catatan: Anda dapat memberikan beberapa tabel yang mencantumkan pihak yang terdaftar. Gunakan format "bq://{project}.{bqDatasetID}.{bqTableID}" untuk setiap tabel dalam array partyTables.
• UPDATE_MODE: gunakan REPLACE untuk mengganti pihak yang dapat dipindahkan dalam tabel pihak terdaftar dengan pihak baru, atau gunakan APPEND untuk menambahkan pihak baru ke tabel pihak yang terdaftar
• LINE_OF_BUSINESS: kolom ini harus cocok dengan nilai lineOfBusiness di versi mesin yang digunakan oleh konfigurasi mesin; menggunakan COMMERCIAL untuk pelanggan perbankan komersial (entitas hukum dan alam), atau menggunakan RETAIL untuk pelanggan perbankan retail

Meminta isi JSON:

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.REGISTERED_PARTIES_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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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.REGISTERED_PARTIES_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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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.REGISTERED_PARTIES_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": CREATE_TIME,
    "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 dari operasi ini
partiesTotal	integer	Jumlah total pihak yang terdaftar dalam instance ini, setelah operasi pembaruan selesai
partiesUptiered	integer	Jumlah total pihak komersial yang meningkat dari kecil ke besar
partiesDowntiered	integer	Jumlah total pihak komersial yang diturunkan dari jumlah besar menjadi kecil
partiesFailedToDowntier	integer	Total jumlah pihak komersial yang gagal diturunkan dari besar ke kecil
partiesFailedToRemove	integer	Jumlah pihak yang gagal dihapus oleh operasi ini

Cara membatalkan pendaftaran pihak

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

Catatan: Jumlah hari minimum sebelum pihak dapat dibatalkan pendaftarannya dapat berlaku; lihat Halaman harga. Respons API menunjukkan pihak mana yang berhasil dibatalkan pendaftarannya.

Respons pembatalan pendaftaran

Setelah operasi selesai, periksa respons API untuk memeriksa apakah operasi tersebut memberikan 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 pembatasan (misalnya, karena jumlah hari minimum sebelum pendaftaran pihak dapat dibatalkan).

Ekspor pihak terdaftar

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

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

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:
  • us-central1
  • us-east1
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
• INSTANCE_ID: ID yang ditentukan pengguna untuk instance
• BQ_OUTPUT_DATASET_NAME: set data BigQuery yang digunakan untuk mengekspor tabel yang menjelaskan pihak yang terdaftar
• REGISTERED_PARTIES_TABLE: tabel untuk menulis pihak yang terdaftar
• WRITE_DISPOSITION: tindakan yang terjadi jika tabel tujuan sudah ada; gunakan salah satu nilai berikut:
  • WRITE_EMPTY: Hanya mengekspor 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 (badan hukum dan entitas alami), atau gunakan RETAIL untuk pelanggan perbankan retail

Meminta isi JSON:

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.REGISTERED_PARTIES_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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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.REGISTERED_PARTIES_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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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.REGISTERED_PARTIES_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": CREATE_TIME,
    "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 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 suatu pihak telah diprediksi sejak pendaftaran
registration_or_uptier_time	STRING	Waktu saat partai didaftarkan atau ditingkatkan