Bagaimana cara meminta Admin Analytics (Beta) dari Padlet MCP?

Foto profil Carla SeseDiperbarui 16 jam yang lalu oleh Carla Sese

Perlu angka yang tidak ditampilkan dengan cara yang Anda inginkan di Dasbor Admin sekolah atau Tim? Hubungkan Padlet MCP ke asisten AI dan minta analitik sekolah, ruang kelas, atau Tim dengan bahasa sehari-hari—atau panggil sendiri API analitik organisasi.

Untuk referensi REST lengkap (katalog metrik, format permintaan, dan kode error), lihat Membaca analitik organisasi di docs.padlet.dev.

Untuk siapa artikel ini

Artikel ini ditujukan untuk:

  • Pemilik dan admin akun Padlet for Schools atau Tim
  • Pemilik dan guru akun Classroom

Anda tidak perlu menulis kode untuk menggunakan jalur MCP. Jalur API bersifat opsional bagi pengguna mahir yang sudah menggunakan Public API.

Yang sudah tersedia

Halaman Analitik organisasi Anda di Pengaturan sudah menampilkan tab pilihan untuk periode penagihan saat ini. Sekolah dan ruang kelas memiliki tab Ringkasan, Penggunaan, Dampak, Keamanan, Pengguna teratas, dan Semua pengguna. Tim memiliki tab Umum, Padlet, dan Pengguna, atau Ringkasan, Penggunaan, Dampak, Pengguna teratas, dan Semua pengguna jika Tim Anda memiliki halaman Analitik baru (beta).

Gunakan dasbor saat Anda menginginkan gambaran visual singkat. Gunakan MCP atau API saat Anda memerlukan tampilan khusus yang tidak terjawab dengan baik oleh tab-tab tersebut.

Fitur tambahan MCP / API

Dasbor berisi tab-tab pilihan. MCP dan API memungkinkan Anda meminta tampilan yang benar-benar dibutuhkan:

  • Pertanyaan dengan bahasa sehari-hari di klien AI Anda ("guru mana yang tidak aktif pada periode penagihan sebelumnya?")
  • Kombinasi khusus metrik keterlibatan, keanggotaan, dan keamanan konten
  • Rangkaian data bulanan untuk rentang tanggal tertentu
  • Tampilan berdasarkan peran (guru dibandingkan siswa, pembuat dibandingkan kontributor)
  • Padlet, pengguna, dan media teratas yang diurutkan sesuai permintaan Anda
  • Jawaban yang bisa ditempel ke presentasi QBR atau perpanjangan
Metrik keamanan konten (item yang dipindai, item yang ditandai, tingkat deteksi) hanya tersedia untuk sekolah dan ruang kelas. Jika diminta untuk organisasi Tim, hasilnya adalah error, bukan nol.

Mulai cepat dengan Padlet MCP

  1. Hubungkan Padlet MCP di klien AI Anda. Gunakan URL server https://mcp.padlet.com. Langkah penyiapan lengkap tersedia di Server Padlet MCP.
  2. Masuk dan berikan otorisasi sebagai admin organisasi yang ingin Anda kueri. Di Classroom, guru juga dapat mengambil analitik.
  3. Tanyakan dengan bahasa sehari-hari. Anda tidak perlu menyebutkan nama alat internal. Beri tahu asisten AI informasi yang ingin Anda ketahui tentang sekolah, ruang kelas, atau Tim Anda, dan asisten akan menggunakan Padlet MCP atas nama Anda.

Berikut contohnya:

Jika klien MCP tertentu belum menampilkan jawaban analitik, coba klien lain yang kompatibel dengan MCP, atau gunakan API analitik organisasi. Dukungan klien mungkin tertinggal dari server.
Asisten bertindak sebagai Anda. Asisten hanya dapat mengambil analitik yang diizinkan untuk dilihat oleh akun Anda yang sedang masuk.

Opsional: API analitik organisasi

Lebih suka membuat skrip sendiri? Gunakan Public API dengan kunci API admin (atau kunci guru di Classroom).

  1. Buat atau salin kunci API dari halaman Developer di Pengaturan. Detailnya tersedia di artikel Public API.
  2. Temukan ID organisasi Anda dengan GET /me?include=organizations. Gunakan ID wksp_ — organisasi org_ di padlet.org belum didukung untuk endpoint ini.
  3. Kirim POST ke /organizations/{org_id}/analytics dengan metrik yang Anda inginkan.
  4. Jika responsnya 202 atau meta.pending tidak kosong, tunggu selama Retry-After lalu kirim ulang permintaan yang identik. Analitik dihitung secara asinkron—metrik yang masih diproses tidak disertakan, bukan bernilai nol. Jangan pernah menganggap metrik yang masih diproses bernilai nol.
Format permintaan lengkap, katalog metrik, dan contoh pengerjaan tersedia di Membaca analitik organisasi.

Akses pilot

Analitik organisasi melalui MCP dan API bersifat opsional selama masa pilot. Padlet mendaftarkan pemilik organisasi—menjadi admin saja tidak cukup. Sampai organisasi Anda terdaftar, setiap panggilan akan menghasilkan 404 (respons yang sama seperti untuk organisasi yang tidak dikenal).

Saat ini hanya organisasi wksp_ yang didukung.

Hubungi dukungan dan minta mereka mendaftarkan pemilik organisasi Anda untuk analitik admin.

Contoh prompt

Berikut beberapa prompt awal yang bisa Anda tempel ke klien MCP. Sesuaikan kata-katanya dengan sekolah, ruang kelas, atau Tim Anda—dan verifikasi angkanya di halaman Analitik saat menyiapkan presentasi untuk pelanggan.

  • "Untuk sekolah kami pada periode penagihan ini, berapa jumlah guru aktif dibandingkan jumlah lisensi, dan pada bulan apa jumlahnya menurun?"
  • "Padlet organisasi mana yang memiliki tayangan terbanyak? Berikan 3 papan/sandbox teratas."
  • "Anggota mana yang memiliki peran guru tetapi tidak menggunakan Padlet dalam 12 bulan terakhir?"
  • "Berapa anggota yang tidak memiliki domain email <ouremaildomain.edu>?"
Minta tampilan yang Anda perlukan: rangkaian data bulanan, filter peran, Padlet teratas berdasarkan jumlah postingan atau pengunjung, atau total keamanan konten untuk sekolah atau ruang kelas. Asisten akan mencocokkan pertanyaan Anda dengan metrik yang tersedia.

Keunggulan dasbor

Tetap gunakan halaman Analitik di Pengaturan jika Anda menginginkan:

  • Banner Ringkasan visual, sorotan Peluang utama, dan permintaan PD sekali klik
  • Tabel Semua pengguna / Pengguna dengan fitur pencarian, filter peran, dan unduhan CSV sekali klik
  • Daftar guru aktif dan tidak aktif yang dapat diunduh untuk periode yang dipilih, dari tab Ringkasan (sekolah dan ruang kelas)
  • Tampilan yang tidak memerlukan pendaftaran pilot—halaman Pengaturan tersedia bagi peran yang memenuhi syarat tanpa perlu ikut serta dalam API

MCP dan API sangat berguna saat tab pilihan tidak menjawab pertanyaan spesifik yang Anda perlukan untuk demo atau pembicaraan perpanjangan.

Batasan:

  • Batas laju: 60 permintaan per jam per kunci API dan organisasi, termasuk polling setelah 202
  • Rentang tanggal: maksimal 24 bulan dalam satu permintaan
  • Keamanan konten: hanya untuk sekolah dan ruang kelas—Tim akan menerima 400 untuk metrik tersebut
  • Jumlah keanggotaan: mencerminkan daftar anggota saat ini, bukan gambaran historis tentang siapa yang menjadi anggota pada waktu tertentu
  • Masih diproses ≠ nol: metrik yang masih dihitung tidak disertakan dalam respons; jangan menganggapnya bernilai nol
  • Jenis organisasi: saat ini hanya wksp_

Tanya Jawab

Mengapa saya mendapat 404 saat meminta analitik?

Selama endpoint masih dalam masa pilot, semua penolakan tampak sama: belum terdaftar, organisasi tidak dikenal, atau tidak memiliki akses—semuanya menghasilkan 404. Pastikan Anda masuk sebagai admin (atau guru di Classroom), organisasi Anda adalah organisasi wksp_, dan Padlet telah mendaftarkan pemilik organisasi. Hubungi dukungan untuk meminta pendaftaran.

Apakah saya perlu menulis kode?

Tidak. Hubungkan Padlet MCP, masuk sebagai admin, lalu ajukan pertanyaan dengan bahasa sehari-hari. Jalur API bersifat opsional bagi developer dan pengguna mahir yang sudah menggunakan Public API.

Apakah ini sama dengan Public API?

Terkait, tetapi bukan produk yang sama. Public API ditujukan bagi developer yang menggunakan kunci API. Padlet MCP ditujukan bagi asisten AI yang Anda beri otorisasi dengan masuk. Keduanya dapat mengakses analitik organisasi setelah organisasi Anda terdaftar; Anda dapat menggunakan salah satunya atau keduanya.

Bisakah siswa atau non-admin melihat analitik organisasi dengan cara ini?

Tidak. Analitik hanya dapat diakses oleh admin organisasi atau guru di Classroom. Asisten memiliki akses yang sama persis dengan akun yang Anda gunakan untuk masuk—tidak lebih.

Klien MCP saya sepertinya tidak mengenali analitik. Apa yang harus saya coba?

Beberapa klien memperbarui daftar alatnya dengan jeda. Coba hubungkan kembali Padlet MCP, beralih ke klien lain yang kompatibel dengan MCP, atau gunakan API analitik organisasi secara langsung. Jika Anda masih tidak dapat mengaksesnya setelah pendaftaran, hubungi kami.

Terkait

Apakah artikel ini bermanfaat?

Artikel terkait

Akses halaman diagnostik

Perbaiki masalah Padlet menggunakan alat diagnostik di web atau perangkat seluler, lalu hubungi dukungan jika diperlukan dengan hasilnya.

Bagaimana cara mereset Apple ID saya?

Reset Apple ID Anda untuk Padlet dengan menghapusnya dari pengaturan Apple ID Anda dan masuk kembali.

Saya ingin bekerja di Padlet. Di mana saya harus melamar?

Jelajahi peluang karir di Padlet dan ajukan lamaran untuk posisi yang tersedia di padlet.jobs.

Apa yang terjadi pada data Anda ketika akun dihapus?

Pahami apa yang terjadi saat Anda menghapus akun Padlet Anda dan cara memulihkannya dalam waktu 14 hari.