How to set up Bitly URL shortener integration

URL shortener integration enables Siteimprove to access URL shortener data. The Bitly integration allows you to see data from your Bitly URL shortener within the Siteimprove CMS plugin.

The URL shortener integration helps:

• Give users an overview of digital content assets and their dependencies when managing their digital assets.


• Check if unpublishing a page will have an impact on short URLs linked to that page.


• Indicate different usage of the page.


• Indicate digital assets that may be relevant to another department’s material.

Note: You need to be a Siteimprove Account Owner or Administrator to add the Bitly URL shortener integration. For information on how to create an OAuth access token for the Bitly API webpage see “How to create an OAuth access token for the Bitly API".

Connecting Bitly with OAuth

1. Navigate to Integrations > Integrations Overview from the main menu.


2. Locate the Bitly integration in the URL Shorteners section.


3. Select on the "Connect with OAuth" option in the dropdown list under “Connect”.
   


4. Authorize the integration with your Bitly credentials via the pop-up presented.
   

5. When successful, a notification will be shown to confirm that your Bitly account is connected. You will then be redirected to the Manage URL shorteners page of the Integrations menu.

Connecting Bitly with an API

1. Navigate to Integrations > Integrations Overview from the main menu.


2. Locate the Bitly integration in the URL Shorteners section.


3. Click on the "Connect with API" option in the dropdown list under “Connect”.


4. Enter a unique name for your Bitly connection.
   


5. Enter the access token generated in Bitly.


6. Click the "Connect to Bitly" button.


7. When successful, a notification will be shown to confirm that your Bitly account is connected and you will be redirected to the Manage URL shorteners page on the Integrations menu.
   

Manage URL Shorteners

Within Manage URL Shorteners it is possible to edit or delete Bitly API URL Shortener connections.  When editing the connection you can change the connection name and the authentication token. It's not possible to edit an OAuth URL Shortener connection. In this case, you need to delete and create a new connection to change the authentication details.

Siteimprove CMS plugin

Once you have added the Bitly connection, data from your URL shortener will be visible within the Siteimprove CMS plugin. You can then use the plugin to get an overview of all digital content assets and check if unpublishing a page will have an impact on short URLs linked to a page.

 URL shortener data can be found in the following two locations within the Siteimprove CMS plugin:

•  On the page details under the “This page” tab.
  


• When viewing the impact of un-publishing a page via the “See Unpublish Impact” button.
  

Further information on the Siteimprove CMS plugin can be found in the following articles:

• What does the Siteimprove CMS Plugin offer?


• How to navigate the Siteimprove CMS Plugin

Note: Siteimprove is happy to help with questions regarding configuring the integration. Siteimprove does not provide support or product help for the third-party software with which you are connecting.