There are two different versions of the Desire2Learn user interface. This page covers Perusall setup in the old version of the interface; if you go go to your D2L course and see "select a module" then you are using the old version. If you go to your D2L course and see "select a unit" then you are using the new version,
To connect Perusall to Desire2Learn, Contact email@example.com to obtain the institution’s Consumer Key & Shared Secret. Please email in from your official university email address using the subject line “Key and Secret Request” (For security verification purposes, please provide a link to an institutional web page that shows your name, email address, and title/affiliation.)
If your D2L administrator has already set up Perusall as a global tool in D2L, you can skip the installation instructions and go directly to “Adding a Perusall link to your D2L course”. Please check with your D2L administrator before proceeding.
- Go to your D2L course, click: External Learning Tools > Manage Tool Providers > New Tool Provider.
- Enter https://app.perusall.com/lti/launch in the Launch Point field.
- Choose version 1.1 from the LTI Version dropdown menu
- Choose HMAC-SHA1 from the OAuth Signature Method dropdown menu
- Enter your institution’s Shared Secret
- Check “Use custom tool consumer information instead of default”
- Enter your institution’s Consumer Key
- Enter “Perusall” in the Name field
- Enter “The Perusall social learning platform.” in the description field.
- Enter “firstname.lastname@example.org” in the Contact email field.
- Check “Allow users to use this tool provider”
- Check all security settings except “Send system Org Defined ID to tool provider”
- Click "add org units" and
- Click Save and Close
- Go to your D2L course>select a module> select existing activities > external learning tools > create new link
- The title can be anything such as "Perusall" the LTI URL is https://app.perusall.com/lti/launch > and select Legacy LTI Tool > and create and insert
- Next click edit properties in place >select open as an external resource
- Click the Perusall link that appears in the module to launch Perusall and create a D2L-linked Perusall course. Students can also click this link to launch into your Perusall course.
You can sync students' average assignment scores or students’ individual assignment scores back to D2L.
Average grade sync:
A student’s average score is each individual assignment score summed and then divided by the total number of assignments.
Syncing the average score rather than individual assignment scores saves time because an instructor will only need to create one Perusall link in a D2L content area rather than an assignment link for each assignment. Students will access Perusall through this link.
- Launch into your Perusall course> Click Settings > Scoring > scroll to Grade sync to LMS > select Automatically sync students' average scores back to the LMS > press save changes
Students will click the Perusall link you created to access their Perusall assignments and Perusall will pass their average scores back to D2L as you release assignment scores in Perusall.
Individual assignment grade sync
To sync students’ individual assignment scores, create Perusall assignment links in D2L whose names match your Perusall assignments
- In Perusall, go to Settings > General set the Grade sync to LMS field to Automatically sync students' individual assignment scores back to the LMS
- In Perusall, click Course home > Assignments > select an assignment > Copy full title for LMS. The assignment name will be copied to the clipboard
- Go to your D2L course > select a module > select existing activities > external learning tools > create new link
- Paste the assignment title in > the LTI URL is https://app.perusall.com/lti/launch > and select Legacy LTI Tool > and create and insert
- Next click edit properties in place > select open as an external resource
- Test launch. You should launch directly into the corresponding assignment in Perusall.
Repeat this process for each Perusall assignment. Hide the generic Perusall link from the students’ view in D2L (so students only use the assignment-specific links, thereby ensuring grade sync works correctly) by clicking the dropdown menu in the generic Perusall link’s row and then Hide from Users.
In order to successfully sync individual assignment scores, students must access each Perusall assignment by clicking its assignment-specific link in D2L. If a student does not, then Perusall will not be able to send the student's scores back to D2L.
When D2L first receives grades from Perusall (whether individual assignment grades or the average grade) to a particular link, it will by default create a new grade item out of 100. The numeric value will correspond to the percentage equivalent of the student's Perusall score. (For example, if you leave your Perusall course at the default 0-3 grade scale, D2L will show scores of 0, 33.3, 66.7, and 100 for Perusall scores of 0, 1, 2, and 3, respectively.)
D2l Gradebook Note
If you prefer that the score in D2L be out of a different number of points, you can change the total number of points for the assignment by creating a grade item before Perusall sends grades to D2L for a particular assignment
- In the content area where you created a particular Perusall link, click the arrow next to the name, and select View Topic. (it will launch into Perusall but exit out of the screen and back to the edit page.)
- At the bottom under Assessment, click Add grade item, and then + to create a new grade item for the assignment.
- In the resulting dialog, give the grade item a name (how you want this to show up in the D2L gradebook) and the number of points the assignment should be out of. We recommend using the same scale as your Perusall course (e.g., 3 points if using the default grade scale of 0-3 in Perusall) to avoid confusion. Then click Create and then Save.
See our general LMS troubleshooting page for other common issues.