Recommended Matches
Overview
Recommended Matches extends Recruiter System Connect (RSC) functionality within the applicant tracking system (ATS) via an additional plugin. The solution is presented and optimized to streamline recruiters’ sourcing experience. For every requisition (synced job) via the ATS, LinkedIn automatically presents a stream of matches and recommended candidates from across its network for recruiter users to rate and reach out to. With Recommended Matches, users can:
- Access the best candidates for a posted job/requisition, even if they haven’t actively applied to yet.
- Reach out to matches they think are a good fit, and save them to existing ATS requisitions (similar to One-Click Export).
- Get better matches over time as the algorithm learns from selected preferences.
The Recommended Matches solution will be delivered in the form of an iframe widget and will be implemented in the ATS similar to how the Display Profile Plugin is implemented today. Via RSC’s standard implementation, LinkedIn already receives all ATS jobs via the Sync Jobs endpoint. For the Recommended Matches widget to show a stream of candidates, the following minimum fields for each job must be synced: Job Title and Location.
The Recommended Matches widget will display up to 125 matched candidates, with 25 candidates shown per page.
User Flow
The widget will include the ability for the user to initiate specific actions such as:
- Save to Job - Ability to One-Click Export candidates' stub profile information into the ATS database under that specific requisition.
- Save and InMail - Ability to One-Click Export candidates' stub profile information into the ATS database under that specific requisition and send an InMail.
Requirements
Recruiter System Connect (RSC) is a prerequisite for Recommended Matches and must be fully integrated and implemented to enable any of the functionality detailed in these specs.
The plugin is rendered within an iframe and is self-contained; the JavaScript code handles the authentication and renders the content. This feature is dependent on already syncing jobs from your system to LinkedIn.
Customer Enablement
When partners build Recommended Matches, customers will get RM automatically enabled as part of RSC enablement via onboarding widget.
Display Recommended Matches Plugin
Using the customer's app credentials provisioned for Recruiter System Connect, display the Recommended Matches Plugin:
<script src="https://platform.linkedin.com/xdoor/scripts/in.js">
api_key: {api_key}
extensions: RMWidget@https://platform.linkedin.com/rsc/extensions/recommended-matches-widget
</script>
<script type="IN/RMWidget"
data-ats-job-posting-id="{job_id}"
data-integration-context="urn:li:organization:{id}"
data-width="{width}">
</script>
Recommended Matches Parameters
Parameter | Description | Required |
---|---|---|
data-ats-job-posting-id | externalJobPostingId of previously synced job using Sync Jobs |
Yes |
data-integration-context | Integration context value for the customer's integration. You'll get this value when the customer enables the integration via the Integration Configuration Plugin. | Yes |
data-width | Ability to override default width of the plugin. Default and expected minimum width is 800px. | Yes |
Note
Verify Content Security Policy includes "platform.linkedin.com" and "www.linkedin.com".