Documentation

Extraction templates

Learn about the advantages of using extraction templates

Extraction template is a feature that allows you to simplify the data extraction process by using the predefined set of metrics/dimensions and most common settings for such metrics/dimensions.

{%docs-informer info title="Remember"%}

Your custom extraction templates are available for extraction/auto extraction. Create them once and you won't have to customize the settings again and again.

{%docs-informer-end%}

Global templates are available to all Improvado users. If you create a Custom template based on any Global template, it is available only to your team members.

  • The main advantage of Custom type templates is that all their settings are saved. Then you can use these templates to create an unlimited number of extraction orders without any configuration changes.
  • The disadvantage of Global type templates, compared to custom ones, is the following.

When using a global template for data extraction, you configure its settings only for the current extract. These settings will NOT be saved for future use. The next time you select any global template, its settings will have default values, and you will have to customize them again.

For example, the default settings of the Ads global template for Facebook connector are the following:

Setting Value
Use unified attribution setting No
Load Dynamic Fields No
Attribution Windows 7 Days Click
Historical data depth 365 days
Selected dimensions 14
Selected metrics 65

When you select the Ads global template for data extraction from Facebook, you will see exactly these settings.

How to manage your extraction templates

To enhance and simplify your experience, we've empowered you to create and update custom extraction templates directly within the Extraction flow, streamlining your workflow.

  1. The Extraction template item was removed from the left menu.
  2. The template Creation/Editing is now directly included in the Extraction flow.
  3. ~The Delete/Rename functionality from the Extraction Templates page moved to the specific extraction template Details panel (available in the 2nd step of Extraction flow).
  4. ~The Create a template button and Edit action from the 2nd step of Extraction flow moved to the toggle at the bottom of the 3rd step.

Step 2: Extraction template Renaming & Deletion

In Details panel, you can check the detailed settings of your template, including selected dimensions and metrics, as well as rename the template or delete it.

{%docs-informer info%}

You can rename or delete your template of a Custom type only.

{%docs-informer-end%}

Step 3: Extraction template Creation & Updating

  • For templates of a Global type, you have the option to create a new custom extraction template.
  • For templates of a Custom type, you can update an existing extraction template.

You will be able to reuse your new/updated template later. You will find it in the list of extraction templates in the 2nd step.

How to create an extraction template

Enable the Create Extraction template toggle to save the settings you’ve just configured as a new template or keep it disabled to apply these settings only for the current data extraction setup.

Extraction template name

By default, the template name is formed based on the following rules:

  • For an extraction template with a Prebuilt label and Global type: ```{Parent template} - Custom```.
  • For an extraction template with a Custom label and Global type: you need to enter a name for your new extraction template.

{%docs-informer info%}

The result of extraction template creation is always an extraction template with a Prebuilt label and Custom type.

{%docs-informer-end%}

Auto-extract new accounts using this Extraction template

Improvado will extract new accounts as they become available in the connected credentials if enabled. This template will replace any existing auto-extraction settings in the selected data table.

{%docs-informer info%}

The data table Auto-extract settings can be found on the Automation tab of your data table.

{%docs-informer-end%}

How to update an extraction template

The Update Extraction template allows you to apply the settings you’ve just configured for the existing extraction template. Keep the toggle disabled to use the settings you’ve just configured only for the current data extraction setup.

Step 4: Check the result

The Result extraction orders list now displays a new extraction template name that you set for a new extraction template in the 3rd step, or the Parent template name if you skipped creating a new extraction template.

Frequently asked questions

How to select the right Extraction template?

Extraction template selection depends on the specific Data source and the type of data you want to extract. Here are some steps to help you choose the appropriate Extraction template:

  1. Consider the frequency of the data you want to extract (e.g., daily, weekly, monthly).
  2. Check the Improvado Data Dictionary for the available Report types.
  3. You can also use the new Extraction templates filter by dimensions & metrics in the second step of the Data extraction setup.

If you didn’t find the needed global Extraction template, you can create a custom one:

  1. Go to this page to create a new Extraction template.
  2. Look for a parent template that matches the data class you need.
  3. Configure the extraction template settings based on your requirements, such as historical data depth or specific parameters.

You can check out a more in-depth guide here.

Can you show me the list of available Report types?

You can find an extensive overview of all common Report types by Data sources in the Improvado Data Dictionary. It includes metrics, properties, dimensions, etc.

If you didn’t find Report types you were looking for - you can create a request for a new Request type via the Service Desk.

☶ On this page
Description

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.