Configure a Data Import (New Wizard)

Learn how to connect a catalog from your e-commerce or with a URL to Feeds

This article refers to the new wizard for configuring a Data Import. If your organization is still using the previous wizard, please visit this article.

The new wizard looks like this:


In this guide, we will delve into synchronizing your catalog with AMP. We present two viable options to achieve this smoothly: through integration with your e-commerce platform or using a URL.

In the following sections, we will explain both methods.

Content table

E-commerce Integrations
Synchronize Your Catalog with a URL
1.1. Set Up with URL (Initial Configuration)
1.2. Set Up with FTP or SFTP (Initial Configuration)
2. Scheduling (Updating the Data Import)
3. Field Mapping
4. Create Optimized Feeds

E-commerce Integrations

Within AMP, we offer seamless compatibility with the following e-commerce platforms:

  1. Shopify
  2. Vtex
  3. Magento
  4. Salesforce
  5. IBM Webstore (Contact Customer Success)
  6. SAP (Contact Customer Success)

To proceed, follow the instructions in the respective articles dedicated to each platform. Once completed, return to the Set Up section in this guide to continue with your process.

Synchronize Your Catalog with a URL

If you are not using an e-commerce integration and instead wish to connect your catalog via a URL, take a moment to review some points to ensure a smooth process.

If you are using a Google Spreadsheet, review this article to synchronize your catalog with AMP.

First, verify the required and optional fields for your catalog and industry, and ensure that your catalog file meets the following requirements:

  1. File Formats: Ensure your catalog is in one of the following formats: XML, CSV, or JSONL. The Feeds data import function works perfectly with these formats.
  2. Image Formats: Ensure your images are in JPG, JPEG, PNG, SVG, or WEBP format.

To further improve the catalog reading process, review the following points:

  1. Avoid Using a CDN: If your catalog is hosted on a Content Delivery Network (CDN), it is best to avoid this for this particular upload. Accessing the information directly without going through a CDN will prevent potential interferences with the reading process.
  2. Add Our User-Agent to the Whitelist: Add "feed-composer/1.0" to your server’s whitelist. This ensures that Feeds can access and read your catalog information smoothly.

Now that you have reviewed all the requirements, you can upload your catalog to Feeds and create a Data Import.

First, go to Feeds Manager, click on Data Imports, and then + New Data Import.

 

1.1. Set Up with URL (Initial Configuration)

When the Set Up window opens, we will select the option A direct link. This will open the Import products from a direct link page, where we need to define the name of the Data Import and the feed link. We must also specify whether this link is public or private and the encoding type from the available dropdown options (we recommend leaving the option "Auto Detect").

If the feed URL is private, you will also need to fill in the Username and Password fields.

After defining these details, complete the information related to the feed's location, marking the corresponding country, language, and the currency in which the prices are displayed.

Location-related fields are important if you plan to generate an international catalog later, so ensure you fill out this information correctly.

Once all fields are completed, click Next and follow the steps outlined in point 2.

1.2. Set Up with FTP or SFTP (Initial Configuration)

When the Set Up window opens, we will select the option An FTP server. This will open the Import products from an FTP server page, where we need to define the name of the Data Import and these details for your FTP or SFTP: Host, Path, File Name, Port, Username, and Password.

After defining these details, complete the information related to the feed's location, marking the corresponding country, language, and the currency in which the prices are displayed.

Location-related fields are important if you plan to generate an international catalog later, so ensure you fill out this information correctly.

Once all fields are completed, click Next and follow the steps outlined in point 2.

2. Scheduling (Updating the Data Import)

Select the frequency which you want to automatically update the catalog:

For example, if you know your catalog is generated at 8:00 AM in your e-commerce platform, you can schedule it here for 8:30 AM to ensure the catalog content processed in Feeds Manager is updated correctly. You can also choose whether you want this read to occur once a day, month, week, or at custom intervals.

If you want to set up a single upload, you can fill in the fields in the "Manual Update" section.

If needed, you can select the time zone of your catalog to always align with the markets.

Click Next to proceed to the final step: mapping the fields.

3. Field Mapping

When we load a new catalog, we need to map the product information we have in the e-commerce platform to the fields typically required by platforms.

This catalog field configuration prevents reading issues with platforms like Meta or Google.

First, you must select all the platforms you will use from the dropdown.

Don't worry if you forget to add a platform; you can add more later!

Once the platforms are selected, AMP Feeds will do an automapping process: it will detect the fields in your feed and link them to the fields required by the platforms. For those fields that are not auto-detected, you will need to select the corresponding field in your feed. Unmapped fields will appear with a gray date, as shown in the following example:

For example, if the ID field (platform) is not auto-detected with the corresponding field in your feed, you will need to select it from the dropdown. In this case, we would select Unique_ID.

Remember! You must fill out at least all the fields marked as "Required." This is essential to save your Data Import.

If you have doubts about which field in your feed corresponds to the one required by the platform, you can select it from the dropdown and click on the synchronization icon. Here you can see a preview of the first values of this field in your feed.

What if my feed field does not appear? AMP might not have detected it. In this case, you should click on the pencil icon and "Match it with an undetected field." In the dropdown that will appear, you should write the exact name of the field in your feed.

Another possibility is that you are not generating the field in your feed and do not have the information required by the platforms. In this case, you can generate a static value to fill the field. To do this, you should click on the pencil icon and "Match it with a static value." In the dropdown that will appear, you must add the value you want to show in that field (this information will be shown in all products).

Once you have mapped the first platform, you can map the rest of the platforms or add new ones. These platforms may have some information you previously completed.

A red button will appear above the platforms where you need to make modifications and map fields. Note that not all platforms require the same fields.

At the top of the page, you can select the Preview icon to review how the fields of your products are configured.

Once everything is reviewed, you can click Finish.

4. Create Optimized Feeds

Once the configuration is complete, the next step will be to create an optimized feed from scratch that will serve to run catalog campaigns on any platform.

In this new feed, we can segment the products and improve your catalog through optimizations to make them more interesting and attractive to potential customers.