Adding the Plugin Code

Getting Started

The Apply plugin is a snippet of JavaScript that needs to be included on every job application page where you'd like to offer an optimized apply experience. By doing this you will be able to track analytics on your jobs.

Step 1: Sign up for an API key

If you don't already have a LinkedIn® API key, you need one to use the Apply Plugin. Create a LinkedIn® API key and remember the API Key that is generated for you. It will look something like: d8amgl12v4ht. If you already have a LinkedIn® API key, you can reuse it.

To retrieve your API Key

  1. Navigate to https://developer.linkedin.com/.
  2. Click My Apps.
  3. Log in using your LinkedIn® account credentials.
  4. Click OK, I'll Allow It.
User-added image

User-added image

  1. Click Create Application.

User-added image

  1. On the Add New Application page, complete the required information for each field, noting the following:
    • In the Application Name field, enter a name for the application (e.g., Acme Staffing LinkedIn® Integration).
      • In the OAuth User Agreement Default Scope field, select the following scope:
        • r_emailaddress,
        • r_contactinfo,
        • r_fullprofile
      • In the OAuth 2.0 Redirect URLs field, list the following, separating each by a comma:
      • In the JavaScript API Domains field, list the following, separating each by a comma:
      • Click Add Application.
      • On the Application Details page, copy the string of letters and numbers under the Client ID and Client Secret fields and paste it into the API Key and Secret Key fields on the Configure Widget form back in ApplyMetrics; then complete the rest of the instructions above to finish enabling the integration.

    User-added image

    (All this information and more is in the LinkedIn® JavaScript API Getting Started Guide.)

    Step 2: Load the framework

    To load the Javascript framework, embed the following JavaScript in your HTML page:

    <script type="text/javascript" src="http://platform.linkedin.com/in.js"> api_key: <YOUR API KEY GOES HERE> extensions: LIApply@//apply.useast.appfog.ctl.io/api/linkedinapplytag.js </script>

    Replace <YOUR API KEY GOES HERE> with the API Key/Client ID from Step 1. You don't need the angle brackets.

    Step 3: Embed The Apply with Apply Plugin tag

    Place this tag on your page where you want the Apply plugin to appear.

    <script type="IN/LIApply"></script>

    The tag needs 2 parameters to work. This will identify the job title, and delivery mechanism.

    Step 4: Job Title

    Every job requires a job title.

    data-jobTitle="Chief Cat Wrangler"

    This lets applicants know what they're applying for. It can be detailed or generic ("Member of the technical staff"), but it needs to be there.

    Step 5: Delivery

    Last, you must indicate how you want the applications to be sent back to your company. The easiest method is to have the applications delivered via e-mail.

    data-email="jobs@mycompany.com"

    You can also have the plugin send an HTTP POST of the application to your own web service. This is covered on the Apply Processing Options page.

    Putting it all Together

    Here's the full code for a basic Apply Plugin:

    <html> <head> <title>Apply Plugin</title> <script type="text/javascript" src="http://platform.linkedin.com/in.js"> api_key: YOUR_API_KEY extensions: LIApply@//apply.useast.appfog.ctl.io/api/linkedinapplytag.js </script> </head> <body> <script type="IN/LIApply" data-jobTitle="Chief Cat Wrangler" data-email="your-email-address@your-company.com"> </script> </body> </html>

    Awesome, you have an Apply Plugin on your page! It behaves like this:

    The next step is learning the configuration options. This lets you configure the look-and-feel and behavior of the plugin.

    After that, read how to receive applications. This shows the schema for the application data we send to you, how to specify where we send it, and whether we use XML or JSON. We have sample code included in many languages to help get you started.

    Last, all of the supported parameters are on the Apply Widget Reference Guide. These tables are handy for lookups, when you want to double-check how a specific parameter behaves.