Miten pyydän Padlet MCP:ltä ylläpitäjän analytiikkaa (beta)?

Carla Sesen profiilikuvaPäivitetty 16 tuntia sitten käyttäjän Carla Sese toimesta

Eivätkö koulun tai Tiimin ylläpitäjän ohjauspaneelin numerot ole haluamallasi tavalla eriteltävissä? Yhdistä Padlet MCP tekoälyavustajaan ja pyydä koulun, luokkahuoneen tai Tiimin analytiikkaa arkikielellä – tai kutsu organisaation analytiikka-API:a itse.

Täydellinen REST-viite (mittariluettelo, pyyntömuodot ja virhekoodit) löytyy docs.padlet.dev-sivuston artikkelista Organisaation analytiikan lukeminen.

Kenelle tämä on tarkoitettu

Tämä artikkeli on tarkoitettu seuraaville:

  • Omistajat ja ylläpitäjät Padlet for Schools- tai Tiimi-tileillä
  • Omistajat ja opettajat Classroom-tileillä

MCP:n käyttö ei edellytä koodaamista. API-vaihtoehto on tarkoitettu kokeneille käyttäjille, jotka käyttävät jo julkista API:a.

Mitä sinulla on jo käytössä

Organisaatiosi Asetusten Analytiikka-sivulla on jo valmiita välilehtiä, joissa näkyy nykyisen laskutuskauden tietoja. Kouluissa ja luokkahuoneissa käytössä ovat Yleiskatsaus, Käyttö, Vaikutus, Turvallisuus, Suosituimmat käyttäjät ja Kaikki käyttäjät. Tiimeissä käytössä ovat Yleiset, Padletit ja Käyttäjät tai Tiimisi saadessa uuden analytiikkasivun (beeta) Yleiskatsaus, Käyttö, Vaikutus, Suosituimmat käyttäjät ja Kaikki käyttäjät.

Käytä ohjauspaneelia, kun haluat nopean visuaalisen tilannekuvan. Käytä MCP:tä tai API:a, kun tarvitset mukautetun erittelyn, johon välilehtien tiedot eivät suoraan vastaa.

Mitä MCP / API tarjoaa lisää

Ohjauspaneelissa on valmiit välilehdet. MCP:n ja API:n avulla voit pyytää juuri tarvitsemasi erittelyn:

  • Esitä tekoälyasiakkaallesi kysymyksiä arkikielellä (”ketkä opettajista eivät olleet aktiivisia viime laskutuskaudella?”)
  • Yhdistä vapaasti käyttöä, jäsenyyttä ja sisällön turvallisuutta koskevia mittareita
  • Kuukausittaiset aikasarjat valitulta ajanjaksolta
  • Roolikohtaiset erittelyt (opettajat vs. oppilaat, julkaisijat vs. osallistujat)
  • Suosituimmat padletit, käyttäjät ja mediat pyytämälläsi järjestyksellä
  • Vastaukset, jotka voit liittää neljännesvuosittaiseen liiketoimintakatsaukseen tai uusimisesitykseen
Sisällön turvallisuutta koskevat mittarit (tarkistetut kohteet, merkityt kohteet, tunnistusprosentti) ovat käytettävissä vain kouluissa ja luokkahuoneissa. Niiden pyytäminen Tiimi-organisaatiolta palauttaa virheen, ei nollaa.

Aloita nopeasti Padlet MCP:n käytöllä

  1. Yhdistä Padlet MCP tekoälyasiakkaassasi. Käytä palvelimen URL-osoitetta https://mcp.padlet.com. Täydelliset käyttöönotto-ohjeet ovat artikkelissa Padlet MCP Server.
  2. Kirjaudu sisään ja anna valtuutus sen organisaation ylläpitäjänä, jota haluat tarkastella. Classroomissa myös opettaja voi hakea analytiikkaa.
  3. Esitä kysymyksesi arkikielellä. Sisäisiä työkaluja ei tarvitse nimetä. Kerro tekoälyavustajalle, mitä haluat tietää koulustasi, luokkahuoneestasi tai Tiimistäsi, niin se käyttää Padlet MCP:tä puolestasi.

Tässä on esimerkki:

Jos jokin MCP-asiakas ei vielä näytä analytiikkavastauksia, kokeile toista MCP-yhteensopivaa asiakasta tai käytä sen sijaan organisaation analytiikka-API:a. Asiakassovellusten tuki saattaa päivittyä palvelinta hitaammin.
Avustaja toimii sinun puolestasi. Se voi hakea vain sellaisia analytiikkatietoja, joita sisäänkirjautuneella tililläsi on oikeus nähdä.

Valinnainen: organisaation analytiikka-API

Haluatko mieluummin tehdä komentosarjan itse? Käytä julkista API:a ylläpitäjän API-avaimella (tai Classroomin opettaja-avaimella).

  1. Luo tai kopioi API-avain Asetusten Developer-sivulta. Lisätietoja on Julkinen API -artikkelissa.
  2. Etsi organisaatiosi tunnus komennolla GET /me?include=organizations. Etsi wksp_-tunnusta — padlet.org-palvelun org_-organisaatioita ei vielä tueta tässä päätepisteessä.
  3. Lähetä POST-pyyntö osoitteeseen /organizations/{org_id}/analytics ja sisällytä siihen haluamasi mittarit.
  4. Jos vastaus on 202 tai meta.pending ei ole tyhjä, odota Retry-After-aika ja lähetä täsmälleen sama pyyntö uudelleen. Analytiikka lasketaan asynkronisesti – keskeneräinen mittari puuttuu vastauksesta, eikä sen arvo ole nolla. Älä koskaan tulkitse keskeneräistä arvoa nollaksi.
Täydelliset pyyntömuodot, mittariluettelo ja esimerkit löytyvät artikkelista Organisaation analytiikan lukeminen.

Pilottiohjelmaan liittyminen

Organisaation analytiikan käyttö MCP:n ja API:n kautta on pilottivaiheessa valinnaista. Padlet ottaa ohjelmaan mukaan organisaation omistajan – pelkkä ylläpitäjän rooli ei riitä. Ennen kuin organisaatiosi on otettu mukaan, jokainen kutsu palauttaa virheen 404 (saman vastauksen kuin tuntemattomasta organisaatiosta).

Tällä hetkellä tuetaan vain wksp_-organisaatioita.

Ota yhteyttä tukeen ja pyydä heitä ottamaan organisaation omistaja mukaan ylläpitäjän analytiikkaohjelmaan.

Esimerkkikehotteita

Näitä aloituskehotteita voit liittää MCP-asiakkaaseesi. Muokkaa sanamuotoa koulusi, luokkahuoneesi tai Tiimisi mukaan – ja tarkista luvut Analytiikka-sivulta, kun valmistelet asiakkaille suunnattua esitystä.

  • ”Kuinka monta aktiivista opettajaa meillä oli koulussamme tällä laskutuskaudella lisenssien määrään verrattuna, ja mitkä kuukaudet jäivät vähäisiksi?”
  • ”Millä organisaatiomme padleteilla on eniten katselukertoja? Näytä kolme suosituinta lautaa/sandboxia.”
  • ”Ketkä opettajarooleissa olevista jäsenistä eivät ole käyttäneet Padletia viimeisten 12 kuukauden aikana?”
  • ”Kuinka monen jäsenen sähköpostiosoite ei pääty verkkotunnukseen <ouremaildomain.edu>?”
Pyydä tarvitsemaasi erittelyä: kuukausittaista aikasarjaa, roolisuodatusta, julkaisu- tai kävijämäärien mukaan järjestettyjä suosituimpia padleteja tai koulun tai luokkahuoneen sisällön turvallisuutta koskevia kokonaistietoja. Avustaja yhdistää kysymyksesi käytettävissä oleviin mittareihin.

Missä ohjauspaneeli toimii edelleen paremmin

Käytä Asetusten Analytiikka-sivua, kun haluat:

  • Visuaalisen Yleiskatsaus-bannerin, suosituimmat kehityskohteet -nostot ja yhden napsautuksen täydennyskoulutuspyynnön
  • Kaikki käyttäjät / Käyttäjät -taulukon, jossa on haku, roolisuodattimet ja CSV-tiedoston lataus yhdellä napsautuksella
  • Valitun kauden aktiivisten ja passiivisten opettajien ladattavat luettelot Yleiskatsaus-välilehdeltä (koulut ja luokkahuoneet)
  • Näkymän, joka ei edellytä pääsyä pilottiohjelmaan – Asetukset-sivu on sellaisenaan käytettävissä kelpoisuusvaatimukset täyttäville rooleille ilman API:n käyttöönottoa

MCP ja API ovat parhaimmillaan silloin, kun valmiit välilehdet eivät vastaa täsmälliseen kysymykseen, joka sinulla on esittelyä tai uusimiskeskustelua varten.

Rajoitukset:

  • Käyttörajoitus: 60 pyyntöä tunnissa API-avainta ja organisaatiota kohden, mukaan lukien kyselyt 202-vastauksen jälkeen
  • Päivämääräväli: enintään 24 kuukautta yhdessä pyynnössä
  • Sisällön turvallisuus: vain kouluille ja luokkahuoneille – Tiimit saavat kyseisistä mittareista vastauksen 400
  • Jäsenmäärät: kuvaavat nykyistä jäsenistöä, eivät historiallista tilannetta siitä, ketkä kuuluivat jäsenistöön kyseisenä ajankohtana
  • Keskeneräinen ≠ nolla: laskettavana oleva mittari puuttuu vastauksesta; älä tulkitse sitä nollaksi
  • Organisaatiotyyppi: tällä hetkellä vain wksp_

Usein kysytyt kysymykset

Miksi saan 404-virheen, kun pyydän analytiikkaa?

Päätepisteen pilottivaiheen aikana kaikki estot näyttävät samalta: organisaatiota ei ole otettu mukaan, sitä ei tunneta tai sinulla ei ole käyttöoikeutta – kaikki palauttavat virheen 404. Varmista, että olet kirjautunut sisään ylläpitäjänä (tai opettajana Classroomissa), organisaatiosi on wksp_-organisaatio ja Padlet on ottanut mukaan organisaation omistajan. Pyydä mukaan ottamista ottamalla yhteyttä tukeen.

Tarvitseeko minun kirjoittaa koodia?

Ei. Yhdistä Padlet MCP, kirjaudu sisään ylläpitäjänä ja esitä kysymyksesi arkikielellä. API-vaihtoehto on tarkoitettu kehittäjille ja kokeneille käyttäjille, jotka käyttävät jo julkista API:a.

Onko tämä sama asia kuin julkinen API?

Ne liittyvät toisiinsa, mutta kyseessä eivät ole sama käyttötapa. Julkinen API on tarkoitettu kehittäjille, jotka käyttävät API-avainta. Padlet MCP on tarkoitettu tekoälyavustajille, joille annat valtuutuksen kirjautumalla sisään. Molemmilla voi käyttää organisaation analytiikkaa, kun organisaatiosi on otettu mukaan ohjelmaan. Voit käyttää kumpaa tahansa tai molempia.

Voivatko oppilaat tai muut kuin ylläpitäjät tarkastella organisaation analytiikkaa tällä tavalla?

Eivät. Analytiikan käyttö edellyttää organisaation ylläpitäjän roolia tai opettajan roolia Classroomissa. Avustajalla on täsmälleen samat käyttöoikeudet kuin tilillä, jolla kirjauduit sisään – ei enempää.

Vaikuttaa siltä, ettei MCP-asiakkaani tunne analytiikkaa. Mitä voin kokeilla?

Joillakin asiakkailla työkaluluettelon päivittyminen kestää. Kokeile yhdistää Padlet MCP uudelleen, vaihtaa toiseen MCP-yhteensopivaan asiakkaaseen tai käyttää suoraan organisaation analytiikka-API:a. Jos et edelleenkään pääse käyttämään sitä mukaan ottamisen jälkeen, ota meihin yhteyttä.

Aiheeseen liittyvää

Oliko tästä artikkelista apua?

Aiheeseen liittyvät artikkelit