Mendaftarkan pesta 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 AI AML.

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 disesuaikan, dilatih, dan diuji ulang

Kapan harus mendaftarkan pihak

Sebelum dapat membuat prediksi untuk pihak di salah satu set data, Anda harus mendaftarkan pihak tersebut. Pendaftaran tidak diperlukan untuk pelatihan, penyesuaian, atau pengujian ulang.

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

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

Catatan: Sebelum mendaftarkan pihak untuk instance, pertimbangkan apakah ada instance lain yang menggunakan pihak yang sama. Jika ya, lihat Berbagi pendaftaran pihak untuk beberapa instance.

Cara menyiapkan tabel pendaftaran partai

Baca halaman Harga untuk mengetahui informasi tentang pihak yang mendaftar.

Siapkan tabel untuk lini bisnis yang ingin Anda daftarkan pihak-pihaknya. Jika Anda telah mendaftarkan beberapa pihak, tabel pendaftaran pihak ini dapat berisi subset 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 penjual

Skema pihak komersial

Kolom	Jenis	Deskripsi
party_id	STRING	ID unik pihak dalam set data instance
party_size	STRING	Jumlah rombongan yang diminta. Tingkatan ini didasarkan pada jumlah rata-rata transaksi bulanan 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 partai

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 suatu pihak ada di kedua daftar, pihak tersebut 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 dalam 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 membatalkan pendaftaran untuk beberapa waktu (lihat halaman Harga). Oleh karena itu, Anda dapat menetapkan kolom validateOnly ke TRUE. Dengan kolom ini, Anda dapat melihat efek bersih dan respons metode tanpa mengubah pihak yang terdaftar. Setelah divalidasi, Anda dapat menjalankan kembali operasi dan menyetel parameter validateOnly ke FALSE.
• Selalu periksa respons permintaan pendaftaran untuk memastikan semua pihak berhasil mendaftar, 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 didaftarkan.

Untuk mengimpor pihak yang 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 wilayah yang didukung
  Tampilkan 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 menjelaskan 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 dalam 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 di 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 menggunakan 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 menggunakan 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 mengetahui informasi tentang cara mendapatkan hasil operasi yang berjalan lama (LRO), lihat Mengelola operasi yang berjalan lama.

Respons pendaftaran

Setelah LRO selesai, respons 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 naik tingkat dari kecil ke besar
partiesDowntiered	integer	Jumlah total pihak komersial yang diturunkan dari besar ke kecil
partiesFailedToDowntier	integer	Jumlah total pihak komersial yang gagal menurunkan tingkat 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 menggantikan daftar pihak yang ada. Tetapkan kolom mode ke REPLACE. Setelan ini membatalkan pendaftaran pihak terdaftar (untuk lini bisnis yang diberikan) yang bukan bagian dari tabel pendaftaran pihak yang diberikan.

Catatan: Jumlah minimum hari sebelum pihak dapat membatalkan pendaftaran mungkin 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 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 membatalkan pendaftaran hingga jumlah hari minimum telah berlalu.

Mengekspor pihak terdaftar

Untuk mengekspor pihak yang 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 wilayah yang didukung
  Tampilkan 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 untuk menulis pihak yang 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 menggunakan 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 menggunakan 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 mengetahui 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 vs. 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 suatu pihak telah diprediksi sejak pendaftaran
registration_or_uptier_time	STRING	Waktu saat pihak terdaftar atau di-uptier