1. Feature Overview
The Distance Travelled Report connector enables you to track and monitor the distance travelled (in kilometres) by your field sales users on a particular day. It also captures the distance covered based on the activities users post from various locations, through the LeadSquared mobile app.
To know more, refer to Distance Travelled Report connector.
2. Prerequisites
- You must be the administrator of your LeadSquared account to install and configure this connector.
- Your users must have the LeadSquared app installed on their mobile devices, and location permission access must be enabled. To know more, please refer to Location Tracking on LeadSquared Mobile.
- If you choose to configure the connector using the Google Direction Maps API, you must provide your Google Map API Key.
- If you’ve selected the Google Directions Maps API method, you must have an active Google Cloud Platform Account.
- The mobile app’s Location Accuracy must be set to Best. To do this –
- On the app, tap
, and then tap
.
- On the Settings screen, tap Battery Usage Settings.
- From the Location Accuracy slider, select Best.
- On the app, tap
- To know how to create activities that will also capture your user’s location, please refer to How to Enable Geotracking for LeadSquared Mobile App Users.
- This is a paid feature. To enable it, please reach out to your account manager, or write to support@leadsquared.com.
- For optimal connector performance, users must regularly post activities, with GPS turned on.
3. How it Works
This connector calculates the distance covered using the Haversine Formula or the Google Direction Maps API.
- The Haversine Formula measures the displacement between the latitude and longitude coordinates (i.e., your user’s start and end points) to calculate the distance covered. In other words, it’s a bird’s eye view of the distance covered.
- The Google Direction Maps API records the latitude and longitude coordinates, and returns the distance travelled by your users, by assuming a specific path of travel.
4. Install the Connector
To install the Distance Travelled Report connector on your account –
- From the main menu, navigate to Apps>Apps Marketplace.
- Search for Distance Travelled Report, and click Install.
- Alternatively, you can find the connector on the left panel, under Analytics.
- On the Configure Distance Travelled Report pop-up, select the distance calculation method you want the connector to follow.
- If you select Google Direction Map API, in the box provided, enter your Google Map API key.
- Once you’re done, click Save. The connector is successfully installed and configured.
5. Generate Report
Once the connector is installed, to generate and view reports, navigate to Apps>Distance Reports. On the Distance Report page, you can –
- Sort the report based on –
- Name
- Distance covered
- You can also apply date-range filters on the report.
- Export the report, by clicking on Export.
- To download the report from LeadSquared, after you click Export, click Download.
- You will also receive the report on the email Id linked to your LeadSquared account.
- The report contains the details of your users’ First Name, Last Name, Email Address, and Distance Covered.
- Show up to 200 entries on a single page.
Note:
- Organization Hierarchy filter is not supported in the report.
- If you select a filter for multiple days, the total (aggregated) distance is displayed.
- The report sent to you via email will be available for download for only 6 hours.
- The report is updated every 24 hours, at 2 AM (as per the Time Zone configured in your account).
- To view the updated report for today, you must wait until 2 AM.
- The maximum date filter you can apply to display details is 31 days (e.g., March 1st to March 31st, June 1st to June 30th, etc.)
- The reports will not work as expected unless users regularly post activities, with mobile location enabled.
- Users will be able to view all the distance travelled reports available in the account.
6. View Report on the Mobile App
The Distance Travelled Report can also be viewed on the LeadSquared Android and iOS mobile apps. Before you configure the Report for the mobile app, install the Custom Menus for Mobile App.
From the web app
- After the Custom Menus for Mobile App is installed, hover your cursor over
, and click Configure.
- On the Configure Custom Menus for Mobile App pop-up, click Add Custom Menu.
- Enter the following details –
- Title – Provide a relevant title for the menu, like “Distance Travelled Report”.
- URL – Here, enter the following URL –
https://ui-distancetravelled-report.customapps02.leadsquared.com/?orgId=@{Account:ShortCode , }&accessKey=@{User:AccessKey , }&secretKey=@{User:SecretKey , }
- Visible for – From the dropdown, select which users who’ll be able to view the Distance Travelled Report.
- Once you’re done, click Save.
From the mobile app
- Open your LeadSquared mobile app, and from the main menu, tap Sync.
- The custom menu you created will be visible. Tap on it to view the Distance Travelled Report.
Any Questions?
Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!