Set up your Blackboard integration

This guide provides all you need to know about configuring and testing your Blackboard LTI integration with Perlego.

Table of contents

1. About the Blackboard integration
2. Configure your Blackboard integration
   1. Set up Perlego on Blackboard
   2. Send Perlego your deployment ID, LMS URL and default access link
   3. Check the Perlego placement
   4. Create a placement (optional)
3. Testing
   1. SaaS Learn

About the Blackboard integration

Our Blackboard integration allows admins and instructors to deep-link titles from Perlego to a module/unit within a course.

When a student clicks on a Perlego link they are automatically directed to create their account and once registered will be automatically logged in, creating a seamless experience for your students.

We support the following Blackboard instances:

• Blackboard Self-Hosted
• Blackboard Learn (classic)
• Blackboard Ultra

Configure your Blackboard integration

Before you start the configuration make sure:

• Your organisation is on the Ultimate plan OR you have purchased the LMS integration as an add-on. 
• You have System Admin access to your Blackboard instance.
• You have a test course within Blackboard.
• You have created an access link for new registrations to be sent to.

Set up Perlego on Blackboard

1. Navigate to the System Admin section of your Blackboard instance. Under the Integrations section, click on LTI Tool Providers.
2. Click on the Register LTI 1.3/Advantage Tool tab at the top section of the screen.
3. Enter our ClientId and click Submit.
   • Client ID format: 70cc2a63-e05c-4105-afce-dbaffda26137
4. The Tool Status page will open. The following settings are required:
   1. Tool Status must be set as Approved.
   2. Tick all the fields in the User Fields to Send section.
   3. Allow grade service, Allow Membership Service, and Show User Acknowledgment Message must all be set to No.
   4. Copy the deployment ID, and make a note of it - you’ll need it later.

Once these changes are made click on Submit.

Send Perlego your deployment ID, LMS URL and default access link

Send us the Deployment ID you’ve generated and your Blackboard URL by completing our LMS set up form, so we can complete the registration.

• You can access the deployment ID at any time by finding Perlego in the list of LTI Tool Providers.

• Hover over the Tool Provider name and click on the chevron. Then select Edit.

You’ll also need to tell us which access link your LMS users should be directed to for signing up to Perlego.

If you don’t have an access link yet you’ll need to create one in Perlego, this requires a Perlego admin login.

Check the Perlego placement

Our Blackboard integration should add the deep linking content placement automatically. Once we confirm your account has been configured, please check the placement has been created.

To check the placement:

• Navigate back to the System Admin section of your Blackboard instance. Under the Integrations section, click on LTI Tool Providers.
• Hover over the Perlego tool provider name and click on the chevron. Then select Manage Placements.
• You should see a placement with the Deep Linking Content Tool type.

If the placement has not been created or you’d like additional placements, follow the instructions below.

Create a placement (optional)

1. Find Perlego in the list of LTI Tool Providers. Hover over the Tool Provider name and click on the chevron. Then select Manage Placements.
2. Select Create Placement.
3. We support the Deep Linking content tool, System Tool and Course tool placements, follow these steps to set up deep linking:
   1. Enter Perlego as the Label.
   2. Create a Handle (e.g. PerlegoContent).
   3. Set Availability to Yes.
   4. Select the placement type.
   5. For deep-linking, choose if you want the Perlego book selector to Launch in New Window. For course tool and systems tools Launch in new window must be selected.
   6. Add an icon (optional).
   7. Set the Target Link URL to https://perlego.ltiaas.com/lti/launch
      

Testing

SaaS Learn

1. Navigate to a course you want to link Perlego content to.
2. Click on the Content section on the sidebar.
3. Click on the Build Content dropdown and then select Perlego from the list of the sources.
4. This open the Perlego book selector.
   1. Search for and select a book you want to add as content.
   2. Click Submit.
5. Return to Contents page tab and the book will be listed (you may need to refresh the page).
6. Click on the Content, you should be directed to your access link or you’ll be logged in if you already have an account

Here is the student experience when they click on a book.