Sending source values to your ATS
Purpose
The purpose of this article is to outline how Eightfold sends the source values to your ATS in our mapping process.
Audience
This guide is intended for the Recruitment marketing/advertising team and Eightfold’s solution architects.
For linkoff PCS customers
SmartApply PCS takes care of the process of sending application and source data to ATS; however, if the customer has linkoff PCS - where candidates are redirected to customer’s ATS to finish the application instead of on PCS - we have to rely on limited approaches to send source information to ATS.
In PCS config, apply_redirect_url is the redirect url that takes candidates away from PCS and to ATS.
Customers can add parameters in apply_redirect_url to send information to ATS. The most basic form of apply_redirect_url looks like this:
"apply_redirect_url": "{{JOB_EXTERNAL_URL}}"
PCS automatically attaches src={{src}} in the redirect_url to pass the after-mapped source data:
apply_redirect_url: "{{JOB_EXTERNAL_URL}}&src={{src}}"
For example, the following redirect url will send ‘linked’ as source to the ATS:
apply_redirect_url: "{{JOB_EXTERNAL_URL}}&src=Linkedin"
Customers need to make sure that src={{src}}:
- The ‘src’ on the left side of the equals sign is the parameter name; please ensure that to put the parameter name related to source that your ATS can recognize. ‘src’ can be changed to any other parameter for your ATS, for example:
- apply_redirect_url: "{{JOB_EXTERNAL_URL}}&source=Linkedin"
- The ‘src’ on the right side of the equals sign is the post-mapped value of the utm_source/src/referrer values following the steps described above. Please make sure this equals the source code value that your ATS can recognize.