Skip to main content

Map your product data

An overview on preparing product data for export to external channels via the Productsup Dataflow.

Introduction

Export channels only accept product data that match their specifications. In Dataflow, you can map attributes derived from imported data to meet these requirements.

By default, most of your data's attributes automatically map to an export after you set one up. You can also map your product data manually via a drag-and-drop interface between the three stages in Dataflow. These stages are:

  • Import: Contains attributes based on your import source.

  • Intermediate: Contains the most common attributes found on a range of external exports.

  • Export: Contains attributes specific to one export.

Meaning of the attribute colors:

  • Mandatory attributes on the export stage are blue and optional attributes are light grey.

    Mandatory attributes
  • Custom attributes created on the intermediate or export stage are grey-white striped.

    custom_attribute.png

Meaning of the attributes icons on the import stage:

  • The connection icon connection_icon_in_attribute_in_Dataflow.png indicates that the attribute appeared as a result of applying one of our data services.

  • The three dots icon (...) shows that the attribute comes from an additional data source. Hover over it to see the exact import file it comes from.

  • The red warning icon exclamation_sign_icon_in_attributes_in_Dataflow.png indicates that the connected attribute is missing from the import or that a required attribute input for a rule box is absent.

  • The flag icon flag_icon_in_attribite_in_Dataflow.png indicates the site's product ID attribute selected in Data Sources.

This document covers the basics of attribute mapping. See Organize your Dataflow columns and attributes for more details.

Prerequisites

Before you can map attributes and export your data, you must complete the following steps:

  1. Set up a site.

  2. Set up and run a product import in Data Sources.

  3. Set up at least one export in Exports.

Map import data attributes for export

The following example demonstrates how to map imported product data to Google Merchant Center.

  1. Go to Dataflow or Data View from your site's main menu.

  2. Select which export channel you want to export to; this example uses Google Merchant Center.

    Productsup platform Dataflow view - demonstrating export channel selection
  3. To map Import attributes to Intermediate attributes:

    • In Import, select a node on an attribute.

    • In Intermediate, select a node on an attribute.

    Guide to mapping product attributes to intermediate layer
  4. Map intermediate attributes to export, following the same steps noted in step 3.

    Guide to map intermediate attributes to export attributes

Tip

Alternatively, you can map an attribute to another by placing your cursor over an attribute's node, holding the mouse button down, and dragging a guideline that appears to the second attribute.

Export your data

There are two ways to export data in Dataflow. If you want to initiate a complete data flow process, from import to export to all channels:

  • Select the Run button.

    dataflow-run_button.png

If you want to export current imported data to all exports:

  • Select the Export button.

    dataflow-export_button.png

If you want to export existing data to only one export:

  1. Go to Exports from your site's main menu.

  2. Select the Export button for a specific export.

    Exporting product data for specific channels via Exports.

Delete attribute maps

You can delete connections between import and intermediate attributes as follows:

  1. Rest your cursor over the guideline connecting the attributes.

  2. Select the guideline.

  3. Select Yes from the pop-up menu.

    Deleting connections between columns in Dataflow view

Create new attributes

To add new attributes in the intermediate and export stages:

  1. Scroll to the bottom of the stage to add a new field and select Drop or Click to add new attribute.

  2. In the pop-up, enter a name for the attribute.

  3. Select Save, and this attribute is now available for mapping.

Creating custom attributes
Creating custom attribute and save

You may use custom attributes for non-standard cases. For example, you need to skip for the export all products that relate to the winter season, such as coats, sweaters, and scarves.

You can use one of the rule boxes, such as Skip row if value in for the attribute containing the season information, but don't want the attribute appear in the exported data. You can't add a rule box between import and intermediate stages, as this will affect all exports, and you need to skip the products only from one particular export.

To achieve the result, do the following:

  1. Create a new custom attribute on the export level with three underscores (___) in front of the attribute's name, such as ___season.

  2. Connect ___season with the attribute containing the season data in the intermediate stage.

  3. Add a rule box that excludes products, such as Skip row if value in to the ___season attribute. See Skip Row If Value In.

The platform applies the rule box to the values and excludes the corresponding products from the export. The platform doesn't export the ___season attribute.

Delete custom attributes

To delete any attributes you previously created:

  1. Rest your cursor over the attribute.

  2. Select the Delete_custom_attribute_icon.png icon.

    Deleting custom attributes
  3. Confirm you want to delete this attribute by selecting Delete.

Map attributes across multiple sites in bulk

If you need to create connections between the same attributes in multiple sites, you can use the Bulk Option feature to save time.

Note

You must have the same attribute names across the sites where you want to use a bulk action that adds a connection in Dataflow.

  1. Go to the organization or the project level and select Bulk Option.

    Bulk Option button at the account level
  2. Choose the sites where you want to create connections and select Next Step.

  3. Choose Add Dataflow Connection and select Next Step.

  4. In the Dataflow drop-down list, choose whether the platform should add connections between the import and intermediate stages or the intermediate and export stages.

    If you select Intermediate - Export, you need to additionally choose a relevant export in the Export drop-down list.

    Defining Bulk Operation behavior 3.1
  5. Enter the names of the attributes you want to map. A list with all available attributes appears as you type.

    • If you chose Import - Intermediate, enter the name of the import-stage attribute in Source column and the name of the intermediate-stage attribute in Intermediate Column.

    • If you chose Intermediate - Export, enter the name of the intermediate-stage attribute in Intermediate Column and the name of the export-stage attribute in Export Column.

  6. Select Execute.

  7. A final confirmation screen shows whether the bulk action was successful.

    You can leave this screen by selecting Return to organization page. You can also go to one of the sites where you performed the changes by selecting the name of the needed site.

    Defining Bulk Operation behavior 4