Bitly V2
The Qlik Bitly V2 connector uses the Bitly API to access your Bitly data, such as which countries or pages are directing traffic to your Bitlinks.
Ways to access your data
To access your Bitly data, you need to authenticate the connector with your Bitly account credentials. After you create a connection and select Bitly as your data source, you are redirected to a Bitly login page. Log into Bitly with your Bitly account credentials or login with the third-party authentication. After you enter your login credentials you receive an authentication token which you enter into the connector.
Creating a connection and selecting data
Loading data from tables
After you authenticate the connector with your account credentials, use the tables to fetch your data. Some tables are preconfigured to access a specific set of data while others let you create custom queries. The table below outlines some of the use cases for some of the tables that are available.
| Table | Description |
|---|---|
| LinkHistory | Use this table to fetch the list of your link history. This table will return the Bitlink and the full URL, along with other important information about your Bitlinks. |
| Countries | Use this table to fetch the data about which countries are referring click traffic to your Bitlink. |
| Referrers | Use this table to fetch the data about which pages are referring click traffic to your Bitlink. |
To select and load data from a table, enter the required table parameters and click Preview data. Required parameters are marked with an asterisk (*). The table fields are displayed under the Data preview tab. You can select fields individually by selecting the box beside each field name. Select Insert script after you have made your selection.
Creating a connection and selecting data
Table parameters
To run some of the tables, you need to enter specific table parameters, usually in the form of an object ID or an object name. You can find many of these parameters when you run other tables.
For example, to run most of the Bitly tables you must enter either a shortened Bitly URL or the long URL. You can fetch a list of the URLs that are associated with the authenticated user's account by running the LinkHistory table.
Working with the Bitlink API quota limits
The Qlik Web Connectors use the Bitlink API to extract data from Bitlink and load it into your Qlik Sense app. While reloading you Bitlink-based app, you might receive an error message that the connector has reached the Bitlink API rate limit and that all subsequent API calls will fail until the connector falls back under the throttling limit. If you receive this error message, then you have exceeded one of the API rate limits.
You receive an error message that you have reached the API rate limit
Reference - Bitly developer documentation
You can refer to the Bitly developer documentation to learn more about the requirements and restrictions imposed by the Bitly API. Note that Bitly connections utilizing a pre-V4 version of the API will not be functional.
Troubleshooting
You receive an error message that you have reached the API rate limit
Possible cause
You have exceeded the API limits that are imposed on the Qlik Web Connectors by the Bitly API.
Proposed action
To reduce the impact of reaching the API rate limits, develop your app with the following in mind:
Extract only the data you need.
Reload one Bitly-based application at a time.
Ensure that loops in your script that make API calls will not result in infinite loops.
