Step One: Register LTI 1.3 Tool


First, log into your Blackboard administrator account.

  • Blackboard users click System Admin
  • Blackboard Ultra users click Admin



Under Integrations tab, click LTI Tool Providers.



Click Register LTI 1.3/Advantage Tool.



Enter the following Client ID:
a0ac99ee-c2e5-4cd3-a806-0df2999dc860


Then click Submit.



Next, verify and set the following information:


TOOL STATUS

  • Client ID: a0ac99ee-c2e5-4cd3-a806-0df2999dc860 (same as above)
  • Name: PitchVantage
  • Description: PitchVantage LTI 1.3
  • Deployment ID: Copy the entire value and email to PitchVantage tech team! We need the deployment ID to finish the configuration for you.
  • Initiate Login URL: https://cp.pitchvantage.com/blackboard/login
  • Tool Redirect URLs: https://cp.pitchvantage.com/blackboard/launch
  • JWKS URL: https://cp.pitchvantage.com/blackboard/jwks
  • Domains: cp.pitchvantage.com
  • Tool Status: tick the circle next to Approved
  • Tool Provider Custom Parameters:
    • blackboard_username=@X@user.id@X@
    • blackboard_course_id=@X@course.pk_string@X@
    • blackboard_user_external_uid=@X@user.batch_uid@X@
    • blackboard_course_external_uid=@X@course.batch_uid@X@
    • blackboard_user_id=@X@user.pk_string@X@

INSTITUTION POLICIES

  • User Fields to Send: tick the box next to ALL three fields
    • Role in Course
    • Name
    • Email Address
  • Allow grade service access: Yes
  • Allow Membership Service Access: Yes



Note: if you haven't done so already, please email support@pitchvantage.com the Deployment ID now!


Finally, click Submit to create the tool provider.


Step Two: Manage Placements


First, log into your Blackboard administrator account.

  • Blackboard users click System Admin
  • Blackboard Ultra users click Admin


Under Integrations tab, click LTI Tool Providers.


Under TOOL/PROVIDER column, find PitchVantage then click the down arrow next to it.


Click Manage Placements.



Click Create Placement.



Next, enter the following following:


PLACEMENT INFORMATION

  • Label: Enter the name that will appear in the course (for example, PitchVantage)
  • Handle: pitchvantage-lti
  • Availability: Yes
  • Type: Course Content Tool
    • Tick the box next to Allows grading
  • Tick the box next to Launch in New Window
  • Icon: save the following icon to your computer then click upload

https://cp.pitchvantage.com/img/pv-icon-blue.png


TOOL PROVIDER INFORMATION

  • Target Link URL - https://cp.pitchvantage.com/blackboard/launch
  • Tool Provider Custom Parameters:
    • blackboard_course_external_uid=@X@course.batch_uid@X@
    • blackboard_user_id=@X@user.pk_string@X@
    • blackboard_username=@X@user.id@X@
    • blackboard_course_id=@X@course.pk_string@X@
    • blackboard_user_external_uid=@X@user.batch_uid@X@


Finally, click Submit.


Step Three: Enable Tool and Grade Posting


First, log into your Blackboard administrator account.

  • Blackboard users click System Admin
  • Blackboard Ultra users click Admin


Under Integrations tab, click LTI Tool Providers.


Click Manage Global Properties.



Select Yes next to Allow configured tool providers to post grades.



Finally, two things to double check:


1. Make sure the "PitchVantage" provider domain's status is approved: go to System Admin (Ultra users go to Admin) > LTI Tool Providers. STATUS column must be Approved.



2. Make sure LTI tools are enabled in your system: go to System Admin (Ultra users go to Admin) > Tools. In here, look for the tool labeled LTI and make sure the availability for the Course Tool is “On”.



Finally, look for the tool labeled PitchVantage and make sure the availability is also “On”.



Blackboard users are sometimes faced with an unexpected message from Blackboard when launching the Attendance LTI tool that states "The Tool Provider has been disabled by The System Administrator". If you have followed the instructions above but the error message persists, please email support@pitchvantage right away for help.