Documentation

Set up data extraction

Learn how you can set up data extraction in four steps

You can set up the data extraction in two ways:

  • Click on the Extract for the required connection in the connected sources list. If you don’t see the necessary connector in the list, click the Make a new connection button to add it first.
  • Click the Extract button on the top right corner of the connection page.

This instruction will help you to set up data extraction in four steps:

  1. Select Accounts
  2. Choose Extraction Templates
  3. Configure Extraction Template
  4. Check the result

Step 1. Select Accounts 

You can see all available accounts and their IDs on the left side of the screen and the list of selected accounts on the right. The number in the orange circle shows how many accounts you have chosen.

Also, you can sort them by ascending or descending date added and use the search field to find the necessary account by its name or ID.

The Date added column shows when each account was added to Improvado.

  • e.g., when you connect a Business Account to Improvado, it has only two related accounts (in this case, the date added for Business Account and two corresponding accounts will be the same).
  • Then you have created one more account inside the Business Account via the connected platform. It is added to Improvado automatically, so the date added for a new account will differ from that of other accounts.

Recently added accounts are shown first by default. That allows you to find the necessary accounts faster.

When all the necessary accounts are selected, click the Continue button. This button is non-clickable while the selected accounts list is empty.

Selecting more than 10 accounts for extraction

If the list contains more than ten items, pagination settings will appear at the bottom of this list. Using the checkbox in the list header, you can select all accounts on this page. To select more accounts, you can move between pages. Marked checkboxes are saved when moving.

To select more than 10 accounts for extraction, follow the steps from the image below:

Step 2. Choose Extraction Templates

This step is similar to the previous. You can see all available templates, their labels and types on the left side of the screen and the selected templates on the right. The number in the orange circle shows how many templates you have selected.

You can use type filter to see only global or custom templates and label filter to find the most popular extraction templates. Also, you can sort the data ascending or descending and use the search field to find the necessary template.

Suppose you know the fields you want to see in extracted data. In that case, you can find the relevant global and custom extraction templates by properties/dimensions Field Name from Improvado Data Dictionary without leaving the extraction flow using the Extraction Template filter.

The filter works according to the AND logic. It means that the result extraction templates include all selected fields:

  • Field_1 AND Field_2 AND etc.

Click on the Details to clarify the settings of a particular template. If you don’t have the necessary template, you can edit an existing one (only for custom templates) or click the Create a template button to a new one.

It is important to remember that you can not select all templates together. It depends on which global extraction template they are based on.

You can not select more than one template based on the same global extraction template. This restriction applies to both global and custom templates. 

After selecting all the necessary templates, click the Continue button to move to the next step.

{%docs-informer info%}

This button can be non-clickable in two cases:

  • while the Selected templates list is empty
  • if the resulting number of extraction orders exceeds 1000, you will see the following pop-up note: "The number of the selected orders cannot exceed 1000. You have enabled N orders for extraction".

Description:

Each account + extraction template pair will correspond to the extraction order. It means that there will be only one extraction order with one template and one account.

Let's say the total extraction orders number equals m*n where

  • m is accounts number
  • n is templates number

If m*n ≤ 1000 - the Continue button is clickable.

If m*n > 1000 - the Continue button is disabled.

{%docs-informer-end%}

Step 3. Configure Extraction Template

Now you need to configure each selected template. You will see the sequential number of the current template on the left side of the page.

Extraction Template settings

  • Custom settings (depend on the data source)
  • Sync historical data (mandatory for filling in)

You need to select the first date of the historical data interval. The maximum historical data depth varies due to the API specifics of different data sources. If customer needs historical data depth over the preset maximum value, it is necessary to raise a request via Improvado Service Desk. Our team will check if it is technically possible.

Note that you will be able to change it later by editing the extraction order configuration on the Settings tab.

Scheduling settings

Here you can set the frequency of data extraction by changing the scheduling settings and adding or deleting schedules.

One schedule is always created by default. You can add one or several more by clicking Add Schedule on the top right corner of this section. If this is not available, it means you have reached your limit. The contract determines the limit. To increase it, please get in touch with your Customer Success Manager.

Also, can delete the schedule by clicking the “trash bin” icon, but it is impossible to delete a schedule if it is the only one.

The schedule has three fields:

  • Extraction period allows you to set how often Improvado attempt to load your data to Improvado database.
  • Extraction time determines the exact time for the Improvado extraction schedule.
  • Extraction time zone determines the time zone for this extraction schedule.
  • Lookback window is the period before data extraction, for which data is extracted regularly.

Extraction period

Now you can schedule data extraction daily, weekly (by selecting the day of the week), and monthly (by choosing a day of the month).

Lookback window

The first schedule will always have a default lookback window: 

  • in days for daily extraction template
  • in weeks for weekly extraction template
  • in months for monthly extraction template

IMPORTANT: no lookback window for last day and last day (inc) extraction templates.

Previously the subsequent schedules had a Live lookback window. Now we’ve added the possibility to choose the max lookback window option.

IMPORTANT: if you have selected two or more global templates, the schedule settings of the first one will be applied to the following global templates, and then you can change them sequentially. This will not affect the custom templates settings.

Dimensions and metrics

Available dimensions and metrics are presented in lists similar to accounts and templates and work in the same manner.

Some dimensions and metrics are selected by default. You can not deselect them because they define the data table structure.

After selecting all necessary items, click the Continue button. If there are any more extraction templates to be configured, they will appear on the screen one after another.

If all extraction templates are configured, let’s move to the last step and check the result.

Step 4. Check the result

This is the last step before the data extraction starts. Here you see the list of extraction orders you’ve configured on previous steps. It includes the following:

  • Extraction order name
  • ~It is formed by the Data Source — Extraction Template — Account rule
  • Data Table name
  • ~This name is formed by Data Source — Extraction Template rule
  • ~Only one data table will be created for all accounts based on the same extraction templates
  • Account Name
  • Extraction Template Name

Check the resulting extraction orders carefully. If you notice that some order was added to this list by mistake, deselect it. Only selected extraction orders will be set up. Click the Continue button to finish the extraction configuration process.

Conflicted extraction orders (optional)

A conflicted extraction orders list will appear after step 4 if you are trying to set up any existing extraction order. All existing orders will not be duplicated.

Two resolution actions are available:

  1. You can skip the conflicting orders.
  2. You can update an existing extraction order with new extraction settings. Historical data will not be updated!

Updated extraction orders and new ones will be displayed at the beginning of the extraction orders list. But unlike the new ones, the synch process will not be launched automatically for updated orders.

No items found.

Questions?

Improvado team is always happy to help with any other questions you might have! Send us an email.

Contact your Customer Success Manager or raise a request in Improvado Service Desk.