Before you begin: This user guide details the steps for setting up a SmartConnector™ using the Email delivery type, which is a type of basic connection.
Data Source and View Settings
1] Log in to TapClicks and, on the Data menu, click SmartConnectors.
2] The SmartConnectors™ list appears.
3] In the upper-right corner, click the Add SmartConnector (plus sign) icon to create a new SmartConnector™.
4] On the New SmartConnector™ page, enter a name for your SmartConnector™ in the Name field. This is effectively the name of the data source, so make it memorable and relevant to the data you are adding.
5] Enter a drilldown name for the SmartConnector™ in the Drilldown / view name field.
| Note: The Drilldown / view name will be the name of the data view you are creating. A data view is the same thing as a table in a database. You can read more about data views here: What is a Data View? |
6] Slide the Is active? control to the right to ensure the SmartConnector™ is turned on after you save it. You can change this later if needed.
Manage Connection
7] From the Delivery type dropdown menu, choose Email.
Additional Features
8] Choose the following optional features by sliding the control to the right.
- Map this SC to a single client?
- Use Geo Data? (By request only and may not be available for all accounts.)
- Use pre-process function?
- Use Email Service? This must be turned on.
- Data does not contain Dates?
- Use JSON Parsing Settings?
- Use Tab Parsing?
Email Service
| Note: In the Email Service section, a special email address is created which is personalized to your instance. When you email a file to this address as an attachment, it will be automatically added to your database. |
| Note: If you are uploading a JSON file, the system will automatically recognize the format, regardless of what delivery type you use. However, if you want to only pull a subset of a JSON file, you should slide the Use JSON File Config? slider to the on position. This will enable you to specify one or more arrays, subarrays, or objects from a JSON file to pull into TapClicks while ignoring the rest. Learn more about the Use JSON File Config settings in this article. |
9] Click the Copy button to copy the email address and save it somewhere secure for future use.
10] Optionally click Get New Email Address if you need a different email address.
11] In the Download data from area, slide Attached files? to the on position to upload data by attaching it to an email.
12] In the Download data from area, slide Links from emails? to the on position to upload data by embedding a link to a file in an email.
| Note: Both data download options can be activated simultaneously. This gives you the option of using either one in future data downloads. At least one of them must be set to the on position. |
13] If you want to filter attached data files so that only files containing specific text are fetched and parsed, enter that text in the Filename filter field. Check the Case sensitive checkbox if the text filter is to be case sensitive. This is also an option for Links.
14] Optionally check the Use REGEX checkbox to use a REGEX pattern as your filter.
| Note: Step 14 is intended for advanced users only. |
Data Fields
15] To provide sample data to TapClicks, click the Select Sample File button on the far right.
|
Note: The following file formats are allowed:
|
16] Navigate to the file on your local machine and click Open.
17] Click Upload.
18] The parsed data appears in the Data Fields section.
19] TapClicks does its best to guess the field type for each field. If it is incorrect, you can change the field type using the Field type dropdown menu.
20] Check the Is metric? checkbox when that field should be used as a performance metric.
21] Check the Include in charts? checkbox if the performance metric specified above is to be used in the row breakdown chart and part of the Report Generator chart.
22] For fields that have a field type of number, you will be given a choice of which operation to apply to the numbers in that field. Choose the applicable operation from the Operation? dropdown menu. The operation must be set for all metric-based field types (i.e., number, decimal, percent, currency).
23] To remove an unwanted field, click the trash can icon on the far right.
24] Choose which field to use as the date from the Date field dropdown menu.
25] Choose which field to use for client assignment from the Assignment dropdown menu. Typically this is the Campaign name or Client name.
26] Choose one or more unique fields from the Unique Fields dropdown menu. If you're not sure how to choose unique fields, see this article.
27] You can remove a unique field by clicking the x in the upper-right corner.
28] If you have a currency field and would like to use it for a margin rule, select it from the Use for margin dropdown menu.
29] From the Load sample data? dropdown menu, choose Yes. This is recommended if you'd like to use your sample file in your reporting.
30] If your data has footer rows you want TapClicks to ignore, enter the number of footer rows to skip in the # Footer rows to skip field.
Notifications
31] Enter your email in the Email field to receive confirmation and service alert emails.
32] Slide the Email Errors and Warnings Only slider to the on position to only receive those types of alerts.
SmartConnector™ Sublevels
You may have the option to set up sublevels in your SmartConnector™. To learn more about sublevels, see this article.
Advanced Fetch Settings
| Note: By default, every day data from the previous three days is fetched from the source. If this works for you, do nothing. But if you want to fetch more or less than three days, you can do so. However, if you're not sure, avoid making a change as it can have a significant impact on performance. |
33] To optionally change the number of fetch history days, enter the number of days (1–30) in the Fetch History field.
34] To optionally add a delay to your fetching, enter the number of minutes (720 max) to delay each fetch in the Fetch Delay field.
35] At the bottom of the page, click the Save Changes button.