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. 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 Amazon Pinpoint untuk pesan SMS transaksional
Untuk menanyakan data pesan SMS transaksional yang dikirim untuk proyek, Anda menggunakan Application Metrics 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, lihatMetrik standar untuk proyek, kampanye, dan perjalanan.
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 for 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 (\).
- 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. Di URI, tentukan nilai yang sesuai untuk parameter jalur yang diperlukan:
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
Di mana:
-
endpointadalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
-
application-idadalah pengenal unik untuk proyek tersebut.
-
kpi-nameadalah 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.rproxy.govskope.caadalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
-
1234567890123456789012345exampleadalah pengenal unik untuk proyek tersebut.
-
txn-sms-sent-grouped-by-dateadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
-
2019-09-08T23:59:59Zadalah 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:
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:
-
1234567890123456789012345exampleadalah pengenal unik untuk proyek tersebut.
-
txn-sms-sent-grouped-by-dateadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
-
2019-09-08T23:59:59Zadalah 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 for Java, gunakan GetApplicationDateRangeKpiRequest metode Application Metrics API, dan tentukan nilai yang sesuai untuk parameter yang diperlukan:
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
Di mana:
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:
-
1234567890123456789012345exampleadalah pengenal unik untuk proyek tersebut.
-
txn-sms-sent-grouped-by-dateadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
-
2019-09-08T23:59:59Zadalah 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, lihatGunakan hasil kueri JSON.
