Documentation

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:

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 Editing

In the Details panel, you can check the detailed settings of your template, including selected dimensions and metrics.

For Custom-type templates only, you can:

• Rename the template.
• Delete the template.
• Create custom labels to organize templates for quick filtering.

How to use custom labels:

• Add: Click New label button and type a new label name in the Labels field.
• Remove from a template: Click the cross icon next to the label.
• Delete permanently: Click the bin icon beside the label name.

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.

{%docs-informer info%}

Templates containing Custom account-specific fields cannot be saved. Since these fields are unique to a single account and only available in free-form reports, such templates cannot be reused across other accounts.

{%docs-informer-end%}
‍

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.

Entity & Statistical reports

• Entity reports: An entity report describes a specific object within an account hierarchy, such as ads, campaigns, and other related entities. This report contains detailed descriptive data about these objects, including their unique identifiers and keys that link them to other entities. Additionally, it serves as a catalog of objects, offering a clear and structured reference for understanding the relationships and characteristics within the account hierarchy.
  • Because entity reports are basically a catalog of objects (or a dictionary) - they don't have date-related extraction settings (Sync historical data, Lookback window, etc.) & metrics.
• Statistical reports: A statistical report represents all metrics-related data for a specific date range. This type of report includes primary keys that link it to entities, as well as the statistical behavior of each set of dimensions and properties. It provides a comprehensive overview of performance metrics, enabling in-depth analysis and informed decision-making.

By segmenting the reports in this manner, we can deliver clearer insights and more accurate data, thereby improving overall reporting efficiency and user satisfaction.