Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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
Komponen kueri dan parameter untuk metrik di Amazon Pinpoint
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-idparameter. Parameter ini diperlukan untuk semua metrik. -
Kampanye — Tentukan kampanye dengan memberikan ID kampanye sebagai nilai untuk
campaign-idparameter. Parameter ini hanya diperlukan untuk metrik kampanye. -
Perjalanan — Tentukan perjalanan dengan memberikan ID perjalanan sebagai nilai untuk
journey-idparameter. 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-idparameter. 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:00Zuntuk 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-nameparameter. Nilai ini menggambarkan metrik terkait dan terdiri dari dua atau lebih istilah, yang terdiri dari karakter alfanumerik huruf kecil, dipisahkan oleh tanda hubung. Contohnya adalahemail-open-ratedansuccessful-delivery-rate. Parameter ini diperlukan untuk semua metrik kecuali metrik eksekusi perjalanan dan metrik eksekusi aktivitas perjalanan. Untuk daftar lengkap metrik yang didukung dankpi-namenilai yang akan digunakan untuk masing-masing metrik, lihatMetrik standar untuk proyek, kampanye, dan perjalanan.
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, lihatGunakan hasil kueri JSON.
