Menggunakan analitik Amazon Pinpoint dengan kumpulan pengguna Amazon Cognito

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 kolam pengguna Amazon Cognito, Anda dapat melacak pendaftaran kolam pengguna, masuk ke kolam pengguna, autentikasi yang gagal, pengguna aktif harian (DAU), dan pengguna aktif bulanan (MAU) di konsol Amazon Pinpoint. 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 di tab Analytics 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 oleh Amazon Cognito saat membuat permintaan API ke Amazon Pinpoint untuk kumpulan pengguna Anda. Prinsip IAM yang menambahkan konfigurasi analitik Anda harus memiliki CreateServiceLinkedRoleizin. Peran terkait layanan adalah. AWSServiceRoleForAmazonCognitoIdp Untuk informasi selengkapnya, lihat Menggunakan peran terkait layanan untuk Amazon Cognito.

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

• Eropa (Milan)

• Timur Tengah (Bahrain)

• Asia Pasifik (Osaka)

• Israel (Tel Aviv)

• Afrika (Cape Town)

• Asia Pasifik (Jakarta)

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 dan kuota.

Menentukan setelan analitik Amazon Pinpoint ()AWS Management Console

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.

Untuk menentukan pengaturan analitik

1. Masuk ke Konsol Amazon Cognito. Anda mungkin diminta untuk kredensial AWS Anda.

2. Pilih Kumpulan Pengguna dan pilih kumpulan pengguna yang ada dari daftar.

3. Pilih tab Integrasi aplikasi.

4. Di bawah Klien dan analitik aplikasi, pilih nama klien App yang ada dari daftar.

5. Di bawah Pinpoint analytics, pilih Aktifkan.

6. Pilih Wilayah Pinpoint.

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

8. 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 di Panduan Pengembang Amazon Pinpoint.

9. 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: CreateUserPoolClient

Untuk memperbarui pengaturan analitik untuk aplikasi klien kolam pengguna yang sudah ada

• AWS CLI: aws cognito-idp update-user-pool-client

• AWS API: UpdateUserPoolClient

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 UI yang dihosting. Lihat Referensi API Amazon Cognito 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? di pusat AWS pengetahuan.