Kueri data analitik Amazon Pinpoint untuk pesan transaksional

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

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

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.