Integrate JazzHR with Your Career Page/Website - Advanced Methods

Connect your JazzHR account to your website’s career page for a seamless job-posting experience.

The following career page integration options allow for more customization than the standard methods but also require web development resources to implement. You gain customizability as these options increase in integration effort.

This article covers:

Still want a more custom experience? Let JazzHR build and maintain your careers page.

Custom Layout

The custom layout is built using a combination of proprietary HTML elements (called Resumator Markup Language) as well as your own HTML and CSS elements. RML elements provide the basic framework for the page and your HTML and CSS complete the finishing touches.

For example, to display the list of open jobs, you would place the RML tag:

<resumator content="job_listings" layout="table" />

When processed, the tag will be replaced with an HTML table of current job listings that can be fully styled with CSS.

To configure the Custom Layout, click Settings > Career Page > Custom Layout > EDIT THIS LAYOUT

Tracking Pixels

The Custom Layout also supports the use of tracking pixels installed on the Application Confirmation page to track recruiting campaigns from third-party sites (Facebook, Twitter, HubSpot, etc.)

First, retrieve each tracking pixel from the 3rd party site. For recruitment campaign tracking, for example, you may need to retrieve this from one of the following:

If you're using this for application conversion, you may need to retrieve this from one of the following:

For all other 3rd party systems, contact your representative there directly. 

Note that regardless of the system, you'll only need the URL portion of the JavaScript tag, as seen below.

Screen_Shot_2018-12-16_at_8.00.55_PM.png

To add Tracking Pixels:

  1. Click Settings > Career Page > Custom Layout > EDIT THIS LAYOUT
  2. Click the edit icon next to Jobs Widget Tracking Pixels
  3. Enter your tracking pixel URL
  4. example: <img src="hereismypixel.com/image.gif" height="20">
  5. Click Save Layout

Once saved, your pixel can be tracked by your vendor.

Using a Custom Domain Name

Using a custom URL for your Career Page can add to the overall professionalism of your company. By default, the URL for your hosted careers page is https://mycompanydomain.applytojob.com.

You can customize this URL through either the use of a CNAME or a Content Delivery Network.

Custom Domains via CNAME

In this configuration, the customer points a hostname in their domain name to their Career Page.  

  1. Choose the DNS name for the URL. For example, jobs.mycompanyname.com, careers.mycompany.com, or even jobs.mydomain.co.uk.
  2. Create, or have your IT Department create a CNAME record for that URL. A CNAME record maps one DNS name to another DNS name.
  3. When creating a CNAME record, it should point to the DNS name of your hosted careers page, such as mycompanydomain.applytojob.com.
  4. Once you have completed the CNAME configuration, log in to JazzHR and follow the steps in the Configuring the Custom Domain Name in JazzHR steps below.

Functionality Impact with CNAME Configurations

When configuring a custom domain using a CNAME, you will lose certain functionality. 

  1. Due to the nature of JazzHR, the Applied With LinkedIn and Apply with Indeed buttons will no longer function on the Application Page. You should remove these to promote a better customer experience.
  2. Using the Share to Social Media functions take an extra step when a CNAME is configured. The links generated from these posts are not converted over to the new CNAME configuration. The links will use the default URL generated by JazzHR. You will need to update these links manually if you are using the Share on Social Media functions.
  3. At this time, our infrastructure only supports CNAMEs using HTTP. Do not try to use your CNAME over HTTPS. If you do, you will get a security error about mismatched certificates.

Custom Domains via CDN

In this configuration, the customer controls and configures a Content Delivery Network, including obtaining and installing any certificates. The CDN configuration uses the default applytojob.com career page URL as its origin, while the JazzHR application is configured with the CDN-bound URL, which is then used when creating links and for similar functionality.

  1. Set up your CDN distribution using your intended hostname, including installing the desired certificate and pointing your desired custom domain name to the CDN distribution.
  2. Use https://YOURSUBDOMAIN.applytojob.com as the origin. NOTE: Do not cache any query parameters as this will negatively impact source tracking.
  3. Once you’ve validated your CDN’s configuration, follow the steps in the Configuring the Custom Domain Name in JazzHR section below.

Configuring the Custom Domain Name in JazzHR

This procedure is required for both the CNAME and CDN configurations; the process is the same for both.  Do not complete this step until you've verified your configuration above.

  1. Click the Settings tab.  Only Super and Recruiting administrators and owners will have access to the Settings tab.
  2. Click the Career Page tab.
  3. Under the Careers Website Custom Domain, enter the custom domain name you've created. For example,jobs.mycompanyname.com or careers.mycompany.com. NOTE: If this is not properly configured on your end, this will break the links to your syndicated jobs.
  4. Click the Save button.

Test the configuration by navigating to your custom URL to ensure your careers page content is displayed.

Data Feeds

JazzHR provides two different types of data feeds containing the raw job content needed to build a custom careers page on your company's website.  These data feeds provide the raw job posting content which can be combined with your developer's look, feel, and design to create a 100% customized careers page.  Building a careers page using the data feeds does require development resources and requires the most effort to implement, but offers the most flexibility for customization.

There are two data feeds available:

  1. XML feed
  2. JazzHR API

XML Feed

The XML feed is designed for importation into external systems. It contains an XML encoded list of all jobs in your account which meet the following criteria:

  • Job Status = Open
  • EXPOSURE > Careers Website = YES

The URL can be found by clicking Settings > Career Page > XML FEED.  Below is the content from a sample XML file.  

<?xml version='1.0' encoding='utf-8'?>
<jobs>
 <publisher>Jazz</publisher>
 <publisherurl>http://app.jazz.co</publisherurl>
 <lastBuildDate>Wed, 1 Mar 2017 11:11:11 GMT</lastBuildDate>
 <company><![CDATA[Company Name in JazzHR]]></company>
 <job>
   <id><![CDATA[job_20170224230626_FPYZRT7IELMUEIX3]]></id>
   <internalcode><![CDATA[]]></internalcode>
   <status><![CDATA[Open]]></status>
   <title><![CDATA[Software Engineer]]></title>
   <department><![CDATA[Engineering]]></department>
   <url><![CDATA[http://myjazzhrsubdomain.applytojob.com/apply/yvcLOyyQsD/Software-Engineer]]></url>
   <city><![CDATA[Seattle]]></city>
   <state><![CDATA[WA]]></state>
   <country><![CDATA[United States]]></country>
   <postalcode><![CDATA[98107]]></postalcode>
   <description><![CDATA[]]></description>
   <type><![CDATA[Full Time]]></type>
   <experience><![CDATA[Experienced]]></experience>
   <buttons><![CDATA[<script type="text/javascript" src="//app.jazz.co/widgets/buttons/create/myjazzhrsubdomain/yvcLOyyQsD"></script>]]></buttons>
 </job>
</jobs>

In addition to pertinent job fields, each <job> record contains the following useful elements:

  • <url> a link to the job application on your hosted careers page
  • <buttons> a javascript button widget for each job.  When embedded it renders a self-contained "Apply Now" button allowing candidates to apply from the page without needing to be redirected to the hosted page.

NOTE: The XML feed is NOT designed for real-time display within a custom careers page. Developers utilizing the feed are required to download the file on a periodic interval and serve it from their own systems.

JazzHR API

The JazzHR API contains methods that allow you to extract job posting information in a JSON encoded data array.

The data records provide the raw job content which can then be manipulated by your developer's to provide the desired look, feel, and functionality for your careers page.

To extract the job postings out of your JazzHR account, make a call to GET /jobs (supplying any desired parameters, such as status/open).  The API will respond with a list of job records which meet the supplied criteria.  

IMPORTANT NOTES:  

  1. Extracting job records via GET /jobs is an acceptable option for creating career page content, we do not recommend using the POST /applicant endpoint to submit candidate applications.  The v1 API will not trigger workflow automation.  We recommend using the url or buttons attributes as outlined below. 
  2. While the XML feed includes the <url> and <buttons> elements, the API does not.  However, you can programatically create these items using a combination of the strings below and the key:value pair included in the API response called "board_code".  

$url = http://myjazzhrsubdomain.applytojob.com/apply/board_code

$buttons = <script type="text/javascript" src="//app.jazz.co/widgets/buttons/create/myjazzhrsubdomain/board_code"></script>"

Frequently Asked Questions

I want to use the data feed, which one should I use?

Here are the pros and cons of each.

XML Feed

  • Static XML encoded file of all Open job records in the account
  • Cached for 24 hours
  • Found at: SettingsCareer Page > XML FEED
  • URL: https://app.jazz.co/feeds/export/jobs/customersubdomain
  • Includes a <url> element and <buttons> element for every job.

JazzHR API

  • Rest style web service API
  • Data structure = JSON array
  • Can specify various parameters to extract complete job records, not just Open job records
  • Job records do not include a <url> or <buttons> element - need to programmatically create them

 

Was this article helpful?
4 out of 6 found this helpful