This document contains frequently asked questions that arise when using TapFree. You can quickly navigate to a particular FAQ by using the table of contents below.
Where can I find fetch times by data source?
How can I tell if my data is up to date?
What is OAuth and why am I getting errors?
Why does my call recording have a lag time before it starts playing?
How do I add a second account to an existing Data Connection?
Can I authorize multiple accounts for a single Data Source?
What issues might I encounter when authorizing multiple accounts for a single Data Source?
Why do I need the Data Load Status dashboard?
I clicked on Fetch My Data. Why don't I see a change on the Data Load Status page?
How do I know which timezone the data load status information is in?
Can I pause a data connection?
Can I receive notifications on my Data Load Status?
What are fetch times?
When you connect a Data Source to TapClicks, the data is automatically updated from the source so your reporting and insights stay up to date. This process of going out and collecting data from the source is called data loading.
Two types of data loads take place when you connect your data:
- Initial data load: triggered when you connect to a Data Source the first time and the system tries to fetch historical data.
- Periodic data load: data collection that takes place daily by TapClicks.
The amount of historical data requested for a given data load is also referred to as the lookback period.
Each data source and data load type will have a different fetch time. Fetch times depend on the respective application, and are based on several factors including what data are available from the source and how long the data load takes.
Where can I find fetch times by data source?
Fetch times are shown on the Data Load Status page, which is found in the Data section in the left-side menu.
How can I tell if my data is up to date?
There are a few ways to check how "fresh" the data is:
- You can check by using the date range to see when the data stops populating.
- You can go to Data Load Status and see the Daily Data Load Status tab to view the fetch completion details for each data source you've connector.
What is OAuth and why am I getting errors?
OAuth ("Open Authentication") is a way for applications to establish your identity using an already-connected credential. OAuth allows an end user's account information to be used by third-party Data Sources, such as Facebook, without exposing the user's password.
Example:
Let's say you want to log in to a photo-sharing application and on the login page it asks you to either provide a username and password or log in with Facebook. This "login with Facebook" option takes you to a form page where you select from the accounts you have. You select an account and the photo-sharing application now gives you access. In this case, the photo-sharing application used an OAuth to establish your identity.
This secure authentication of data exchange works seamlessly, but if the credentials change or expire it will prevent that exchange from taking place. If this happens, the solution is simply to update the credentials to reinstate the proper exchange of data.
The most common issues with OAuth are the following:
- Credentials have expired
- Password has changed
- An AdBlocker is being used
OAuth redirects to a vendor's authentication/authorization page. TapClicks works with Ad and Analytics platforms, so AdBlockers in your browser and Antivirus/Content filtering software may block the redirect and prevent the connection from being established.
To prevent the redirect from being blocked and ensure that you can connect to the data source, the AdBlocker’s filtering settings must be configured properly to whitelist TapClicks.
Some examples of whitelisting domains within your AdBlocker can be found below. Please note that different AdBlockers may have different user interfaces, please refer to their documentation for how to whitelist domains:
Why does my call recording have a lag time before it starts playing?
We do not store the MP3 files. When you click a recording link to listen, there's time needed to load the file which results in a slight lag time before the recording starts.
Why do I need the Data Load Status dashboard?
The Data Load Status page allows your team to review the status of your TapClicks Data Sources. It surfaces any issues that you can resolve, calls out issues that may be present for specific assignments, and allows you to subscribe to notifications so you know immediately when there's an issue. Use this dashboard to dig into specific data load statuses and stay up to date with how fetches are progressing.
I clicked on Fetch My Data. Why don't I see a change on the Data Load Status page?
The Data Load Status page only supports daily fetches at this time. If you make additional fetches by clicking the "Fetch My Data" button, the Data Load Status “needs attention” will surface issues with the fetch, when applicable.
How do I know which timezone the data load status information is in?
When you log in, you will see a message in the top right corner of the screen that indicates the timezone for your instance.
If you need to change the timezone, go to Admin > Platform Settings to set a new timezone for TapFree.
Can I pause a Data Connection?
Yes, you can pause active Data Connections by pressing the Pause Data Flow button for the connection on the Data Load Status page. For more information, please refer to How to Pause Data Flow.
Can I receive notifications on my Data Load Status?
Yes, you can receive notifications on your Data Load Status by setting up custom notification rules in the Notifications tab. Here, you can specify which data sources and connections to include or exclude, and enter email addresses that should receive these notifications. You can also set a daily maximum for email notifications to manage the frequency of alerts. These rules are customizable and can be edited, copied, or deleted according to your preferences. For information about the Data Load Status Notifications, refer to the Understanding the Data Load Status Dashboard article.