Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan Amazon Pinpoint untuk analisis kumpulan pengguna
**catatan**
**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh Pesan Pengguna AWS Akhir.
Kumpulan pengguna Amazon Cognito terintegrasi dengan Amazon Pinpoint untuk menyediakan analitik bagi kumpulan pengguna Amazon Cognito dan untuk memperkaya data pengguna untuk kampanye Amazon Pinpoint. Amazon Pinpoint menyediakan analitik dan kampanye yang ditargetkan untuk mendorong keterlibatan pengguna di aplikasi seluler menggunakan notifikasi push. Dengan dukungan analitik Amazon Pinpoint di kumpulan pengguna Amazon Cognito, Anda dapat melacak pendaftaran kumpulan pengguna, login, otentikasi gagal, pengguna aktif harian DAUs (), dan pengguna aktif bulanan () di konsol Amazon Pinpoint. MAUs Anda dapat menelusuri data untuk rentang tanggal atau atribut yang berbeda, seperti platform perangkat, lokal perangkat, dan versi aplikasi.
Anda juga dapat menyiapkan atribut khusus untuk aplikasi Anda. Itu kemudian dapat digunakan untuk menyegmentasikan pengguna Anda pada Amazon Pinpoint dan mengirimi mereka notifikasi push yang ditargetkan. Jika Anda memilih **Bagikan data atribut pengguna dengan Amazon Pinpoint** dalam konfigurasi **Analytics** untuk klien aplikasi Anda di menu **Klien aplikasi** di konsol Amazon Cognito, Amazon Pinpoint akan membuat titik akhir tambahan untuk alamat email pengguna dan nomor telepon.
Saat mengaktifkan analitik Amazon Pinpoint di kumpulan pengguna dengan konsol Amazon Cognito, Anda juga membuat [peran terkait layanan yang diasumsikan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) oleh Amazon Cognito saat membuat permintaan API ke Amazon Pinpoint untuk kumpulan pengguna Anda. Prinsipal IAM yang menambahkan konfigurasi analitik Anda harus memiliki [CreateServiceLinkedRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateServiceLinkedRole.html)izin. Peran terkait layanan adalah. [AWSServiceRoleForAmazonCognitoIdp](https://console.aws.amazon.com/iamv2/home?region=us-east-1#/roles/details/AWSServiceRoleForAmazonCognitoIdp) Untuk informasi selengkapnya, lihat [Menggunakan peran terkait layanan untuk Amazon Cognito](using-service-linked-roles.md).
Saat menerapkan `AnalyticsConfiguration` ke klien aplikasi di Amazon Cognito API, Anda dapat menetapkan peran IAM khusus untuk Amazon Pinpoint dan ID eksternal untuk mengambil peran tersebut. Peran harus mempercayai prinsipal `cognito-idp` layanan, dan jika kebijakan kepercayaan peran memerlukan ID eksternal, itu harus sesuai dengan Anda`AnalyticsConfiguration`. Anda harus memberikan `cognito-idp:Describe*` izin peran, dan izin berikut untuk proyek **Amazon Pinpoint** Anda.
+ `mobiletargeting:UpdateEndpoint`
+ `mobiletargeting:PutEvents`
## Ketersediaan Amazon Cognito dan Amazon Pinpoint Region
Tabel berikut menunjukkan Wilayah AWS pemetaan antara Amazon Cognito dan Amazon Pinpoint yang memenuhi salah satu kondisi berikut.
+ Anda hanya dapat menggunakan proyek Amazon Pinpoint di Wilayah AS Timur (Virginia Utara) (us-east-1).
+ Anda dapat menggunakan proyek Amazon Pinpoint di Wilayah yang sama *atau* di Wilayah AS Timur (Virginia N.) (us-east-1)
Secara default, Amazon Cognito hanya dapat mengirim analitik ke proyek Amazon Pinpoint dalam hal yang sama. Wilayah AWS Pengecualian untuk aturan ini adalah Wilayah dalam tabel berikut, dan Wilayah tempat Amazon Pinpoint tidak tersedia.
Amazon Pinpoint tidak tersedia di Wilayah berikut. Kumpulan pengguna Amazon Cognito di Wilayah ini tidak mendukung analitik.
+ Europe (Milan)
+ Timur Tengah (Bahrain)
+ Asia Pasifik (Osaka)
+ Israel (Tel Aviv)
+ Africa (Cape Town)
+ Asia Pasifik (Jakarta)
+ Asia Pasifik (Malaysia)
Tabel menunjukkan hubungan antara Wilayah tempat Anda membangun kumpulan pengguna Amazon Cognito dan Wilayah terkait di Amazon Pinpoint. Anda harus mengonfigurasi proyek Amazon Pinpoint Anda di Wilayah yang tersedia untuk mengintegrasikannya dengan Amazon Cognito.
| Wilayah kumpulan pengguna Amazon Cognito | Wilayah untuk proyek Amazon Pinpoint |
| --- | --- |
| ap-northeast-1 | us-east-1 |
| ap-northeast-2 | us-east-1 |
| ap-south-1 | us-east-1, ap-south-1 |
| ap-southeast-1 | us-east-1 |
| ap-southeast-2 | us-east-1, ap-southeast-2 |
| ca-central-1 | us-east-1 |
| eu-central-1 | us-east-1, eu-central-1 |
| eu-west-1 | us-east-1, eu-west-1 |
| eu-west-2 | us-east-1 |
| us-east-1 | us-east-1 |
| us-east-2 | us-east-1 |
| us-west-2 | us-east-1, us-west-2 |
**Contoh pemetaan wilayah**
+ Jika Anda membuat kumpulan pengguna di ap-northeast-1, Anda dapat membuat proyek Amazon Pinpoint di us-east-1.
+ Jika Anda membuat kumpulan pengguna di ap-south-1, Anda dapat membuat proyek Amazon Pinpoint di us-east-1 atau ap-south-1.
**catatan**
Untuk semua Wilayah AWS kecuali yang ada di tabel sebelumnya, Amazon Cognito hanya dapat menggunakan proyek Amazon Pinpoint di Wilayah yang sama dengan kumpulan pengguna Anda. Jika Amazon Pinpoint tidak tersedia di Wilayah tempat Anda membuat kumpulan pengguna, dan tidak tercantum dalam tabel, Amazon Cognito tidak mendukung analitik Amazon Pinpoint di Wilayah tersebut. Untuk Wilayah AWS informasi lebih lanjut, lihat [Amazon Pinpoint endpoint](https://docs.aws.amazon.com/general/latest/gr/pinpoint.html) dan kuota.
### Menentukan setelan analitik Amazon Pinpoint ()Konsol Manajemen AWS
Anda dapat mengonfigurasi kumpulan pengguna Amazon Cognito untuk mengirim data analitik ke Amazon Pinpoint. Amazon Cognito hanya mengirimkan data analitik ke Amazon Pinpoint untuk pengguna lokal. Setelah mengonfigurasi kumpulan pengguna untuk diasosiasikan dengan project Amazon Pinpoint, Anda harus menyertakan `AnalyticsMetadata` permintaan API. Untuk informasi selengkapnya, lihat [Mengintegrasikan aplikasi Anda dengan Amazon Pinpoint](#cognito-user-pools-pinpoint-integration-client).
**Untuk menentukan pengaturan analitik**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Anda mungkin diminta untuk kredensial AWS Anda.
1. Pilih **Kumpulan Pengguna** dan pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Klien aplikasi** dan pilih klien aplikasi yang ingin Anda perbarui.
1. **Di tab **Analytics** di bawah **Pinpoint analytics**, pilih Aktifkan.**
1. Pilih Wilayah **Pinpoint**.
1. Pilih proyek **Amazon Pinpoint atau pilih Buat proyek** **Amazon Pinpoint**.
**catatan**
ID proyek Amazon Pinpoint adalah string 32 karakter yang unik untuk proyek Amazon Pinpoint Anda. Itu dicantumkan di konsol Amazon Pinpoint.
Anda dapat memetakan beberapa aplikasi Amazon Cognito ke proyek Amazon Pinpoint tunggal. Namun, setiap aplikasi Amazon Cognito hanya dapat dipetakan ke satu proyek Amazon Pinpoint.
Di Amazon Pinpoint, setiap proyek harus menjadi satu aplikasi. Misalnya, jika developer game memiliki dua game, setiap game harus menjadi proyek Amazon Pinpoint yang terpisah, bahkan jika kedua game menggunakan kolam pengguna Amazon Cognito yang sama. Untuk informasi lebih lanjut tentang proyek Amazon Pinpoint, lihat [Buat proyek di Amazon Pinpoint](https://docs.aws.amazon.com/push-notifications/latest/userguide/mobile-push.html#mobile-push-create-project).
1. Di bawah **Berbagi data pengguna**, pilih **Bagikan data pengguna dengan Amazon Pinpoint** jika Anda ingin Amazon Cognito mengirim alamat email dan nomor telepon ke Amazon Pinpoint dan membuat titik akhir tambahan untuk pengguna. Setelah pengguna Anda memverifikasi alamat email dan nomor telepon mereka, Amazon Cognito hanya membagikannya dengan Amazon Pinpoint jika tersedia untuk akun pengguna.
**catatan**
Sebuah *titik akhir* secara unik mengidentifikasi perangkat pengguna tempat Anda dapat mengirim notifikasi push dengan Amazon Pinpoint. Untuk informasi selengkapnya tentang titik akhir, lihat [Menambahkan titik akhir](https://docs.aws.amazon.com/pinpoint/latest/developerguide/endpoints.html) di Panduan Pengembang *Amazon Pinpoint*.
1. Pilih **Simpan perubahan**.
### Menentukan setelan analitik Amazon Pinpoint AWS CLI ( AWS dan API)
Gunakan perintah berikut untuk menentukan pengaturan analitik Amazon Pinpoint untuk kolam pengguna Anda.
**Untuk menentukan pengaturan analitik untuk aplikasi klien kolam pengguna yang ada pada saat pembuatan aplikasi**
+ AWS CLI: `aws cognito-idp create-user-pool-client`
+ AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html)
**Untuk memperbarui pengaturan analitik untuk aplikasi klien kolam pengguna yang sudah ada**
+ AWS CLI: `aws cognito-idp update-user-pool-client`
+ AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html)
**catatan**
Amazon Cognito mendukung integrasi di Wilayah saat Anda menggunakan `ApplicationArn`
## Mengintegrasikan aplikasi Anda dengan Amazon Pinpoint
*Anda dapat mempublikasikan metadata analitik ke Amazon Pinpoint untuk pengguna *lokal Amazon Cognito di API* kumpulan pengguna.*
**Pengguna lokal**
Pengguna yang mendaftar akun atau dibuat di kumpulan pengguna Anda alih-alih masuk melalui penyedia identitas pihak ketiga (iDP).
**API kumpulan pengguna**
Operasi yang dapat Anda integrasikan dengan AWS SDK, menggunakan aplikasi dengan antarmuka pengguna kustom (UI). Anda tidak dapat meneruskan metadata analitik untuk pengguna federasi atau lokal yang masuk melalui login terkelola. Lihat [Referensi API Amazon Cognito](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/Welcome.html) untuk mengetahui daftar operasi API kumpulan pengguna.
Setelah mengonfigurasi kumpulan pengguna untuk dipublikasikan ke kampanye, Amazon Cognito meneruskan metadata ke Amazon Pinpoint untuk operasi API berikut.
+ `AdminInitiateAuth`
+ `AdminRespondToAuthChallenge`
+ `ConfirmForgotPassword`
+ `ConfirmSignUp`
+ `ForgotPassword`
+ `InitiateAuth`
+ `ResendConfirmationCode`
+ `RespondToAuthChallenge`
+ `SignUp`
Untuk meneruskan metadata tentang sesi pengguna Anda ke kampanye Amazon Pinpoint Anda, sertakan `AnalyticsEndpointId` nilai dalam parameter permintaan `AnalyticsMetadata` API Anda. Sebagai JavaScript contoh, lihat [Mengapa analitik kumpulan pengguna Amazon Cognito saya tidak muncul di dasbor Amazon Pinpoint saya](https://aws.amazon.com/premiumsupport/knowledge-center/pinpoint-cognito-user-pool-analytics/)? di *pusat AWS pengetahuan*.