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 beberapa kampanye

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 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, lihatMetrik standar untuk proyek, kampanye, dan perjalanan.

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 (\).

REST API

Untuk melakukan kueri data analitik untuk beberapa kampanye 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 yang terkait dengan kampanye.
application-idadalah pengenal unik untuk proyek yang terkait dengan kampanye.
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 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.comadalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menjadi tuan rumah proyek.
1234567890123456789012345exampleadalah pengenal unik untuk proyek yang terkait dengan kampanye.
unique-deliveries-grouped-by-campaignadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
2019-07-26T23:59:59Zadalah 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-idadalah pengenal unik untuk proyek yang terkait dengan kampanye.
kpi-nameadalah 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:

1234567890123456789012345exampleadalah pengenal unik untuk proyek yang terkait dengan kampanye.
unique-deliveries-grouped-by-campaignadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
2019-07-26T23:59:59Zadalah 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 API. Tentukan nilai yang sesuai untuk parameter yang diperlukan:


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

Di mana:

applicationIdadalah pengenal unik untuk proyek yang terkait dengan kampanye.
kpiNameadalah 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:

1234567890123456789012345exampleadalah pengenal unik untuk proyek yang terkait dengan kampanye.
unique-deliveries-grouped-by-campaignadalah 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:00Zadalah tanggal dan waktu pertama untuk mengambil data untuk, sebagai bagian dari rentang tanggal inklusif.
2019-07-26T23: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 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, lihatGunakan hasil kueri JSON.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Data kueri untuk satu kampanye

Kueri data pesan transaksional