Example integration - LinkedIn

Performance Analytics includes an optional example integration that demonstrates how to fetch data from the LinkedIn service and display it on a Performance Analytics dashboard.

To use the LinkedIn integration, you must activate the Performance Analytics - Example - LinkedIn plugin.

The integration enables you to track, break down, and report on the number of followers and updates for a particular company.

LinkedIn enforces several limits and requirements:
  • The LinkedIn Updates API supports only 600 calls per day. The integration tracks at most the latest 600 updates.
  • The application authentication must be refreshed every 90 days. See the access_token_expire field to determine when authentication expires.

Configure LinkedIn integration

Configure the LinkedIn integration to display LinkedIn data in Performance Analytics.

Before you begin

Role required: linkedin_admin
Before starting this procedure, ensure that you have complete the following prerequisites with the LinkedIn service:
  • A LinkedIn Client Application is associated with your company LinkedIn profile.
  • Configure the Client Application with the redirect URL for your instance. You can view this URL by creating a LinkedInApps record (LinkedIn > Apps).
  • You have recorded the LinkedIn Client Application API Key and API Secret values.

Procedure

  1. Navigate to LinkedIn > Apps.
  2. Click New.
  3. Enter a descriptive App name.
  4. Enter the Api key and Api secret for your LinkedIn Client Application.
  5. Right-click the form header and select Save.
  6. Click the Authenticate related link.
    You are redirected to LinkedIn. Complete any steps required by LinkedIn.
  7. On the LinkedInApp form, right-click the form header and select Reload form to confirm that the application was authenticated.
    Note the access token expiry date.
  8. Navigate to LinkedIn > Companies.
  9. Click New.
  10. Enter the company Name and the company ID Code.
  11. Click Submit.
  12. Navigate to LinkedIn > Access Rights.
  13. Click New.
  14. Select the App and Company records you created.
  15. Click Submit.
  16. Navigate to LinkedIn > LinkedIn Collector Job.
  17. Schedule this job to run at least once.
    The job state changes to Running, then to Ready. Wait for this process to complete before moving on--this may take several minutes.
  18. Navigate to LinkedIn > Aggregate Update Table and LinkedIn > Individual Update Table to verify that the tables were populated.
  19. Navigate to LinkedIn > PA Data Collector Job.
  20. Change the Relative end value to 0.
  21. Schedule this job to run at least once.
    An entry is added to the Job Logs related list. Wait for this record to reach the Collected state before moving on--this may take several minutes.

What to do next

After configuring the integration and collecting the data, you can view the LinkedIn dashboard by navigating to LinkedIn > Dashboard.

You can view all LinkedIn scorecards by navigating to Performance Analytics > Scorecards and filtering the list to include only scorecards that contain the text LinkedIn.