**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 AWS End User Messaging.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kueri data analitik Amazon Pinpoint
<a name="analytics"></a>

Selain menggunakan halaman analitik di konsol Amazon Pinpoint, Anda dapat menggunakan Amazon Pinpoint APIs Analytics untuk menanyakan data analitik untuk subset metrik standar yang memberikan wawasan tentang tren yang terkait dengan keterlibatan pengguna, penjangkauan kampanye, dan lainnya. Metrik ini, juga disebut sebagai *indikator kinerja utama (KPIs)*, adalah nilai terukur yang dapat membantu Anda memantau dan menilai kinerja proyek, kampanye, dan perjalanan Anda.

Jika Anda menggunakan data analitik APIs untuk kueri, Anda dapat menganalisis data dengan menggunakan alat pelaporan pilihan Anda, tanpa harus masuk ke konsol Amazon Pinpoint atau menganalisis data peristiwa mentah dari sumber seperti aliran Amazon Kinesis. Misalnya, Anda dapat membuat dasbor khusus yang menampilkan hasil kampanye mingguan atau memberikan analisis mendalam tentang tarif pengiriman untuk kampanye Anda.

Anda dapat melakukan kueri data menggunakan Amazon Pinpoint REST API, the AWS Command Line Interface (AWS CLI), atau SDK. AWS Untuk menanyakan data, Anda mengirim permintaan ke Amazon Pinpoint API dan menggunakan parameter yang didukung untuk menentukan data yang Anda inginkan dan filter apa pun yang ingin Anda terapkan. Setelah mengirimkan kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Anda kemudian dapat meneruskan hasilnya ke layanan atau aplikasi lain untuk analisis, penyimpanan, atau pelaporan yang lebih dalam.

Amazon Pinpoint secara otomatis mengumpulkan dan menggabungkan data untuk semua metrik yang didukung, untuk semua proyek, kampanye, dan perjalanan Anda. Selain itu, data diperbarui terus menerus, menghasilkan kerangka waktu latensi data yang dibatasi sekitar dua jam. Namun, perhatikan bahwa mungkin ada latensi data tambahan untuk metrik tertentu. Ini karena data untuk beberapa metrik didasarkan pada informasi yang kami terima dari penyedia email penerima. Beberapa penyedia mengirimkan informasi ini kepada kami segera, sementara yang lain mengirimkannya lebih jarang.

Amazon Pinpoint menyimpan data selama 90 hari. Untuk menyimpan data selama lebih dari 90 hari atau mengakses data analitik mentah secara real time, Anda dapat mengonfigurasi project Amazon Pinpoint untuk mengalirkan data peristiwa ke Amazon Kinesis Data Streams atau Amazon Data Firehose. Untuk informasi tentang mengonfigurasi aliran peristiwa, lihat. [Streaming data peristiwa aplikasi melalui Kinesis dan Firehose menggunakan Amazon Pinpoint](event-streams.md)

## Komponen kueri dan parameter untuk metrik di Amazon Pinpoint
<a name="analytics-query-basics"></a>

Untuk menanyakan data metrik, Anda mengirim `get` permintaan ke sumber daya metrik yang sesuai dari Amazon Pinpoint API. Dalam permintaan, Anda menentukan kueri dengan menggunakan parameter yang didukung untuk komponen kueri berikut:
+ **Proyek** — Tentukan proyek dengan memberikan ID proyek sebagai nilai untuk `application-id` parameter. Parameter ini diperlukan untuk semua metrik.
+ **Kampanye** — Tentukan kampanye dengan memberikan ID kampanye sebagai nilai untuk `campaign-id` parameter. Parameter ini hanya diperlukan untuk metrik kampanye.
+ **Perjalanan** — Tentukan perjalanan dengan memberikan ID perjalanan sebagai nilai untuk `journey-id` parameter. Parameter ini hanya diperlukan untuk metrik keterlibatan dan eksekusi perjalanan, dan metrik eksekusi aktivitas perjalanan.
+ **Aktivitas perjalanan** — Tentukan aktivitas perjalanan dengan memberikan ID aktivitas perjalanan sebagai nilai `journey-activity-id` parameter. Parameter ini hanya diperlukan untuk metrik eksekusi aktivitas perjalanan.
+ **Rentang tanggal** - Untuk secara opsional memfilter data berdasarkan rentang tanggal, berikan tanggal dan waktu pertama dan terakhir dari rentang tanggal dengan menggunakan parameter waktu mulai dan akhir yang didukung. Nilai harus dalam format ISO 8601 yang diperluas dan menggunakan Coordinated Universal Time (UTC) —misalnya, `2019-07-19T20:00:00Z` untuk 8:00 PM UTC 19 Juli 2019.

  Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, tanggal dan waktu pertama harus kurang dari 90 hari dari hari ini. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint mengembalikan data untuk 31 hari kalender sebelumnya. Parameter rentang tanggal didukung oleh semua metrik kecuali metrik eksekusi perjalanan dan metrik eksekusi aktivitas perjalanan.
+ **Metrik** — Tentukan metrik dengan memberikan nama metrik sebagai nilai untuk `kpi-name` parameter. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Contohnya adalah `email-open-rate` dan `successful-delivery-rate`. Parameter ini diperlukan untuk semua metrik kecuali metrik eksekusi perjalanan dan metrik eksekusi aktivitas perjalanan. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai yang akan digunakan untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Setelah mengirim kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Dalam tanggapannya, struktur hasil bervariasi tergantung pada metrik yang Anda tanyakan.

Beberapa metrik hanya memberikan satu nilai—misalnya, jumlah pesan yang dikirimkan oleh kampanye. Metrik lain memberikan beberapa nilai dan biasanya mengelompokkan nilai tersebut berdasarkan bidang yang relevan—misalnya, jumlah pesan yang dikirimkan oleh setiap proses kampanye, dikelompokkan berdasarkan kampanye yang dijalankan. Jika metrik menyediakan dan mengelompokkan beberapa nilai, respons JSON menyertakan bidang yang menunjukkan bidang mana yang digunakan untuk mengelompokkan data. Untuk mempelajari lebih lanjut tentang struktur hasil kueri, lihat[Gunakan hasil kueri JSON](analytics-query-results.md).

# Kebijakan IAM untuk menanyakan data analitik Amazon Pinpoint
<a name="analytics-permissions"></a>

Dengan menggunakan Amazon Pinpoint API, Anda dapat melakukan kueri data analitik untuk subset metrik standar, juga disebut sebagai *indikator kinerja utama (KPIs)* yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint. Metrik ini dapat membantu Anda memantau dan menilai kinerja proyek, kampanye, dan perjalanan.

Untuk mengelola akses ke data ini, Anda dapat membuat kebijakan AWS Identity and Access Management (IAM) yang menentukan izin untuk peran IAM atau pengguna yang berwenang untuk mengakses data. Untuk mendukung kontrol terperinci atas akses ke data ini, Amazon Pinpoint menyediakan beberapa tindakan berbeda yang dapat Anda tentukan dalam kebijakan IAM. Ada tindakan berbeda untuk melihat data analitik di Amazon Pinpoint console (`mobiletargeting:GetReports`), dan ada tindakan lain untuk mengakses data analitik secara terprogram dengan menggunakan Amazon Pinpoint API.

Untuk membuat kebijakan IAM yang mengelola akses ke data analitik, Anda dapat menggunakan Konsol Manajemen AWS, API AWS CLI, atau IAM. Perhatikan bahwa tab **Editor Visual** pada saat ini Konsol Manajemen AWS tidak menyertakan tindakan untuk melihat atau menanyakan data analitik Amazon Pinpoint. Namun, Anda dapat menambahkan tindakan yang diperlukan ke kebijakan IAM secara manual dengan menggunakan tab **JSON** di konsol.

Misalnya, kebijakan berikut memungkinkan akses terprogram ke semua data analitik untuk semua proyek, kampanye, dan perjalanan Anda di semua AWS Wilayah:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QueryAllAnalytics",
            "Effect": "Allow",
            "Action": [
                "mobiletargeting:GetApplicationDateRangeKpi",
                "mobiletargeting:GetCampaignDateRangeKpi",
                "mobiletargeting:GetJourneyDateRangeKpi",
                "mobiletargeting:GetJourneyExecutionMetrics",
                "mobiletargeting:GetJourneyExecutionActivityMetrics"
            ],
            "Resource": [
                "arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
                "arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
                "arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
                "arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
                "arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
            ]
        }
    ]
}
```

------

Di *accountId* mana ID AWS akun Anda.

Namun, sebagai praktik terbaik, Anda harus membuat kebijakan yang mengikuti prinsip *hak istimewa paling sedikit*. Dengan kata lain, Anda harus membuat kebijakan yang hanya menyertakan izin yang diperlukan untuk melakukan tugas tertentu. Untuk mendukung praktik ini dan menerapkan kontrol yang lebih terperinci, Anda dapat membatasi akses terprogram ke data analitik hanya untuk proyek tertentu di AWS Wilayah tertentu, misalnya:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QueryProjectAnalytics",
            "Effect": "Allow",
            "Action": [
                "mobiletargeting:GetApplicationDateRangeKpi",
                "mobiletargeting:GetCampaignDateRangeKpi",
                "mobiletargeting:GetJourneyDateRangeKpi",
                "mobiletargeting:GetJourneyExecutionMetrics",
                "mobiletargeting:GetJourneyExecutionActivityMetrics"
            ],
            "Resource": [
            "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
    "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
    "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
    "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
    "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
            ]
        }
    ]
}
```

------

Di mana:
+ *region*adalah nama AWS Wilayah yang menjadi tuan rumah proyek.
+ *accountId*adalah ID AWS akun Anda.
+ *projectId*adalah pengenal untuk proyek yang ingin Anda berikan aksesnya.

Demikian pula, contoh kebijakan berikut memungkinkan akses terprogram ke data analitik hanya untuk kampanye tertentu:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QueryCampaignAnalytics",
            "Effect": "Allow",
            "Action": "mobiletargeting:GetCampaignDateRangeKpi",
            "Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
        }
    ]
}
```

------

Di mana:
+ *region*adalah nama AWS Wilayah yang menjadi tuan rumah proyek.
+ *accountId*adalah Akun AWS ID Anda.
+ *projectId*adalah pengenal untuk proyek yang terkait dengan kampanye.
+ *campaignId*adalah pengenal untuk kampanye yang ingin Anda berikan aksesnya.

Dan contoh kebijakan berikut memungkinkan akses terprogram ke semua data analitik, baik data keterlibatan maupun eksekusi, untuk perjalanan tertentu dan aktivitas yang membentuk perjalanan tersebut:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QueryJourneyAnalytics",
            "Effect": "Allow",
            "Action": [
                "mobiletargeting:GetJourneyDateRangeKpi",
                "mobiletargeting:GetJourneyExecutionMetrics",
                "mobiletargeting:GetJourneyExecutionActivityMetrics"
            ],
            "Resource": [
                "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
                "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
                "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
            ]
        }
    ]
}
```

------

Di mana:
+ *region*adalah nama AWS Wilayah yang menjadi tuan rumah proyek.
+ *accountId*adalah ID AWS akun Anda.
+ *projectId*adalah pengenal untuk proyek yang terkait dengan perjalanan.
+ *journeyId*adalah pengenal untuk perjalanan yang ingin Anda berikan akses.

Untuk daftar lengkap tindakan Amazon Pinpoint API yang dapat Anda gunakan dalam kebijakan IAM, lihat. [Tindakan Amazon Pinpoint untuk kebijakan IAM](permissions-actions.md) Untuk informasi rinci tentang membuat dan mengelola kebijakan IAM, lihat [Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).

# Metrik standar yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint
<a name="analytics-standard-metrics"></a>

Anda dapat menggunakan Amazon Pinpoint Analytics APIs untuk menanyakan data analitik untuk subset metrik standar yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint. Metrik ini, juga disebut sebagai *indikator kinerja utama (KPIs)*, adalah nilai terukur yang dapat membantu Anda memantau dan menilai kinerja proyek, kampanye, dan perjalanan.

Amazon Pinpoint menyediakan akses terprogram ke data analitik untuk beberapa jenis metrik standar:
+ **Metrik aplikasi** *— Metrik ini memberikan wawasan tentang tren untuk semua kampanye dan pesan transaksional yang terkait dengan proyek, juga disebut sebagai aplikasi.* Misalnya, Anda dapat menggunakan metrik aplikasi untuk mendapatkan rincian jumlah pesan yang dibuka oleh penerima untuk setiap kampanye yang terkait dengan proyek.
+ **Metrik kampanye** — Metrik ini memberikan wawasan tentang kinerja masing-masing kampanye. Misalnya, Anda dapat menggunakan metrik kampanye untuk menentukan jumlah titik akhir pesan kampanye yang dikirim atau berapa banyak pesan yang dikirim ke titik akhir.
+ **Metrik keterlibatan perjalanan** — Metrik ini memberikan wawasan tentang kinerja perjalanan individu. Misalnya, Anda dapat menggunakan metrik keterlibatan perjalanan untuk mendapatkan rincian jumlah pesan yang dibuka oleh peserta di setiap aktivitas perjalanan.
+ **Metrik eksekusi perjalanan** — Metrik ini memberikan wawasan tentang tren partisipasi untuk perjalanan individu. Misalnya, Anda dapat menggunakan metrik eksekusi perjalanan untuk menentukan berapa banyak peserta yang memulai perjalanan.
+ **Metrik eksekusi aktivitas perjalanan** — Metrik ini memberikan wawasan tentang tren partisipasi untuk aktivitas individu dalam suatu perjalanan. Misalnya, Anda dapat menggunakan metrik eksekusi aktivitas perjalanan untuk menentukan jumlah peserta yang memulai aktivitas dan berapa banyak peserta yang menyelesaikan setiap jalur dalam suatu aktivitas.

Topik di bagian ini mencantumkan dan menjelaskan metrik individual yang dapat Anda kueri untuk setiap jenis metrik.

**Topics**
+ [Amazon Pinpoint metrik aplikasi untuk kampanye](application-metrics-campaigns.md)
+ [Metrik aplikasi Amazon Pinpoint untuk pesan email transaksional](application-metrics-txn-email.md)
+ [Metrik aplikasi Amazon Pinpoint untuk pesan SMS transaksional](application-metrics-txn-sms.md)
+ [Metrik kampanye Amazon Pinpoint](campaign-metrics.md)
+ [Amazon Pinpoint metrik keterlibatan perjalanan](journey-metrics-engagement-email.md)
+ [Amazon Pinpoint metrik eksekusi perjalanan](journey-metrics-execution.md)
+ [Amazon Pinpoint metrik eksekusi aktivitas perjalanan](journey-metrics-activity-execution.md)
+ [Amazon Pinpoint metrik perjalanan dan eksekusi kampanye](journey-run-metrics-activity-execution.md)

# Amazon Pinpoint metrik aplikasi untuk kampanye
<a name="application-metrics-campaigns"></a>

Tabel berikut mencantumkan dan menjelaskan metrik aplikasi standar yang dapat Anda kueri untuk menilai kinerja semua kampanye yang terkait dengan proyek Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik Aplikasi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dari Amazon Pinpoint API. Kolom **kpi-name** dalam tabel menunjukkan nilai yang akan digunakan untuk `kpi-name` parameter dalam kueri. 


| Metrik | Nama KPI | Deskripsi | 
| --- | --- | --- | 
| Tingkat pengiriman |  `successful-delivery-rate`  |  Untuk semua kampanye yang terkait dengan proyek, persentase pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh semua kampanye untuk proyek dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim oleh semua kampanye tersebut.  | 
|  Tingkat pengiriman, dikelompokkan berdasarkan tanggal  |  `successful-delivery-rate-grouped-by-date`  |  Untuk semua kampanye yang terkait dengan proyek, persentase pesan yang dikirim ke penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh semua kampanye untuk proyek dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim oleh semua kampanye tersebut, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Tarif buka email | `email-open-rate` |  Untuk semua kampanye yang terkait dengan proyek, persentase pesan email yang dibuka oleh penerima. Metrik ini dihitung sebagai jumlah pesan email yang dikirim oleh semua kampanye untuk proyek dan dibuka oleh penerima, dibagi dengan jumlah pesan email yang dikirim oleh semua kampanye tersebut dan dikirim ke penerima.  | 
|  Rasio buka email, dikelompokkan berdasarkan kampanye  |  `email-open-rate-grouped-by-campaign`  |  Untuk setiap kampanye yang terkait dengan proyek, persentase pesan email yang dibuka oleh penerima. Metrik ini dihitung sebagai jumlah pesan email yang dikirim oleh kampanye dan dibuka oleh penerima, dibagi dengan jumlah pesan email yang dikirim oleh kampanye dan dikirim ke penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID kampanye (`CampaignId`), yang merupakan string yang mengidentifikasi kampanye secara unik.  | 
|  Pengiriman titik akhir  |  `unique-deliveries`  |  Untuk semua kampanye yang terkait dengan proyek, jumlah titik akhir unik yang dikirimkan pesan.   | 
| Pengiriman titik akhir, dikelompokkan berdasarkan kampanye |  `unique-deliveries-grouped-by-campaign`  |  Untuk setiap kampanye yang terkait dengan proyek, jumlah titik akhir unik yang dikirimkan pesan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID kampanye (`CampaignId`), yang merupakan string yang mengidentifikasi kampanye secara unik.  | 
|  Pengiriman titik akhir, dikelompokkan berdasarkan tanggal  |  `unique-deliveries-grouped-by-date`  |  Untuk semua kampanye yang terkait dengan proyek, jumlah titik akhir unik yang dikirimkan pesan, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
|  Pesan terkirim, dikelompokkan berdasarkan kampanye  |  `successful-deliveries-grouped-by-campaign`  |  Untuk setiap kampanye yang terkait dengan proyek, jumlah pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh kampanye, dikurangi jumlah pesan yang dikirim oleh kampanye dan tidak dapat dikirim ke penerima karena pantulan keras. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID kampanye (`CampaignId`), yang merupakan string yang mengidentifikasi kampanye secara unik.  | 
|  Dorong tingkat buka  |  `push-open-rate`  |  Untuk semua kampanye yang terkait dengan proyek, persentase pemberitahuan push yang dibuka oleh penerima.  Metrik ini dihitung sebagai jumlah pemberitahuan push yang dikirim oleh semua kampanye untuk proyek dan dibuka oleh penerima, dibagi dengan jumlah pemberitahuan push yang dikirim oleh semua kampanye tersebut dan dikirimkan ke penerima.  | 
|  Push open rate, dikelompokkan berdasarkan kampanye  |  `push-open-rate-grouped-by-campaign`  |  Untuk setiap kampanye yang terkait dengan proyek, persentase pemberitahuan push yang dibuka oleh penerima. Metrik ini dihitung sebagai jumlah pemberitahuan push yang dikirim oleh kampanye dan dibuka oleh penerima, dibagi dengan jumlah pemberitahuan push yang dikirim oleh kampanye dan dikirim ke penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID kampanye (`CampaignId`), yang merupakan string yang mengidentifikasi kampanye secara unik.  | 

# Metrik aplikasi Amazon Pinpoint untuk pesan email transaksional
<a name="application-metrics-txn-email"></a>

Tabel berikut mencantumkan dan menjelaskan metrik aplikasi standar yang dapat Anda kueri untuk memantau tren semua pesan email transaksional yang terkait dengan proyek Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik Aplikasi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dari Amazon Pinpoint API. Kolom **kpi-name** dalam tabel menunjukkan nilai yang akan digunakan untuk `kpi-name` parameter dalam kueri. 

Perhatikan bahwa metrik ini tidak menyediakan data tentang pesan email yang dikirim oleh kampanye. Mereka menyediakan data tentang pesan email transaksional saja. Untuk menanyakan data pesan yang dikirim oleh satu atau beberapa kampanye, gunakan [metrik kampanye atau metrik](campaign-metrics.md) [aplikasi untuk kampanye](application-metrics-campaigns.md).


| Metrik | Nama KPI | Deskripsi | 
| --- | --- | --- | 
| Klik |  `txn-emails-clicked`  |  Berapa kali penerima mengklik tautan dalam pesan. Jika satu penerima mengklik beberapa tautan dalam pesan, atau mengklik tautan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan.  | 
| Klik, dikelompokkan berdasarkan tanggal |  `txn-emails-clicked-grouped-by-date`  |  Berapa kali penerima mengklik tautan dalam pesan, untuk setiap hari dalam rentang tanggal yang ditentukan. Jika satu penerima mengklik beberapa tautan dalam pesan, atau mengklik tautan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Tingkat keluhan |  `txn-emails-complaint-rate`  |  Persentase pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan. Metrik ini dihitung sebagai jumlah pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan, dibagi dengan jumlah pesan yang dikirim.  | 
| Tingkat keluhan, dikelompokkan berdasarkan tanggal |  `txn-emails-complaint-rate-grouped-by-date`  |  Persentase pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan, untuk setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan, dibagi dengan jumlah pesan yang dikirim, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Aduan |  `txn-emails-with-complaints`  |  Jumlah pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan.   | 
| Keluhan, dikelompokkan berdasarkan tanggal |  `txn-emails-with-complaints-grouped-by-date`  | Jumlah pesan yang dilaporkan oleh penerima sebagai email yang tidak diminta atau tidak diinginkan, untuk setiap hari dalam rentang tanggal yang ditentukan.Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang. | 
| Pengiriman |  `txn-emails-delivered`  |  Jumlah pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim, dikurangi jumlah pesan yang tidak dapat dikirim karena pantulan lunak atau keras atau karena ditolak. Pesan ditolak jika Amazon Pinpoint menentukan bahwa pesan tersebut berisi malware. Amazon Pinpoint tidak mencoba mengirim pesan yang ditolak.  | 
| Pengiriman, dikelompokkan berdasarkan tanggal |  `txn-emails-delivered-grouped-by-date`  |  Jumlah pesan yang dikirim ke penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dikirim, dikurangi jumlah pesan yang tidak dapat dikirim karena pantulan lunak atau keras atau karena ditolak, untuk setiap hari dalam rentang tanggal yang ditentukan. Pesan ditolak jika Amazon Pinpoint menentukan bahwa pesan tersebut berisi malware. Amazon Pinpoint tidak mencoba mengirim pesan yang ditolak. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Tingkat pengiriman |  `txn-emails-delivery-rate`  |  Persentase pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim.  | 
| Tingkat pengiriman, dikelompokkan berdasarkan tanggal |  `txn-emails-delivery-rate-grouped-by-date`  |  Persentase pesan yang dikirim ke penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dikirim dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| pentalan keras |  `txn-emails-hard-bounced`  |  Jumlah pesan yang tidak dapat dikirim ke penerima karena pantulan keras. Hard bounce terjadi jika masalah persisten mencegah pesan dikirimkan—misalnya, jika alamat email penerima tidak ada.  | 
| Pantulan keras, dikelompokkan berdasarkan tanggal |  `txn-emails-hard-bounced-grouped-by-date`  |  Jumlah pesan yang tidak dapat dikirim ke penerima karena pantulan keras, untuk setiap hari dalam rentang tanggal yang ditentukan. Hard bounce terjadi jika masalah persisten mencegah pesan dikirimkan—misalnya, jika alamat email penerima tidak ada. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Membuka |  `txn-emails-opened`  |  Jumlah pesan yang dibuka oleh penerima.  | 
| Dibuka, dikelompokkan berdasarkan tanggal |  `txn-emails-opened-grouped-by-date`  |  Jumlah pesan yang dibuka oleh penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Mengirim |  `txn-emails-sent`  |  Jumlah pesan yang dikirim.  | 
| Mengirim, dikelompokkan berdasarkan tanggal |  `txn-emails-sent-grouped-by-date`  |  Jumlah pesan yang dikirim, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Pantulan lembut |  `txn-emails-soft-bounced`  |  Jumlah pesan yang tidak dapat dikirim ke penerima karena soft bounce. Soft bounce terjadi jika masalah sementara mencegah pesan dikirimkan—misalnya, jika kotak masuk penerima penuh atau server penerima sementara tidak tersedia.  | 
| Pantulan lunak, dikelompokkan berdasarkan tanggal |  `txn-emails-soft-bounced-grouped-by-date`  |  Jumlah pesan yang tidak dapat dikirim ke penerima karena soft bounce, untuk setiap hari dalam rentang tanggal yang ditentukan. Soft bounce terjadi jika masalah sementara mencegah pesan dikirimkan—misalnya, jika kotak masuk penerima penuh atau server penerima sementara tidak tersedia. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Acara klik pengguna yang unik |  `txn-emails-unique-clicks`  |  Jumlah penerima unik (endpoint) yang mengklik link dalam pesan. Berbeda dengan metrik **Klik**, metrik ini melaporkan jumlah penerima unik yang mengklik tautan, bukan jumlah peristiwa klik yang terjadi. Misalnya, jika satu penerima mengklik beberapa tautan dalam pesan yang sama, atau mengklik tautan yang sama lebih dari sekali, metrik ini hanya melaporkan satu peristiwa klik untuk penerima tersebut.  | 
| Acara klik pengguna unik, dikelompokkan berdasarkan tanggal |  `txn-emails-unique-clicks-grouped-by-date`  |  Jumlah penerima unik (titik akhir) yang mengklik tautan dalam pesan, untuk setiap hari dalam rentang tanggal yang ditentukan. Berbeda dengan **Klik, dikelompokkan berdasarkan metrik tanggal**, metrik ini melaporkan jumlah penerima unik yang mengklik tautan, bukan jumlah peristiwa klik yang terjadi. Misalnya, jika satu penerima mengklik beberapa tautan dalam pesan yang sama, atau mengklik tautan yang sama lebih dari sekali, metrik ini hanya melaporkan satu peristiwa klik untuk penerima tersebut. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Acara terbuka pengguna yang unik | `txn-emails-unique-opens` |  Jumlah penerima unik (endpoint) yang membuka pesan. Berbeda dengan metrik **Buka**, metrik ini melaporkan jumlah penerima unik yang membuka pesan, bukan jumlah peristiwa terbuka yang terjadi. Misalnya, jika satu penerima membuka pesan yang sama beberapa kali, metrik ini hanya melaporkan satu peristiwa terbuka untuk penerima tersebut.  | 
| Acara terbuka pengguna unik, dikelompokkan berdasarkan tanggal | `txn-emails-unique-opens-grouped-by-date` |  Jumlah penerima unik (endpoint) yang membuka pesan, untuk setiap hari dalam rentang tanggal yang ditentukan. Berbeda dengan **Buka, dikelompokkan berdasarkan metrik tanggal**, metrik ini melaporkan jumlah penerima unik yang membuka pesan, bukan jumlah peristiwa terbuka yang terjadi. Misalnya, jika satu penerima membuka pesan yang sama beberapa kali, metrik ini hanya melaporkan satu peristiwa terbuka untuk penerima tersebut. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 

# Metrik aplikasi Amazon Pinpoint untuk pesan SMS transaksional
<a name="application-metrics-txn-sms"></a>

Tabel berikut mencantumkan dan menjelaskan metrik aplikasi standar yang dapat Anda kueri untuk memantau tren semua pesan SMS transaksional yang terkait dengan proyek Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik Aplikasi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dari Amazon Pinpoint API. Kolom **kpi-name** dalam tabel menunjukkan nilai yang akan digunakan untuk `kpi-name` parameter dalam kueri. 

Perhatikan bahwa metrik ini tidak menyediakan data tentang pesan SMS yang dikirim oleh kampanye. Mereka menyediakan data tentang pesan SMS transaksional saja. Untuk menanyakan data pesan yang dikirim oleh satu atau beberapa kampanye, gunakan [metrik kampanye atau metrik](campaign-metrics.md) [aplikasi untuk kampanye](application-metrics-campaigns.md).


| Metrik | Nama KPI | Deskripsi | 
| --- | --- | --- | 
| Harga rata-rata per pesan, dikelompokkan berdasarkan negara |  `txn-sms-average-price-grouped-by-country`  |  Biaya rata-rata pengiriman setiap pesan, untuk setiap negara atau wilayah tempat pesan dikirim. Harganya ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah 645, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = \$10,00645). Metrik ini dihitung sebagai total biaya semua pesan yang dikirim ke penerima di setiap negara atau wilayah, dibagi dengan jumlah pesan yang dikirim ke penerima di masing-masing negara dan wilayah tersebut. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 
| Harga rata-rata per bagian pesan, dikelompokkan berdasarkan negara |  `txn-sms-average-price-by-parts-grouped-by-country`  |  Biaya rata-rata pengiriman setiap bagian pesan, untuk setiap negara atau wilayah tempat pesan dikirim. Bagian pesan adalah bagian dari pesan SMS. Harganya ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah 645, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = \$10,00645). Metrik ini dihitung sebagai total biaya semua bagian pesan yang dikirim ke penerima di setiap negara atau wilayah, dibagi dengan jumlah bagian pesan yang dikirim ke penerima di masing-masing negara dan wilayah tersebut. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 
| Pengiriman |  `txn-sms-delivered`  |  Jumlah pesan yang dikirim ke penerima.  | 
| Pengiriman, dikelompokkan berdasarkan negara |  `txn-sms-delivered-grouped-by-country`  | Jumlah pesan yang dikirim ke penerima, untuk setiap negara atau wilayah tempat pesan dikirim. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2. | 
| Pengiriman, dikelompokkan berdasarkan tanggal |  `txn-sms-delivered-grouped-by-date`  | Jumlah pesan yang dikirim ke penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang. | 
| Kesalahan pengiriman |  `txn-sms-error-distribution`  |  Berapa kali kesalahan terjadi saat mencoba mengirimkan pesan, untuk setiap jenis kesalahan yang terjadi. Hasil kueri untuk metrik ini dikelompokkan berdasarkan kode kesalahan, untuk setiap jenis kesalahan yang terjadi.  | 
| Tingkat pengiriman |  `txn-sms-delivery-rate`  |  Persentase pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim.  | 
| Tingkat pengiriman, dikelompokkan berdasarkan tanggal |  `txn-sms-delivery-rate-grouped-by-date`  |  Persentase pesan yang dikirim ke penerima, untuk setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dikirim dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Bagian pesan terkirim |  `txn-sms-delivered-by-parts`  |  Jumlah bagian pesan yang dikirimkan. *Bagian pesan* adalah bagian dari pesan SMS. Jika pesan SMS berisi lebih banyak karakter daripada yang diizinkan oleh protokol SMS, Amazon Pinpoint membagi pesan menjadi bagian pesan sebanyak yang diperlukan untuk mengirim pesan ke penerima.  | 
| Bagian pesan dikirim, dikelompokkan berdasarkan negara |  `txn-sms-delivered-by-parts-grouped-by-country`  |  Jumlah bagian pesan yang dikirimkan, untuk setiap negara atau wilayah tempat pesan dikirim. *Bagian pesan* adalah bagian dari pesan SMS. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 
| Bagian pesan terkirim |  `txn-sms-sent-by-parts`  |  Jumlah bagian pesan yang dikirim. *Bagian pesan* adalah bagian dari pesan SMS. Jika pesan SMS berisi lebih banyak karakter daripada yang diizinkan oleh protokol SMS, Amazon Pinpoint membagi pesan menjadi bagian pesan sebanyak yang diperlukan untuk mengirim pesan ke penerima.  | 
| Bagian pesan dikirim, dikelompokkan berdasarkan negara |  `txn-sms-sent-by-parts-grouped-by-country`  |  Jumlah bagian pesan yang dikirim, untuk setiap negara atau wilayah tempat pesan dikirim. *Bagian pesan* adalah bagian dari pesan SMS. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 
| Pesan terkirim |  `txn-sms-sent`  | Jumlah pesan yang dikirim. | 
| Pesan dikirim, dikelompokkan berdasarkan negara |  `txn-sms-sent-grouped-by-country`  |  Jumlah pesan yang dikirim, untuk setiap negara atau wilayah tempat pesan dikirim. Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 
| Pesan dikirim, dikelompokkan berdasarkan tanggal |  `txn-sms-sent-grouped-by-date`  | Jumlah pesan yang dikirim, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang. | 
| Total harga, dikelompokkan berdasarkan negara |  `txn-sms-total-price-grouped-by-country`  |  Total biaya pengiriman pesan, untuk setiap negara atau wilayah tempat pesan dikirim. Harganya ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah 645, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = \$10,00645). Hasil kueri untuk metrik ini dikelompokkan berdasarkan negara atau wilayah, dalam format ISO 3166-1 alpha-2.  | 

# Metrik kampanye Amazon Pinpoint
<a name="campaign-metrics"></a>

Tabel berikut mencantumkan dan menjelaskan metrik kampanye standar yang dapat Anda kueri untuk menilai kinerja kampanye individual. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik Kampanye](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) dari Amazon Pinpoint API. Kolom **kpi-name** dalam tabel menunjukkan nilai yang akan digunakan untuk `kpi-name` parameter dalam kueri Anda.


| Metrik | Nama KPI | Deskripsi | 
| --- | --- | --- | 
|  Tingkat pentalan  |  `hard-bounce-rate`  |  Untuk semua kampanye berjalan, persentase pesan email yang tidak dapat dikirim ke penerima. Metrik ini hanya mengukur hard bounce — yaitu, pesan di mana alamat email penerima memiliki masalah permanen yang mencegah pesan dikirim. Metrik ini dihitung sebagai jumlah pesan email yang dipantulkan yang dikirim oleh semua kampanye yang dijalankan, dibagi dengan jumlah pesan email yang dikirim oleh semua kampanye yang dijalankan.  | 
|  Rasio pentalan, dikelompokkan berdasarkan kampanye yang dijalankan  |  `hard-bounce-rate-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, persentase pesan email yang tidak dapat dikirim ke penerima. Metrik ini hanya mengukur hard bounce — yaitu, pesan di mana alamat email penerima memiliki masalah permanen yang mencegah pesan dikirim. Metrik ini dihitung sebagai jumlah pesan email yang dipantulkan yang dikirim oleh kampanye yang dijalankan, dibagi dengan jumlah pesan email yang dikirim oleh kampanye yang dijalankan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Tingkat pengiriman  |  `successful-delivery-rate`  |  Untuk semua kampanye berjalan, persentase pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh semua kampanye berjalan dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim oleh semua kampanye yang dijalankan.  | 
|  Tingkat pengiriman, dikelompokkan berdasarkan kampanye  |  `successful-delivery-rate-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, persentase pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh kampanye yang dijalankan dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim oleh kampanye yang dijalankan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
| Tingkat pengiriman, dikelompokkan berdasarkan tanggal |  `successful-delivery-rate-grouped-by-date`  |  Untuk semua kampanye berjalan, persentase pesan yang dikirim ke penerima setiap hari dalam rentang tanggal yang ditentukan. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh semua kampanye yang dijalankan dan dikirim ke penerima, dibagi dengan jumlah pesan yang dikirim oleh semua kampanye yang dijalankan, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
| Tarif buka email |  `email-open-rate`  | Untuk semua kampanye berjalan, persentase pesan email yang dibuka oleh penerima.Metrik ini dihitung sebagai jumlah pesan email yang dikirim oleh semua kampanye yang dijalankan dan dibuka oleh penerima, dibagi dengan jumlah pesan email yang dikirim oleh semua kampanye yang dijalankan dan dikirim ke penerima. | 
|  Rasio buka email, dikelompokkan berdasarkan kampanye yang dijalankan  |  `email-open-rate-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, persentase pesan email yang dibuka oleh penerima. Metrik ini dihitung sebagai jumlah pesan email yang dikirim oleh kampanye yang dijalankan dan dibuka oleh penerima, dibagi dengan jumlah pesan email yang dikirim oleh kampanye yang dijalankan dan dikirim ke penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
| Email dibuka, dikelompokkan berdasarkan kampanye | `direct-email-opens-grouped-by-campaign-activity` |  Untuk setiap kampanye yang dijalankan, jumlah pesan email yang dibuka oleh penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Pengiriman titik akhir  |  `unique-deliveries`  |  Untuk semua kampanye berjalan, jumlah titik akhir unik yang dikirimkan pesan.  | 
|  Pengiriman titik akhir, dikelompokkan berdasarkan kampanye yang dijalankan  |  `unique-deliveries-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, jumlah titik akhir unik yang dikirimkan pesan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Pengiriman titik akhir, dikelompokkan berdasarkan tanggal  |  `unique-deliveries-grouped-by-date`  |  Untuk semua kampanye berjalan, jumlah titik akhir unik yang dikirimkan pesan, untuk setiap hari dalam rentang tanggal yang ditentukan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan hari kalender, dalam format ISO 8601 yang diperpanjang.  | 
|  Tautan diklik, dikelompokkan berdasarkan kampanye yang dijalankan  | `clicks-grouped-by-campaign-activity` |  Untuk setiap kampanye yang dijalankan, berapa kali penerima mengklik tautan dalam pesan email. Jika satu penerima mengklik beberapa tautan dalam pesan, atau mengklik tautan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Pesan terkirim, dikelompokkan berdasarkan kampanye yang dijalankan  |  `successful-deliveries-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, jumlah pesan yang dikirim ke penerima. Metrik ini dihitung sebagai jumlah pesan yang dikirim oleh kampanye yang dijalankan, dikurangi jumlah pesan yang tidak dapat dikirim ke penerima proses karena pantulan keras. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Pesan terkirim, dikelompokkan berdasarkan kampanye yang dijalankan  |  `attempted-deliveries-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, jumlah pesan yang dikirim. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
|  Dorong tingkat buka  |  `push-open-rate`  |  Untuk semua kampanye berjalan, persentase pemberitahuan push yang dibuka oleh penerima.  Metrik ini dihitung sebagai jumlah pemberitahuan push yang dikirim oleh semua kampanye yang dijalankan dan dibuka oleh penerima, dibagi dengan jumlah pemberitahuan push yang dikirim oleh semua kampanye yang dijalankan dan dikirim ke penerima.  | 
| Push open rate, dikelompokkan berdasarkan kampanye yang dijalankan |  `push-open-rate-grouped-by-campaign-activity`  |  Untuk setiap kampanye yang dijalankan, persentase pemberitahuan push yang dibuka oleh penerima. Metrik ini dihitung sebagai jumlah pemberitahuan push yang dikirim oleh kampanye yang dijalankan dan dibuka oleh penerima, dibagi dengan jumlah pemberitahuan push yang dikirim oleh kampanye yang dijalankan dan dikirim ke penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
| Total push dibuka, dikelompokkan berdasarkan kampanye | `direct-push-opens-grouped-by-campaign-activity` |  Untuk setiap kampanye yang dijalankan, jumlah pemberitahuan push yang dibuka oleh penerima. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas kampanye (`CampaignActivityId`), yang merupakan string yang secara unik mengidentifikasi kampanye yang dijalankan.  | 
| Total pengeluaran SMS | sms-spend | Untuk semua kampanye, jumlah total uang, dalam milisen, dihabiskan untuk mengirim SMS. | 

# Amazon Pinpoint metrik keterlibatan perjalanan
<a name="journey-metrics-engagement-email"></a>

Tabel berikut mencantumkan dan menjelaskan metrik keterlibatan perjalanan standar yang dapat Anda kueri untuk memantau tren semua pesan email yang dikirim oleh perjalanan Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik keterlibatan Journey](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) dari Amazon Pinpoint API. Kolom **kpi-name** dalam tabel menunjukkan nilai yang akan digunakan untuk `kpi-name` parameter dalam kueri. 


| Metrik | Nama KPI | Deskripsi | 
| --- | --- | --- | 
| Klik |  `journey-emails-clicked`  |  Berapa kali peserta mengklik tautan dalam pesan. Jika satu peserta mengklik beberapa tautan dalam pesan, atau mengklik tautan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan.  | 
| Klik, dikelompokkan berdasarkan aktivitas |  `emails-clicked-grouped-by-journey-activity`  |  Untuk setiap aktivitas dalam perjalanan, berapa kali peserta mengklik tautan dalam pesan. Jika satu peserta mengklik beberapa tautan dalam pesan, atau mengklik tautan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| Aduan |  `journey-emails-complained`  |  Jumlah pesan yang dilaporkan oleh peserta sebagai email yang tidak diminta atau tidak diinginkan.   | 
| Keluhan, dikelompokkan berdasarkan aktivitas |  `emails-complained-grouped-by-journey-activity`  | Untuk setiap aktivitas dalam perjalanan, jumlah pesan yang dilaporkan oleh peserta sebagai email yang tidak diminta atau tidak diinginkan.Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik. | 
| Pengiriman |  `journey-emails-delivered`  |  Jumlah pesan yang dikirimkan ke peserta. Metrik ini dihitung sebagai jumlah pesan yang dikirim, dikurangi jumlah pesan yang tidak dapat dikirim karena pantulan lunak atau keras, atau karena ditolak.  | 
| Pengiriman, dikelompokkan berdasarkan aktivitas |  `emails-delivered-grouped-by-journey-activity`  |  Untuk setiap kegiatan dalam perjalanan, jumlah pesan yang disampaikan kepada peserta. Metrik ini dihitung sebagai jumlah pesan yang dikirim, dikurangi jumlah pesan yang tidak dapat dikirim karena pantulan lunak atau keras, atau karena ditolak, untuk setiap aktivitas dalam perjalanan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| pentalan keras |  `journey-emails-hardbounced`  |  Jumlah pesan yang tidak dapat dikirim ke peserta karena pantulan yang keras. Hard bounce terjadi jika masalah persisten mencegah pesan dikirimkan—misalnya, jika alamat email peserta tidak ada.  | 
| Pantulan keras, dikelompokkan berdasarkan aktivitas |  `emails-hardbounced-grouped-by-journey-activity`  |  Untuk setiap aktivitas dalam perjalanan, jumlah pesan yang tidak dapat dikirim ke peserta karena pantulan keras. Hard bounce terjadi jika masalah persisten mencegah pesan dikirimkan—misalnya, jika alamat email peserta tidak ada. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| Membuka |  `journey-emails-opened`  |  Jumlah pesan yang dibuka oleh peserta.  | 
| Dibuka, dikelompokkan berdasarkan aktivitas |  `emails-opened-grouped-by-journey-activity`  |  Untuk setiap kegiatan dalam perjalanan, jumlah pesan yang dibuka oleh peserta. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| Penolakan | `journey-emails-rejected` | Jumlah pesan yang tidak dikirim ke peserta karena ditolak. Pesan ditolak jika Amazon Pinpoint menentukan bahwa pesan tersebut berisi malware. Amazon Pinpoint tidak mencoba mengirim pesan yang ditolak. | 
| Penolakan, dikelompokkan berdasarkan aktivitas | `emails-rejected-grouped-by-journey-activity` | Untuk setiap aktivitas dalam perjalanan, jumlah pesan yang tidak dikirim ke peserta karena ditolak. Pesan ditolak jika Amazon Pinpoint menentukan bahwa pesan tersebut berisi malware. Amazon Pinpoint tidak mencoba mengirim pesan yang ditolak. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik. | 
| Mengirim |  `journey-emails-sent`  |  Jumlah pesan yang dikirim.  | 
| Mengirim, dikelompokkan berdasarkan aktivitas |  `emails-sent-grouped-by-journey-activity`  |  Untuk setiap aktivitas dalam perjalanan, jumlah pesan yang dikirim. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| Pantulan lembut |  `journey-emails-softbounced`  |  Jumlah pesan yang tidak dapat dikirim ke peserta karena soft bounce. Soft bounce terjadi jika masalah sementara mencegah pesan dikirimkan—misalnya, jika kotak masuk peserta penuh atau server penerima sementara tidak tersedia.  | 
| Pantulan lunak, dikelompokkan berdasarkan aktivitas |  `emails-softbounced-grouped-by-journey-activity`  |  Untuk setiap aktivitas dalam perjalanan, jumlah pesan yang tidak dapat dikirimkan ke peserta karena soft bounce. Soft bounce terjadi jika masalah sementara mencegah pesan dikirimkan—misalnya, jika kotak masuk peserta penuh atau server penerima sementara tidak tersedia. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik.  | 
| Berhenti berlangganan | `journey-emails-unsubscribed` |  Berapa kali peserta mengklik tautan berhenti berlangganan dalam pesan. Jika satu peserta mengklik tautan berhenti berlangganan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan.  | 
| Berhenti berlangganan, dikelompokkan berdasarkan aktivitas | `emails-unsubscribed-grouped-by-journey-activity` | Untuk setiap aktivitas dalam perjalanan, berapa kali peserta mengklik tautan berhenti berlangganan dalam pesan. Jika satu peserta mengklik tautan berhenti berlangganan yang sama lebih dari sekali, setiap klik disertakan dalam hitungan. Hasil kueri untuk metrik ini dikelompokkan berdasarkan ID aktivitas (`JourneyActivityId`), yang merupakan string yang mengidentifikasi aktivitas secara unik. | 

# Amazon Pinpoint metrik eksekusi perjalanan
<a name="journey-metrics-execution"></a>

Tabel berikut mencantumkan dan menjelaskan metrik eksekusi standar yang dapat Anda kueri untuk menilai status peserta dalam perjalanan Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik eksekusi Journey](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) dari Amazon Pinpoint API. Kolom **Bidang** dalam tabel mengidentifikasi nama bidang yang muncul dalam hasil kueri untuk setiap metrik. 


| Metrik | Bidang | Deskripsi | 
| --- | --- | --- | 
|  Peserta aktif  |  `ENDPOINT_ACTIVE`  |  Jumlah peserta yang aktif melanjutkan kegiatan dalam perjalanan. Metrik ini dihitung sebagai jumlah peserta yang memulai perjalanan, dikurangi jumlah peserta yang meninggalkan perjalanan dan jumlah peserta yang dikeluarkan dari perjalanan.   | 
|  Pembatalan peserta  |  `CANCELLED`  |  Jumlah peserta yang tidak menyelesaikan perjalanan karena perjalanan dibatalkan.  | 
|  Keberangkatan peserta  |  `ENDPOINT_LEFT`  |  Jumlah peserta yang meninggalkan perjalanan.  | 
|  Entri peserta  |  `ENDPOINT_ENTERED`  |  Jumlah peserta yang memulai perjalanan.  | 
|  Pengecualian peserta, batas masuk kembali  |  `REENTRY_CAP_EXCEEDED`  |  Jumlah peserta yang tidak menyelesaikan perjalanan karena mereka akan melebihi jumlah maksimum kali satu peserta dapat memasuki kembali perjalanan.  | 
|  Pengecualian peserta, penolakan  |  `ACTIVE_ENDPOINT_REJECTED`  |  Jumlah peserta yang tidak dapat memulai perjalanan karena mereka sudah menjadi peserta aktif dalam perjalanan. Peserta ditolak jika mereka memulai perjalanan dan Anda kemudian memperbarui definisi titik akhir mereka dengan cara yang memengaruhi inklusi mereka dalam suatu segmen (berdasarkan kriteria segmen) atau perjalanan (berdasarkan kondisi aktivitas).  | 

# Amazon Pinpoint metrik eksekusi aktivitas perjalanan
<a name="journey-metrics-activity-execution"></a>

Tabel berikut mencantumkan dan menjelaskan metrik eksekusi standar yang dapat Anda kueri untuk menilai status peserta di setiap jenis aktivitas individual untuk perjalanan Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan sumber daya [metrik eksekusi aktivitas Journey](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) dari Amazon Pinpoint API. Kolom **Metrik** dalam tabel mencantumkan bidang yang muncul dalam hasil kueri untuk setiap jenis aktivitas. Ini juga memberikan deskripsi singkat dari setiap bidang.


| Jenis aktivitas | Metrik-metrik | 
| --- | --- | 
|  Ya/Tidak split () `CONDITIONAL_SPLIT`  |  Metriknya adalah:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) Metrik tambahan tersedia untuk aktivitas di setiap jalur. Untuk informasi tentang metrik tersebut, lihat baris dalam tabel ini untuk jenis aktivitas tersebut.  | 
|  Penahanan () `HOLDOUT`  |  Metriknya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/journey-metrics-activity-execution.html)  | 
| Email (`MESSAGE`) |  Metriknya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/journey-metrics-activity-execution.html)  | 
| Pemisahan multivariat () `MULTI_CONDITIONAL_SPLIT` |  Untuk setiap jalur kegiatan, jumlah peserta yang melanjutkan ke kegiatan di jalur. Hasil kueri untuk metrik ini dikelompokkan berdasarkan jalur, `Branch_#` di *\$1* mana pengidentifikasi numerik untuk jalur—misalnya, `Branch_1` untuk jalur pertama aktivitas. Metrik tambahan tersedia untuk aktivitas di setiap jalur. Untuk informasi tentang metrik tersebut, lihat baris dalam tabel ini untuk jenis aktivitas tersebut.  | 
| Pemisahan acak (`RANDOM_SPLIT`) |  Untuk setiap jalur kegiatan, jumlah peserta yang melanjutkan ke kegiatan di jalur. Hasil kueri untuk metrik ini dikelompokkan berdasarkan jalur, `Branch_#` di *\$1* mana pengidentifikasi numerik untuk jalur—misalnya, `Branch_1` untuk jalur pertama aktivitas. Metrik tambahan tersedia untuk aktivitas di setiap jalur. Untuk informasi tentang metrik tersebut, lihat baris dalam tabel ini untuk jenis aktivitas tersebut.  | 
| Tunggu (`WAIT`) |  Metriknya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/journey-metrics-activity-execution.html)  | 
| Pusat Kontak (`CONTACT_CENTER`) |  Metriknya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/journey-metrics-activity-execution.html)  | 

# Amazon Pinpoint metrik perjalanan dan eksekusi kampanye
<a name="journey-run-metrics-activity-execution"></a>

Anda dapat melakukan kueri metrik eksekusi standar untuk menilai status peserta di setiap jenis aktivitas individual untuk perjalanan atau kampanye Amazon Pinpoint. Untuk menanyakan data metrik ini, gunakan metrik [eksekusi aktivitas yang dijalankan Journey](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) atau sumber daya [Metrik Kampanye](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) Amazon Pinpoint API. Tabel berikut mencantumkan bidang yang muncul dalam hasil kueri untuk setiap jenis aktivitas. 


****  

| Nama Metrik | Berlaku untuk Perjalanan, Kampanye, atau Keduanya | Deskripsi | 
| --- | --- | --- | 
| ENDPOINT\$1PRODUCED | Keduanya | Jumlah titik akhir yang awalnya dihasilkan dari segmen atau peristiwa sebelum penyaringan apa pun. | 
| TITIK AKHIR\$1FROM\$1USER | Keduanya | Jika pelanggan hanya memiliki segmen user-id, maka semua titik akhir pengguna tersebut akan ditambahkan. Metrik ini mengukur jumlah titik akhir yang ditambahkan dengan cara ini. | 
| TITIK AKHIR\$1OPT\$1OUT | Keduanya | Titik akhir dipilih keluar dan tidak memasuki kampanye atau perjalanan. | 
| ENDPOINT\$1INACTIVE | Keduanya | Titik akhir tidak aktif dan tidak memasuki kampanye atau perjalanan. | 
| DISARING\$1OUT\$1BY\$1SEGMENT | Keduanya | Endpoint tidak cocok dengan filter segmen dan tidak memasuki kampanye atau perjalanan. | 
| ENDPOINT\$1MISSING\$1ADDRESS | Keduanya | Endpoint kehilangan alamat dan tidak memasuki kampanye atau perjalanan. | 
| ENDPOINT\$1MISSING\$1CHANNEL | Keduanya | Endpoint kehilangan saluran dan tidak memasuki kampanye atau perjalanan. | 
| ENDPOINT\$1MISSING\$1TIMEZONE | Keduanya | Titik akhir kehilangan nilai untuk zona waktu dan disaring. Ini hanya terjadi ketika nilai zona waktu diperlukan. | 
| ENDPOINT\$1TIMEZONE\$1MISMATCH | Keduanya | Endpoint berada di zona waktu yang tidak termasuk dalam eksekusi pada saat itu. | 
| ENDPOINT\$1CHANNEL\$1MISMATCH | Kampanye | Kampanye tidak memiliki pesan yang dikonfigurasi untuk jenis saluran titik akhir ini. | 
| DUPLIKAT\$1TITIK AKHIR | Keduanya | Titik akhir duplikat ditemukan dan dihilangkan ditipu. | 
| DUPLIKATE\$1USER | Keduanya | Pengguna duplikat ditemukan dan di-de-ditipu dari segmen khusus user-id. Jika mereka memiliki id pengguna yang sama, metrik 1 akan dipancarkan. | 
| DIJEDA | Perjalanan | Dihapus dari eksekusi karena perjalanan dihentikan sementara. | 
| BERAKHIR | Perjalanan | Dihapus dari eksekusi karena perjalanan telah berakhir. | 
| PENGOBATAN\$1HOLDOUT | Kampanye | Ini dipancarkan dalam A/B kampanye, untuk titik akhir yang kohortnya tidak cocok dengan perlakuan saat ini. Misalnya dalam A/B pemisahan 50/50, 50% titik akhir akan memancarkan metrik ini untuk setiap perlakuan | 
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | Perjalanan | Estimasi zona waktu mampu memperkirakan zona waktu untuk titik akhir. | 

# Kueri data analitik Amazon Pinpoint untuk kampanye
<a name="analytics-query-campaigns"></a>

Selain menggunakan halaman analitik di konsol Amazon Pinpoint, Anda dapat menggunakan Amazon Pinpoint APIs Analytics untuk menanyakan data analitik untuk subset metrik standar yang memberikan wawasan tentang tren pengiriman dan keterlibatan untuk kampanye.

Masing-masing metrik ini adalah nilai terukur, juga disebut sebagai *indikator kinerja utama (KPI)*, yang dapat membantu Anda memantau dan menilai kinerja satu atau lebih kampanye. Misalnya, Anda dapat menggunakan metrik untuk mengetahui berapa banyak titik akhir pesan kampanye dikirim, atau berapa banyak pesan yang dikirim ke titik akhir yang dimaksud.

Amazon Pinpoint secara otomatis mengumpulkan dan menggabungkan data ini untuk semua kampanye Anda. Ini menyimpan data selama 90 hari. Jika Anda mengintegrasikan aplikasi seluler dengan Amazon Pinpoint menggunakan SDK AWS Seluler, Amazon Pinpoint memperluas dukungan ini untuk menyertakan metrik tambahan, seperti persentase pemberitahuan push yang dibuka oleh penerima. Untuk informasi tentang mengintegrasikan aplikasi seluler, lihat[Integrasikan Amazon Pinpoint dengan aplikasi Anda](integrate.md).

Jika Anda menggunakan Amazon Pinpoint Analytics APIs untuk menanyakan data, Anda dapat memilih berbagai opsi yang menentukan cakupan, data, pengelompokan, dan filter untuk kueri Anda. Anda melakukannya dengan menggunakan parameter yang menentukan proyek, kampanye, dan metrik yang ingin Anda kueri, selain filter berbasis tanggal yang ingin Anda terapkan. 

Topik ini menjelaskan dan memberikan contoh cara memilih opsi ini dan menanyakan data untuk satu atau beberapa kampanye.

## Prasyarat
<a name="analytics-query-campaigns-prerequisites"></a>

Sebelum Anda menanyakan data analitik untuk satu atau beberapa kampanye, ada baiknya mengumpulkan informasi berikut, yang Anda gunakan untuk menentukan kueri Anda:
+ **ID Proyek** — Pengidentifikasi unik untuk proyek yang terkait dengan kampanye atau kampanye. Di Amazon Pinpoint API, nilai ini disimpan di properti. `application-id` Di konsol Amazon Pinpoint, nilai ini ditampilkan sebagai **ID Proyek** di halaman **Semua proyek**.
+ **ID Kampanye** — Pengidentifikasi unik untuk kampanye, jika Anda ingin menanyakan data hanya untuk satu kampanye. Di Amazon Pinpoint API, nilai ini disimpan di properti. `campaign-id` Nilai ini tidak ditampilkan di konsol.
+ **Rentang tanggal** - Secara opsional, tanggal dan waktu pertama dan terakhir dari rentang tanggal untuk menanyakan data. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, mereka harus mulai kurang dari 90 hari dari hari ini. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint secara otomatis menanyakan data untuk 31 hari kalender sebelumnya.
+ **Jenis metrik** — Jenis metrik untuk kueri. Ada dua jenis, metrik *aplikasi dan metrik* *kampanye*. *Metrik aplikasi* menyediakan data untuk semua kampanye yang terkait dengan proyek, juga disebut sebagai *aplikasi*. *Metrik kampanye* hanya menyediakan data untuk satu kampanye.
+ **Metrik** — Nama metrik untuk kueri — lebih khusus lagi, `kpi-name` nilai untuk metrik. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Ini juga membantu menentukan apakah Anda ingin mengelompokkan data berdasarkan bidang yang relevan. Jika ya, Anda dapat menyederhanakan analisis dan pelaporan dengan memilih metrik yang dirancang untuk mengelompokkan data secara otomatis. Misalnya, Amazon Pinpoint menyediakan beberapa metrik standar yang melaporkan persentase pesan yang dikirimkan ke penerima kampanye. Salah satu metrik ini secara otomatis mengelompokkan data berdasarkan date (`successful-delivery-rate-grouped-by-date`). Metrik lain secara otomatis mengelompokkan data berdasarkan campaign run (`successful-delivery-rate-grouped-by-campaign-activity`). Metrik ketiga hanya menampilkan satu nilai—persentase pesan yang dikirimkan ke penerima oleh semua kampanye run (). `successful-delivery-rate` 

Jika Anda tidak dapat menemukan metrik standar yang mengelompokkan data seperti yang Anda inginkan, Anda dapat mengembangkan serangkaian kueri yang mengembalikan data yang Anda inginkan. Anda kemudian dapat secara manual memecah atau menggabungkan hasil kueri ke dalam grup kustom yang Anda desain.

Terakhir, penting untuk memverifikasi bahwa Anda berwenang untuk mengakses data yang ingin Anda kueri. Untuk informasi selengkapnya, lihat [Kebijakan IAM untuk menanyakan data analitik Amazon Pinpoint](analytics-permissions.md).

# Kueri data Amazon Pinpoint untuk satu kampanye
<a name="analytics-query-campaigns-single"></a>

Untuk melakukan kueri data untuk satu kampanye, Anda menggunakan API [Metrik Kampanye](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) dan menentukan nilai untuk parameter wajib berikut:
+ **application-id** — ID proyek, yang merupakan pengenal unik untuk proyek yang terkait dengan kampanye. Di Amazon Pinpoint, istilah *proyek* dan *aplikasi memiliki arti* yang sama. 
+ **campaign-id** — Pengenal unik untuk kampanye.
+ **kpi-name — Nama** metrik untuk kueri. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Anda juga dapat menerapkan filter yang menanyakan data untuk rentang tanggal tertentu. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint mengembalikan data untuk 31 hari kalender sebelumnya. Untuk memfilter data berdasarkan tanggal yang berbeda, gunakan parameter rentang tanggal yang didukung untuk menentukan tanggal dan waktu pertama dan terakhir dari rentang tanggal. Nilai harus dalam format ISO 8601 yang diperluas dan menggunakan Coordinated Universal Time (UTC) —misalnya, `2019-07-19T20:00:00Z` untuk 8:00 PM UTC 19 Juli 2019. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, tanggal dan waktu pertama harus kurang dari 90 hari dari hari ini.

Contoh berikut menunjukkan cara melakukan kueri data analitik untuk kampanye menggunakan Amazon Pinpoint REST API, the AWS CLI, dan. AWS SDK untuk Java Anda dapat menggunakan AWS SDK apa pun yang didukung untuk menanyakan data analitik untuk kampanye. AWS CLI Contoh diformat untuk Microsoft Windows. Untuk Unix, Linux, dan macOS, ganti karakter line-continuation tanda sisipan (^) dengan garis miring terbalik (\$1).

------
#### [ REST API ]

Untuk menanyakan data analitik kampanye menggunakan Amazon Pinpoint REST API, kirim permintaan HTTP (S) GET ke URI [Metrik Kampanye](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Di URI, tentukan nilai yang sesuai untuk parameter jalur yang diperlukan:

```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```

Di mana:
+ *endpoint*adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek yang terkait dengan kampanye.
+ *application-id*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *campaign-id*adalah pengenal unik untuk kampanye.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Semua parameter harus dikodekan URL.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, tambahkan parameter `start-time` dan nilai `end-time` kueri dan ke URI. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Gunakan ampersand (&) untuk memisahkan parameter.

Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye, dari 19 Juli 2019 hingga 26 Juli 2019:

```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```

Di mana:
+ `pinpoint.us-east-1.amazonaws.com`adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `80b8efd84042ff8d9c96ce2f8example`adalah pengenal unik untuk kampanye.
+ `unique-deliveries`adalah `kpi-name` nilai untuk metrik kampanye *pengiriman titik akhir*, yang merupakan metrik yang melaporkan jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ AWS CLI ]

Untuk melakukan kueri data analitik untuk kampanye dengan menggunakan AWS CLI, gunakan **get-campaign-date-range-kpi** perintah dan tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
C:\> aws pinpoint get-campaign-date-range-kpi ^
    --application-id application-id ^
    --campaign-id campaign-id ^
    --kpi-name kpi-name
```

Di mana:
+ *application-id*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *campaign-id*adalah pengenal unik untuk kampanye.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, tambahkan `end-time` parameter `start-time` dan nilai ke kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye, dari 19 Juli 2019 hingga 26 Juli 2019:

```
C:\> aws pinpoint get-campaign-date-range-kpi ^
    --application-id 1234567890123456789012345example ^
    --campaign-id 80b8efd84042ff8d9c96ce2f8example ^
    --kpi-name unique-deliveries ^
    --start-time 2019-07-19T00:00:00Z ^
    --end-time 2019-07-26T23:59:59Z
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `80b8efd84042ff8d9c96ce2f8example`adalah pengenal unik untuk kampanye.
+ `unique-deliveries`adalah `kpi-name` nilai untuk metrik kampanye *pengiriman titik akhir*, yang merupakan metrik yang melaporkan jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ SDK for Java ]

Untuk melakukan kueri data analitik untuk kampanye menggunakan AWS SDK untuk Java, gunakan **GetCampaignDateRangeKpiRequest** metode API [Metrik Kampanye](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
        .withApplicationId("applicationId")
        .withCampaignId("campaignId")
        .withKpiName("kpiName")
```

Di mana:
+ *applicationId*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *campaignId*adalah pengenal unik untuk kampanye.
+ *kpiName*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, sertakan `endTime` parameter `startTime` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye, dari 19 Juli 2019 hingga 26 Juli 2019:

```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
        .withApplicationId("1234567890123456789012345example")
        .withCampaignId("80b8efd84042ff8d9c96ce2f8example")
        .withKpiName("unique-deliveries")
        .withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
        .withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `80b8efd84042ff8d9c96ce2f8example`adalah pengenal unik untuk kampanye.
+ `unique-deliveries`adalah `kpi-name` nilai untuk metrik kampanye *pengiriman titik akhir*, yang merupakan metrik yang melaporkan jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------

Setelah mengirim kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Struktur hasil bervariasi tergantung pada metrik yang Anda kueri. Beberapa metrik hanya mengembalikan satu nilai. Misalnya, metrik kampanye *endpoint deliveries* (`unique-deliveries`), yang digunakan dalam contoh sebelumnya, mengembalikan satu nilai—jumlah titik akhir unik yang dikirimkan pesan, oleh semua proses kampanye. Dalam hal ini, respons JSON adalah sebagai berikut:

```
{
    "CampaignDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "CampaignId":"80b8efd84042ff8d9c96ce2f8example",
        "EndTime":"2019-07-26T23:59:59Z",
        "KpiName":"unique-deliveries",
        "KpiResult":{
            "Rows":[
                {
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"123.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-07-19T00:00:00Z"
    }
}
```

Metrik lain mengembalikan beberapa nilai, dan mengelompokkan nilai berdasarkan bidang yang relevan. Jika metrik mengembalikan beberapa nilai, respons JSON menyertakan bidang yang menunjukkan bidang mana yang digunakan untuk mengelompokkan data.

Untuk mempelajari lebih lanjut tentang struktur hasil kueri, lihat[Gunakan hasil kueri JSON](analytics-query-results.md).

# Kueri data Amazon Pinpoint untuk beberapa kampanye
<a name="analytics-query-campaigns-multiple"></a>

Ada dua cara untuk menanyakan data untuk beberapa kampanye. Cara terbaik tergantung pada apakah Anda ingin menanyakan data untuk kampanye yang semuanya terkait dengan proyek yang sama. Jika Anda melakukannya, itu juga tergantung pada apakah Anda ingin menanyakan data untuk semua atau hanya atau sebagian dari kampanye tersebut.

Untuk menanyakan data kampanye yang terkait dengan proyek yang berbeda atau hanya untuk subset kampanye yang terkait dengan proyek yang sama, pendekatan terbaik adalah membuat dan menjalankan serangkaian kueri individual, satu untuk setiap kampanye yang ingin Anda kueri datanya. Bagian sebelumnya menjelaskan cara menanyakan data hanya untuk satu kampanye.

Untuk melakukan kueri data untuk semua kampanye yang terkait dengan project yang sama, Anda dapat menggunakan [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API. Tentukan nilai untuk parameter yang diperlukan berikut:
+ **application-id — ID** proyek, yang merupakan pengidentifikasi unik untuk proyek. Di Amazon Pinpoint, istilah *proyek* dan *aplikasi memiliki arti* yang sama.
+ **kpi-name — Nama** metrik untuk kueri. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Anda juga dapat memfilter data berdasarkan rentang tanggal. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint mengembalikan data untuk 31 hari kalender sebelumnya. Untuk memfilter data berdasarkan tanggal yang berbeda, gunakan parameter rentang tanggal yang didukung untuk menentukan tanggal dan waktu pertama dan terakhir dari rentang tanggal. Nilai harus dalam format ISO 8601 yang diperluas dan menggunakan Coordinated Universal Time (UTC) —misalnya, `2019-07-19T20:00:00Z` untuk 8:00 PM UTC 19 Juli 2019. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, tanggal dan waktu pertama harus kurang dari 90 hari dari hari ini.

Contoh berikut menunjukkan cara melakukan kueri data analitik untuk kampanye menggunakan Amazon Pinpoint REST API, the AWS CLI, dan. AWS SDK untuk Java Anda dapat menggunakan AWS SDK apa pun yang didukung untuk menanyakan data analitik untuk kampanye. AWS CLI Contoh diformat untuk Microsoft Windows. Untuk Unix, Linux, dan macOS, ganti karakter line-continuation tanda sisipan (^) dengan garis miring terbalik (\$1).

------
#### [ REST API ]

Untuk melakukan kueri data analitik untuk beberapa kampanye menggunakan Amazon Pinpoint REST API, kirim permintaan HTTP (S) GET ke URI [Metrik Aplikasi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Di URI, tentukan nilai yang sesuai untuk parameter jalur yang diperlukan:

```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```

Di mana:
+ *endpoint*adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek yang terkait dengan kampanye.
+ *application-id*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Semua parameter harus dikodekan URL.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, tambahkan parameter `start-time` dan nilai `end-time` kueri dan ke URI. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Gunakan ampersand (&) untuk memisahkan parameter.

Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh masing-masing kampanye proyek, dari 19 Juli 2019 hingga 26 Juli 2019:

```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```

Di mana:
+ `pinpoint.us-east-1.amazonaws.com`adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `unique-deliveries-grouped-by-campaign`adalah `kpi-name` nilai untuk *pengiriman titik akhir, dikelompokkan berdasarkan metrik aplikasi kampanye*, yang merupakan metrik yang mengembalikan jumlah titik akhir unik yang dikirimkan pesan, oleh setiap kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ AWS CLI ]

Untuk melakukan kueri data analitik untuk beberapa kampanye dengan menggunakan AWS CLI, gunakan **get-application-date-range-kpi** perintah dan tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id application-id ^
    --kpi-name kpi-name
```

Di mana:
+ *application-id*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, sertakan `end-time` parameter `start-time` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh masing-masing kampanye proyek, dari 19 Juli 2019 hingga 26 Juli 2019:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id 1234567890123456789012345example ^
    --kpi-name unique-deliveries-grouped-by-campaign ^
    --start-time 2019-07-19T00:00:00Z ^
    --end-time 2019-07-26T23:59:59Z
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `unique-deliveries-grouped-by-campaign`adalah `kpi-name` nilai untuk *pengiriman titik akhir, dikelompokkan berdasarkan metrik aplikasi kampanye*, yang merupakan metrik yang mengembalikan jumlah titik akhir unik yang dikirimkan pesan, oleh setiap kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ SDK for Java ]

Untuk melakukan kueri data analitik untuk beberapa kampanye dengan menggunakan AWS SDK untuk Java, gunakan **GetApplicationDateRangeKpiRequest** metode [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API. Tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("applicationId")
        .withKpiName("kpiName")
```

Di mana:
+ *applicationId*adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ *kpiName*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, sertakan `endTime` parameter `startTime` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah titik akhir unik yang dikirimkan pesan, oleh masing-masing kampanye proyek, dari 19 Juli 2019 hingga 26 Juli 2019:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("1234567890123456789012345example")
        .withKpiName("unique-deliveries-grouped-by-campaign")
        .withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
        .withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek yang terkait dengan kampanye.
+ `unique-deliveries-grouped-by-campaign`adalah `kpi-name` nilai untuk *pengiriman titik akhir, dikelompokkan berdasarkan metrik aplikasi kampanye*, yang merupakan metrik yang mengembalikan jumlah titik akhir unik yang dikirimkan pesan, oleh setiap kampanye.
+ `2019-07-19T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-07-26T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------

Setelah mengirim kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Struktur hasil bervariasi tergantung pada metrik yang Anda kueri. Beberapa metrik hanya mengembalikan satu nilai. Metrik lain mengembalikan beberapa nilai, dan nilai-nilai tersebut dikelompokkan berdasarkan bidang yang relevan. Jika metrik mengembalikan beberapa nilai, respons JSON menyertakan bidang yang menunjukkan bidang mana yang digunakan untuk mengelompokkan data.

Misalnya, *pengiriman titik akhir, yang dikelompokkan berdasarkan metrik aplikasi campaign* (`unique-deliveries-grouped-by-campaign`), yang digunakan dalam contoh sebelumnya, menampilkan beberapa nilai—jumlah titik akhir unik yang dikirimkan pesan, untuk setiap kampanye yang terkait dengan proyek. Dalam hal ini, respons JSON adalah sebagai berikut:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-07-26T23:59:59Z",
        "KpiName":"unique-deliveries-grouped-by-campaign",
        "KpiResult":{
            "Rows":[
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"80b8efd84042ff8d9c96ce2f8example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"123.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"810c7aab86d42fb2b56c8c966example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"456.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"42d8c7eb0990a57ba1d5476a3example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"789.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-07-19T00:00:00Z"
    }
}
```

Dalam hal ini, `GroupedBys` bidang menunjukkan bahwa nilai dikelompokkan berdasarkan ID kampanye (`CampaignId`).

Untuk mempelajari lebih lanjut tentang struktur hasil kueri, lihat[Gunakan hasil kueri JSON](analytics-query-results.md).

# Kueri data analitik Amazon Pinpoint untuk pesan transaksional
<a name="analytics-query-txn-messaging"></a>

Selain menggunakan halaman analitik di konsol Amazon Pinpoint, Anda dapat menggunakan Amazon Pinpoint APIs Analytics untuk menanyakan data analitik untuk subset metrik standar yang memberikan wawasan tentang tren pengiriman dan keterlibatan untuk pesan transaksional yang dikirim untuk proyek. 

Masing-masing metrik ini adalah nilai terukur, juga disebut sebagai *indikator kinerja utama (KPI)*, yang dapat membantu Anda memantau dan menilai kinerja pesan transaksional. Misalnya, Anda dapat menggunakan metrik untuk mengetahui berapa banyak email transaksional atau pesan SMS yang Anda kirim, atau berapa banyak pesan yang dikirim ke penerima. Amazon Pinpoint secara otomatis mengumpulkan dan menggabungkan data ini untuk semua email transaksional dan pesan SMS yang Anda kirim untuk sebuah proyek. Ini menyimpan data selama 90 hari.

Jika Anda menggunakan Amazon Pinpoint Analytics APIs untuk menanyakan data, Anda dapat memilih berbagai opsi yang menentukan cakupan, data, pengelompokan, dan filter untuk kueri Anda. Anda melakukan ini dengan menggunakan parameter yang menentukan proyek dan metrik yang ingin Anda kueri, selain filter berbasis tanggal yang ingin Anda terapkan. 

Topik ini menjelaskan dan memberikan contoh bagaimana memilih opsi ini dan meminta data pesan transaksional untuk sebuah proyek.

## Prasyarat
<a name="analytics-query-txn-messaging-prerequisites"></a>

Sebelum Anda menanyakan data analitik untuk pesan transaksional, ada baiknya mengumpulkan informasi berikut, yang Anda gunakan untuk menentukan kueri Anda:
+ **ID Proyek** — Pengidentifikasi unik untuk proyek tempat pesan dikirim. Di Amazon Pinpoint API, nilai ini disimpan di properti. `application-id` Di konsol Amazon Pinpoint, nilai ini ditampilkan sebagai **ID Proyek** di halaman **Semua proyek**.
+ **Rentang tanggal** - Secara opsional, tanggal dan waktu pertama dan terakhir dari rentang tanggal untuk menanyakan data. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, mereka harus mulai kurang dari 90 hari dari hari ini. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint secara otomatis menanyakan data untuk 31 hari kalender sebelumnya.
+ **Metrik** — Nama metrik untuk kueri — lebih khusus lagi, `kpi-name` nilai untuk metrik. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Ini juga membantu menentukan apakah Anda ingin mengelompokkan data berdasarkan bidang yang relevan. Jika ya, Anda dapat menyederhanakan analisis dan pelaporan dengan memilih metrik yang dirancang untuk mengelompokkan data secara otomatis. Misalnya, Amazon Pinpoint menyediakan beberapa metrik standar yang melaporkan jumlah pesan SMS transaksional yang dikirimkan ke penerima. Salah satu metrik ini secara otomatis mengelompokkan data berdasarkan date (`txn-sms-delivered-grouped-by-date`). Metrik lain secara otomatis mengelompokkan data berdasarkan negara atau wilayah (`txn-sms-delivered-grouped-by-country`). Metrik ketiga hanya mengembalikan satu nilai—jumlah pesan yang dikirim ke penerima (). `txn-sms-delivered` Jika Anda tidak dapat menemukan metrik standar yang mengelompokkan data seperti yang Anda inginkan, Anda dapat mengembangkan serangkaian kueri yang mengembalikan data yang Anda inginkan. Anda kemudian dapat secara manual memecah atau menggabungkan hasil kueri ke dalam grup kustom yang Anda desain.

Terakhir, penting untuk memverifikasi bahwa Anda berwenang untuk mengakses data yang ingin Anda kueri. Untuk informasi selengkapnya, lihat [Kebijakan IAM untuk menanyakan data analitik Amazon Pinpoint](analytics-permissions.md).

# Kueri data Amazon Pinpoint untuk pesan email transaksional
<a name="analytics-query-txn-messaging-email"></a>

Untuk melakukan kueri data untuk pesan email transaksional yang dikirim untuk proyek, Anda menggunakan [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API dan menentukan nilai untuk parameter wajib berikut:
+ **application-id — ID** proyek, yang merupakan pengenal unik untuk proyek. Di Amazon Pinpoint, istilah *proyek* dan *aplikasi memiliki arti* yang sama.
+ **kpi-name — Nama** metrik untuk kueri. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Anda juga dapat menerapkan filter yang menanyakan data untuk rentang tanggal tertentu. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint mengembalikan data untuk 31 hari kalender sebelumnya. Untuk memfilter data berdasarkan tanggal yang berbeda, gunakan parameter rentang tanggal yang didukung untuk menentukan tanggal dan waktu pertama dan terakhir dari rentang tanggal. Nilai harus dalam format ISO 8601 yang diperluas dan menggunakan Coordinated Universal Time (UTC) —misalnya, `2019-09-06T20:00:00Z` untuk 8:00 PM UTC 6 September 2019. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, tanggal dan waktu pertama harus kurang dari 90 hari dari hari ini.

Contoh berikut menunjukkan cara melakukan kueri data analitik untuk pesan email transaksional dengan menggunakan Amazon Pinpoint REST API, AWS CLI the, dan file. AWS SDK untuk Java Anda dapat menggunakan AWS SDK apa pun yang didukung untuk menanyakan data analitik untuk pesan transaksional. AWS CLI Contoh diformat untuk Microsoft Windows. Untuk Unix, Linux, dan macOS, ganti karakter line-continuation tanda sisipan (^) dengan garis miring terbalik (\$1).

------
#### [ REST API ]

[Untuk melakukan kueri data analitik untuk pesan email transaksional menggunakan Amazon Pinpoint REST API, kirim permintaan HTTP (S) GET ke URI Metrik Aplikasi.](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) Di URI, tentukan nilai yang sesuai untuk parameter jalur yang diperlukan:

```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```

Di mana:
+ *endpoint*adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ *application-id*adalah pengenal unik untuk proyek tersebut.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Semua parameter harus dikodekan URL.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, tambahkan parameter `start-time` dan nilai `end-time` kueri dan ke URI. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Gunakan ampersand (&) untuk memisahkan parameter.

Misalnya, permintaan berikut mengambil jumlah pesan email transaksional yang dikirim untuk proyek dari 6 September 2019 hingga 13 September 2019:

```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```

Di mana:
+ `pinpoint.us-east-1.amazonaws.com`adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-emails-sent`adalah `kpi-name` nilai untuk metrik aplikasi *pengiriman*, yang merupakan metrik yang melaporkan jumlah pesan email transaksional yang dikirim untuk suatu proyek.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-13T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ AWS CLI ]

Untuk kueri data analitik untuk pesan email transaksional dengan menggunakan AWS CLI, gunakan **get-application-date-range-kpi** perintah, dan tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id application-id ^
    --kpi-name kpi-name
```

Di mana:
+ *application-id*adalah pengenal unik untuk proyek tersebut.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, tambahkan `end-time` parameter `start-time` dan nilai ke kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah pesan email transaksional yang dikirim untuk proyek dari 6 September 2019 hingga 13 September 2019:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id 1234567890123456789012345example ^
    --kpi-name txn-emails-sent ^
    --start-time 2019-09-06T00:00:00Z ^
    --end-time 2019-09-13T23:59:59Z
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-emails-sent`adalah `kpi-name` nilai untuk metrik aplikasi *pengiriman*, yang merupakan metrik yang melaporkan jumlah pesan email transaksional yang dikirim untuk suatu proyek.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-13T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ SDK for Java ]

Untuk melakukan kueri data analitik untuk pesan email transaksional dengan menggunakan AWS SDK untuk Java, gunakan **GetApplicationDateRangeKpiRequest** metode [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API. Tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("applicationId")
        .withKpiName("kpiName")
```

Di mana:
+ *applicationId*adalah pengenal unik untuk proyek tersebut.
+ *kpiName*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang menanyakan data untuk rentang tanggal tertentu, sertakan `endTime` parameter `startTime` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah pesan email transaksional yang dikirim untuk proyek dari 6 September 2019 hingga 13 September 2019:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("1234567890123456789012345example")
        .withKpiName("txn-emails-sent")
        .withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
        .withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-emails-sent`adalah `kpi-name` nilai untuk metrik aplikasi *pengiriman*, yang merupakan metrik yang melaporkan jumlah pesan email transaksional yang dikirim untuk suatu proyek.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-13T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------

Setelah mengirim kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Struktur hasil bervariasi tergantung pada metrik yang Anda kueri. Beberapa metrik hanya mengembalikan satu nilai. Misalnya, metrik aplikasi *send* (`txn-emails-sent`), yang digunakan dalam contoh sebelumnya, mengembalikan satu nilai—jumlah pesan email transaksional yang dikirim dari proyek. Dalam hal ini, respons JSON adalah sebagai berikut:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-09-13T23:59:59Z",
        "KpiName":"txn-emails-sent",
        "KpiResult":{
            "Rows":[
                {
                    "Values":[
                        {
                            "Key":"TxnEmailsSent",
                            "Type":"Double",
                            "Value":"62.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-09-06T00:00:00Z"
    }
}
```

Metrik lain mengembalikan beberapa nilai dan mengelompokkan nilai berdasarkan bidang yang relevan. Jika metrik mengembalikan beberapa nilai, respons JSON menyertakan bidang yang menunjukkan bidang mana yang digunakan untuk mengelompokkan data.

Untuk mempelajari lebih lanjut tentang struktur hasil kueri, lihat[Gunakan hasil kueri JSON](analytics-query-results.md).

# Kueri data Amazon Pinpoint untuk pesan SMS transaksional
<a name="analytics-query-txn-messaging-sms"></a>

Untuk menanyakan data pesan SMS transaksional yang dikirim untuk proyek, Anda menggunakan [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API dan menentukan nilai untuk parameter yang diperlukan berikut:
+ **application-id — ID** proyek, yang merupakan pengenal unik untuk proyek. Di Amazon Pinpoint, istilah *proyek* dan *aplikasi memiliki arti* yang sama.
+ **kpi-name — Nama** metrik untuk kueri. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Untuk daftar lengkap metrik yang didukung dan `kpi-name` nilai untuk masing-masing metrik, lihat[Metrik standar untuk proyek, kampanye, dan perjalanan](analytics-standard-metrics.md).

Anda juga dapat menerapkan filter yang menanyakan data untuk rentang tanggal tertentu. Jika Anda tidak menentukan rentang tanggal, Amazon Pinpoint mengembalikan data untuk 31 hari kalender sebelumnya. Untuk memfilter data berdasarkan tanggal yang berbeda, gunakan parameter rentang tanggal yang didukung untuk menentukan tanggal dan waktu pertama serta tanggal dan waktu terakhir dari rentang tanggal. Nilai harus dalam format ISO 8601 yang diperluas dan menggunakan Coordinated Universal Time (UTC) —misalnya, `2019-09-06T20:00:00Z` untuk 8:00 PM UTC 6 September 2019. Rentang tanggal bersifat inklusif dan harus dibatasi hingga 31 hari kalender atau lebih sedikit. Selain itu, tanggal dan waktu pertama harus kurang dari 90 hari dari hari ini.

Contoh berikut menunjukkan cara melakukan kueri data analitik untuk pesan SMS transaksional dengan menggunakan Amazon Pinpoint REST API, file, AWS CLI dan file. AWS SDK untuk Java Anda dapat menggunakan AWS SDK apa pun yang didukung untuk menanyakan data analitik untuk pesan transaksional. AWS CLI Contoh diformat untuk Microsoft Windows. Untuk Unix, Linux, dan macOS, ganti karakter line-continuation tanda sisipan (^) dengan garis miring terbalik (\$1).

------
#### [ REST API ]

[Untuk melakukan kueri data analitik untuk pesan SMS transaksional dengan menggunakan Amazon Pinpoint REST API, kirim permintaan HTTP (S) GET ke URI Metrik Aplikasi.](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) Di URI, tentukan nilai yang sesuai untuk parameter jalur yang diperlukan:

```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```

Di mana:
+ *endpoint*adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ *application-id*adalah pengenal unik untuk proyek tersebut.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Semua parameter harus dikodekan URL.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, tambahkan parameter `start-time` dan nilai `end-time` kueri dan ke URI. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Gunakan ampersand (&) untuk memisahkan parameter.

Misalnya, permintaan berikut mengambil jumlah pesan SMS transaksional yang dikirim setiap hari dari 6 September 2019 hingga 8 September 2019:

```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```

Di mana:
+ `pinpoint.us-east-1.amazonaws.com`adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-sms-sent-grouped-by-date`adalah `kpi-name` nilai untuk *pengiriman, dikelompokkan berdasarkan metrik aplikasi tanggal*, yang merupakan metrik yang mengembalikan jumlah pesan SMS transaksional yang dikirim selama setiap hari dari rentang tanggal.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-08T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ AWS CLI ]

Untuk kueri data analitik untuk pesan SMS transaksional dengan menggunakan AWS CLI, gunakan **get-application-date-range-kpi** perintah, dan tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id application-id ^
    --kpi-name kpi-name
```

Di mana:
+ *application-id*adalah pengenal unik untuk proyek tersebut.
+ *kpi-name*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, sertakan `end-time` parameter `start-time` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah pesan SMS transaksional yang dikirim setiap hari dari 6 September 2019 hingga 8 September 2019:

```
C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id 1234567890123456789012345example ^
    --kpi-name txn-sms-sent-grouped-by-date ^
    --start-time 2019-09-06T00:00:00Z ^
    --end-time 2019-09-08T23:59:59Z
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-sms-sent-grouped-by-date`adalah `kpi-name` nilai untuk *pengiriman, dikelompokkan berdasarkan metrik aplikasi tanggal*, yang merupakan metrik yang mengembalikan jumlah pesan SMS transaksional yang dikirim selama setiap hari dari rentang tanggal.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-08T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------
#### [ SDK for Java ]

Untuk melakukan kueri data analitik untuk pesan SMS transaksional dengan menggunakan AWS SDK untuk Java, gunakan **GetApplicationDateRangeKpiRequest** metode [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API, dan tentukan nilai yang sesuai untuk parameter yang diperlukan:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("applicationId")
        .withKpiName("kpiName")
```

Di mana:
+ *applicationId*adalah pengenal unik untuk proyek tersebut.
+ *kpiName*adalah `kpi-name` nilai untuk metrik untuk kueri.

Untuk menerapkan filter yang mengambil data untuk rentang tanggal tertentu, sertakan `endTime` parameter `startTime` dan nilai dalam kueri Anda. Dengan menggunakan parameter ini, Anda dapat menentukan tanggal dan waktu pertama dan terakhir, dalam format ISO 8601 yang diperpanjang, dari rentang tanggal inklusif untuk mengambil data. Misalnya, permintaan berikut mengambil jumlah pesan SMS transaksional yang dikirim setiap hari dari 6 September 2019 hingga 8 September 2019:

```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("1234567890123456789012345example")
        .withKpiName("txn-sms-sent-grouped-by-date")
        .withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
        .withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```

Di mana:
+ `1234567890123456789012345example`adalah pengenal unik untuk proyek tersebut.
+ `txn-sms-sent-grouped-by-date`adalah `kpi-name` nilai untuk *pengiriman, dikelompokkan berdasarkan metrik aplikasi tanggal*, yang merupakan metrik yang mengembalikan jumlah pesan SMS transaksional yang dikirim selama setiap hari dari rentang tanggal.
+ `2019-09-06T00:00:00Z`adalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
+ `2019-09-08T23:59:59Z`adalah tanggal dan waktu terakhir untuk mengambil data, sebagai bagian dari rentang tanggal inklusif.

------

Setelah mengirim kueri, Amazon Pinpoint mengembalikan hasil kueri dalam respons JSON. Struktur hasil bervariasi tergantung pada metrik yang Anda kueri. Beberapa metrik hanya mengembalikan satu nilai. Metrik lain mengembalikan beberapa nilai dan mengelompokkan nilai-nilai tersebut dengan bidang yang relevan. Jika metrik mengembalikan beberapa nilai, respons JSON menyertakan bidang yang menunjukkan bidang mana yang digunakan untuk mengelompokkan data.

Misalnya, *pengiriman, dikelompokkan berdasarkan metrik aplikasi tanggal* (`txn-sms-sent-grouped-by-date`), yang digunakan dalam contoh sebelumnya, mengembalikan beberapa nilai—jumlah pesan SMS transaksional yang dikirim selama setiap hari dari rentang tanggal yang ditentukan. Dalam hal ini, respons JSON adalah sebagai berikut:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-09-08T23:59:59Z",
        "KpiName":"txn-sms-sent-grouped-by-date",
        "KpiResult":{
            "Rows":[
                {
                    "GroupedBys":[
                        {
                            "Key":"Date",
                            "Type":"String",
                            "Value":"2019-09-06"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"TxnSmsSent",
                            "Type":"Double",
                            "Value":"29.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"Date",
                            "Type":"String",
                            "Value":"2019-09-07"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"TxnSmsSent",
                            "Type":"Double",
                            "Value":"35.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"Date",
                            "Type":"String",
                            "Value":"2019-09-08"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"TxnSmsSent",
                            "Type":"Double",
                            "Value":"10.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-09-06T00:00:00Z"
    }
}
```

Dalam hal ini, `GroupedBys` bidang menunjukkan bahwa nilai dikelompokkan berdasarkan hari kalender (`Date`). Ini artinya bahwa: 
+ 29 pesan dikirim pada 6 September 2019.
+ 35 pesan dikirim pada 7 September 2019.
+ 10 pesan dikirim pada 8 September 2019.

Untuk mempelajari lebih lanjut tentang struktur hasil kueri, lihat[Gunakan hasil kueri JSON](analytics-query-results.md).

# Gunakan hasil kueri Amazon Pinpoint analytics JSON
<a name="analytics-query-results"></a>

Saat Anda menggunakan Amazon Pinpoint Analytics APIs untuk menanyakan data analitik, Amazon Pinpoint menampilkan hasilnya dalam respons JSON. Untuk metrik aplikasi, metrik kampanye, dan metrik keterlibatan perjalanan, data dalam respons mematuhi skema JSON standar untuk melaporkan data analitik Amazon Pinpoint. 

Ini berarti Anda dapat menggunakan bahasa pemrograman atau alat pilihan Anda untuk menerapkan solusi khusus yang menanyakan data untuk satu atau lebih metrik ini, menangkap hasil setiap kueri, dan kemudian menulis hasilnya ke tabel, objek, atau lokasi lain. Anda kemudian dapat bekerja dengan hasil kueri di lokasi tersebut dengan menggunakan layanan atau aplikasi lain.

Sebagai contoh, Anda dapat:
+ Buat dasbor khusus yang menanyakan serangkaian metrik secara teratur dan menampilkan hasilnya dengan menggunakan kerangka visualisasi data pilihan Anda.
+ Buat laporan yang melacak tingkat keterlibatan dengan menanyakan metrik yang sesuai dan menampilkan hasilnya dalam bagan atau jenis laporan lain yang Anda desain.
+ Parse dan tulis data analitik ke format penyimpanan tertentu, lalu port hasilnya ke solusi penyimpanan jangka panjang.

Perhatikan bahwa Amazon Pinpoint Analytics APIs tidak dirancang untuk membuat atau menyimpan objek persisten apa pun yang selanjutnya dapat Anda baca atau gunakan dalam proyek Amazon Pinpoint atau akun Amazon Pinpoint Anda. Sebaliknya, ini APIs dirancang untuk membantu Anda mengambil data analitik dan mentransfer data tersebut ke layanan dan aplikasi lain untuk analisis, penyimpanan, atau pelaporan lebih lanjut. Mereka melakukan ini sebagian dengan menggunakan struktur dan skema respons JSON yang sama untuk semua data analitik yang dapat Anda kueri secara terprogram untuk metrik aplikasi, metrik kampanye, dan metrik keterlibatan perjalanan.

Topik ini menjelaskan struktur, objek, dan bidang dalam respons JSON terhadap kueri untuk metrik aplikasi, metrik kampanye, atau metrik keterlibatan perjalanan. Untuk informasi tentang bidang dalam respons JSON terhadap kueri untuk metrik eksekusi perjalanan atau metrik eksekusi aktivitas perjalanan, lihat[Metrik standar yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint](analytics-standard-metrics.md). 

## Struktur JSON
<a name="analytics-query-results-structure"></a>

Untuk membantu Anda mengurai dan menggunakan hasil kueri, Amazon Pinpoint APIs Analytics menggunakan struktur respons JSON yang sama untuk semua data analitik Amazon Pinpoint yang dapat Anda kueri secara terprogram untuk metrik aplikasi, metrik kampanye, dan metrik keterlibatan perjalanan. Setiap respons JSON menentukan nilai yang mendefinisikan kueri, seperti ID proyek ()`ApplicationId`. Respons juga mencakup satu (dan hanya satu) `KpiResult` objek. `KpiResult`Objek berisi hasil keseluruhan yang ditetapkan untuk kueri.

Setiap `KpiResult` objek berisi `Rows` objek. Ini adalah array objek yang berisi hasil query dan metadata yang relevan tentang nilai-nilai dalam hasil tersebut. Struktur dan isi suatu `Rows` objek memiliki karakteristik umum sebagai berikut:
+ Setiap baris hasil query adalah objek JSON terpisah, bernama`Values`, dalam `Rows` objek. Misalnya, jika query mengembalikan tiga nilai, `Rows` objek berisi tiga `Values` objek. Setiap `Values` objek berisi hasil individual untuk kueri.
+ Setiap kolom hasil kueri adalah properti dari `Values` objek yang diterapkan. Nama kolom disimpan di `Key` bidang `Values` objek.
+ Untuk hasil kueri yang dikelompokkan, setiap `Values` objek memiliki `GroupedBys` objek terkait. `GroupedBys`Objek menunjukkan bidang mana yang digunakan untuk mengelompokkan hasil. Ini juga memberikan nilai pengelompokan untuk `Values` objek terkait.
+ Jika hasil kueri untuk metrik adalah nol, `Rows` objek kosong.

Di luar karakteristik umum ini, struktur dan isi `Rows` objek bervariasi tergantung pada metrik. *Ini karena Amazon Pinpoint mendukung dua jenis metrik, metrik *nilai tunggal dan metrik multi-nilai*.* 

*Metrik nilai tunggal* hanya menyediakan satu nilai kumulatif. Contohnya adalah persentase pesan yang dikirimkan ke penerima oleh semua proses kampanye. *Metrik multi-nilai* menyediakan lebih dari satu nilai dan mengelompokkan nilai-nilai tersebut dengan bidang yang relevan. Contohnya adalah persentase pesan yang dikirimkan ke penerima untuk setiap proses kampanye, dikelompokkan berdasarkan kampanye yang dijalankan. 

Anda dapat dengan cepat menentukan apakah metrik adalah metrik nilai tunggal atau metrik multi-nilai dengan mengacu pada nama metrik. Jika nama tidak mengandung`grouped-by`, itu adalah metrik nilai tunggal. Jika ya, itu adalah metrik multi-nilai. Untuk daftar lengkap metrik yang dapat Anda kueri secara terprogram, lihat. [Metrik standar yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint](analytics-standard-metrics.md) 

### Metrik nilai tunggal
<a name="analytics-query-results-structure-single"></a>

Untuk metrik nilai tunggal, `Rows` objek berisi `Values` objek yang:
+ Menentukan nama ramah metrik yang ditanyakan.
+ Memberikan nilai untuk metrik yang ditanyakan.
+ Mengidentifikasi tipe data dari nilai yang dikembalikan.

Misalnya, respons JSON berikut berisi hasil kueri untuk metrik nilai tunggal. Metrik ini melaporkan jumlah titik akhir unik yang dikirimkan pesan oleh semua kampanye yang terkait dengan proyek, mulai 1 Agustus 2019 hingga 31 Agustus 2019:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-08-31T23:59:59Z",
        "KpiName":"unique-deliveries",
        "KpiResult":{
            "Rows":[
                {
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"1368.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-08-01T00:00:00Z"
    }
}
```

Dalam contoh ini, tanggapan menunjukkan bahwa semua kampanye proyek mengirimkan pesan ke 1.368 titik akhir unik dari 1 Agustus 2019 hingga 31 Agustus 2019, di mana:
+ `Key`adalah nama ramah metrik yang nilainya ditentukan di `Value` bidang (`UniqueDeliveries`).
+ `Type`adalah tipe data dari nilai yang ditentukan dalam `Value` bidang (`Double`).
+ `Value`adalah nilai aktual untuk metrik yang ditanyakan, termasuk filter apa pun yang diterapkan (`1368.0`).

Jika hasil kueri untuk metrik nilai tunggal adalah nol (tidak lebih besar dari atau sama dengan nol), `Rows` objek kosong. Amazon Pinpoint mengembalikan nilai null untuk metrik jika tidak ada data yang dikembalikan untuk metrik tersebut. Contoh:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"2345678901234567890123456example",
        "EndTime":"2019-08-31T23:59:59Z",
        "KpiName":"unique-deliveries",
        "KpiResult":{
            "Rows":[

            ]
        },
        "StartTime":"2019-08-01T00:00:00Z"
    }
}
```

### Metrik nilai ganda
<a name="analytics-query-results-structure-multiple"></a>

Struktur dan isi `Rows` objek untuk metrik multi-nilai sebagian besar sama dengan metrik nilai tunggal. `Rows`Objek untuk metrik multi-nilai juga berisi objek. `Values` `Values`Objek menentukan nama ramah metrik yang ditanyakan, memberikan nilai untuk metrik itu, dan mengidentifikasi tipe data dari nilai tersebut.

Namun, `Rows` objek untuk metrik multi-nilai juga berisi satu atau lebih objek. `GroupedBy` Ada satu `GroupedBy` objek untuk setiap `Values` objek dalam hasil query. `GroupedBy`Objek menunjukkan bidang mana yang digunakan untuk mengelompokkan data dalam hasil dan tipe data bidang itu. Ini juga menunjukkan nilai pengelompokan untuk bidang itu (untuk `Values` objek terkait). 

Misalnya, respons JSON berikut berisi hasil kueri untuk metrik multi-nilai yang melaporkan jumlah titik akhir unik yang dikirimkan pesan, untuk setiap kampanye yang terkait dengan proyek, mulai 1 Agustus 2019 hingga 31 Agustus 2019:

```
{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-08-31T23:59:59Z",
        "KpiName":"unique-deliveries-grouped-by-campaign",
        "KpiResult":{
            "Rows":[
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"80b8efd84042ff8d9c96ce2f8example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"123.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"810c7aab86d42fb2b56c8c966example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"456.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"42d8c7eb0990a57ba1d5476a3example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"789.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-08-01T00:00:00Z"
    }
}
```

Dalam contoh ini, tanggapan menunjukkan bahwa tiga kampanye proyek mengirimkan pesan ke titik akhir unik dari 1 Agustus 2019 hingga 31 Agustus 2019. Untuk masing-masing kampanye tersebut, rincian jumlah pengiriman adalah:
+ Kampanye `80b8efd84042ff8d9c96ce2f8example` mengirimkan pesan ke 123 titik akhir unik.
+ Kampanye `810c7aab86d42fb2b56c8c966example` mengirimkan pesan ke 456 titik akhir unik.
+ Kampanye `42d8c7eb0990a57ba1d5476a3example` mengirimkan pesan ke 789 titik akhir unik.

Dimana struktur umum objek dan bidang adalah:
+ `GroupedBys.Key`— Nama properti atau bidang yang menyimpan nilai pengelompokan yang ditentukan dalam `GroupedBys.Value` bidang (`CampaignId`).
+ `GroupedBys.Type`— Tipe data dari nilai yang ditentukan dalam `GroupedBys.Value` bidang (`String`).
+ `GroupedBys.Value`— Nilai aktual untuk bidang yang digunakan untuk mengelompokkan data, seperti yang ditentukan dalam `GroupedBys.Key` bidang (ID kampanye).
+ `Values.Key`— Nama ramah metrik yang nilainya ditentukan di `Values.Value` bidang (`UniqueDeliveries`).
+ `Values.Type`— Tipe data dari nilai yang ditentukan dalam `Values.Value` bidang (`Double`).
+ `Values.Value`— Nilai aktual untuk metrik yang ditanyakan, termasuk filter apa pun yang diterapkan.

Jika hasil kueri untuk metrik multi-nilai adalah nol (tidak lebih besar dari atau sama dengan nol) untuk proyek, kampanye, atau sumber daya tertentu lainnya, Amazon Pinpoint tidak menampilkan objek atau bidang apa pun untuk sumber daya. Jika hasil kueri untuk metrik multi-nilai adalah nol untuk semua sumber daya, Amazon Pinpoint mengembalikan objek kosong. `Rows`

## Objek dan bidang JSON
<a name="analytics-query-results-schema"></a>

Selain menentukan nilai yang mendefinisikan kueri, seperti ID proyek (`ApplicationId`), setiap respons JSON terhadap kueri untuk metrik aplikasi, metrik kampanye, atau metrik keterlibatan perjalanan menyertakan `KpiResult` objek. Objek ini berisi kumpulan hasil keseluruhan untuk kueri, yang dapat Anda uraikan untuk mengirim data analitik ke layanan atau aplikasi lain. Setiap `KpiResult` objek berisi beberapa atau semua objek dan bidang standar berikut, tergantung pada metrik.


| Objek atau bidang | Deskripsi | 
| --- | --- | 
| Rows | Sebuah array objek yang berisi hasil set untuk query. | 
| Rows.GroupedBys | Untuk metrik multi-nilai, larik bidang yang mendefinisikan bidang dan nilai yang digunakan untuk mengelompokkan data dalam hasil kueri.  | 
| Rows.GroupedBys.Key | Untuk metrik multi-nilai, nama properti atau bidang yang menyimpan nilai yang ditentukan dalam bidang. GroupedBys.Value | 
| Rows.GroupedBys.Type | Untuk metrik multi-nilai, tipe data dari nilai yang ditentukan di bidang. GroupedBys.Value | 
| Rows.GroupedBys.Value | Untuk metrik multi-nilai, nilai aktual untuk bidang yang digunakan untuk mengelompokkan data dalam hasil kueri. Nilai ini berkorelasi dengan objek terkaitValues. | 
| Rows.Values | Sebuah array bidang yang berisi hasil query. | 
| Rows.Values.Key | Nama ramah dari metrik yang ditanyakan. Nilai metrik ditentukan di Values.Value bidang. | 
| Rows.Values.Type | Tipe data dari nilai yang ditentukan di Values.Value bidang. | 
| Rows.Values.Value | Nilai aktual untuk metrik yang ditanyakan, termasuk filter apa pun yang diterapkan. | 

 Untuk informasi tentang bidang dalam respons JSON terhadap kueri untuk metrik eksekusi perjalanan atau metrik eksekusi aktivitas perjalanan, lihat[Metrik standar yang berlaku untuk proyek, kampanye, dan perjalanan Amazon Pinpoint](analytics-standard-metrics.md).