This article will guide you step by step through uploading a Product Feed, so you can easily import your product data into the Crescendo Lab platform.

After you create and sync your Product Feed, you can use the following features:

Use cart retargeting in MAAC
Use product recommendation messages in MAAC
Use AI product recommendations in CAAC (Coming soon)

These features use the product information in your Product Feed to help you deliver more accurate and personalized messages to your customers.

# Go to the Product Feed settings page

⚠️ If you can’t find the Product Feed module in Admin Center, it means this feature hasn’t been enabled yet. Please contact Crescendo Lab Customer Success to help you enable it.

From MAAC: Marketplace → Admin Center → App Center → Product Feed

From CAAC: Settings → App Center → Product Feed

# Create a new Product Feed

In Admin Center, you can create a Product Feed in two ways:

Upload a file (File Upload)
Set up a Product Feed URL (Feed URL Integration) for automatic syncing

1. Upload a file (File Upload)

Step 1: Click “Add Product Feed” in the top-right corner of the Product Feed page

Step 2: Select “Upload Product Feed” and enter the required information

Enter a name for this Product Feed, so you can manage it later
Click the upload area (dashed box) or drag and drop your file. Supported formats: CSV, XML, TSV

⚠️ Before uploading, please make sure your CSV / XML / TSV file includes the required fields and is encoded in UTF-8. Below are the required Product Feed fields.

Field	Description	Notes	Example
product_id (Required)	A unique identifier for the product	At least one identifier is required. Must be unique (no duplicates).	CL-2025-000
title (Required)	Product name	Used for display and search results	Limited Edition Nut Gift Box
description (Required)	Product description	Used for search and recommendation content	A curated mix of selected nuts
link (Required)	Product page URL	Customers will be directed to this page when they click
image_link (Required)	Main product image URL	PNG / JPG / JPEG are supported
price (Required)	Product price	Must include a number and a 3-letter currency code (ISO 4217)	980 TWD
availability	Inventory status	in stock / out of stock / preorder	in stock
brand	Brand name		Crescendo Lab
product_type / fb_product_category / google_product_category (One required)	Product category	Fill in any one of the three	Food > Snacks > Nuts

Here is a sample import file template for your reference:

Step 3: Click Upload. The system will then display the upload result.

For how to read the upload result, please refer to “Product Feed status and error messages”.

2. Set up a Product Feed URL (Feed URL Integration)

If your e-commerce platform or internal system can provide a fixed URL for product data, we recommend using this method so your data can sync automatically every day—no need to upload files repeatedly.

Common use cases:

Your e-commerce platform provides a product feed (e.g., 91APP, Cyberbiz, Shopline, Shopify)
Your store backend periodically generates a CSV/XML feed link
Generate a CSV URL from Google Sheets

Step 1: Click “Add Product Feed” in the top-right corner of the Product Feed page

Step 2: Click “Set Product Feed URL” in the top-right corner and enter the required information

Enter a name for this Product Feed, so you can manage it later
In the “Product Feed URL” section, enter the URL to your product data. Supported formats: CSV, XML
Set the sync frequency: currently, only “Daily” is available. The system will automatically refresh the data at 01:30 (UTC+08:00) every day. If you update product data during the day and don’t want to wait until 01:30 the next day, you can use Manual Sync to update immediately.

Step 3: Click “Create Product Feed”. The system will then display the upload result.

For how to read the upload result, please refer to “Product Feed status and error messages”.

# Product Feed status and error messages

After you create a Product Feed, the system will automatically validate your data and show one of the following statuses:

Synced: All product data has been uploaded successfully
Partially successful: Some product data has issues. Please fix the problematic items and update the Product Feed
Error: All product data failed to upload. Please resolve the issues and try again

1. Product Feed status: Error

If the Product Feed status is Error, it means “all product data failed to upload.” You can click “Fix” to see the reason.

Common reasons:

The URL is not accessible
The file format is not CSV/XML/TSV
The file encoding is not UTF-8

Please fix the issue based on the message and then re-upload or update the Product Feed.

2. Product Feed status: Partially successful

Some products have data issues, but other products can still be used normally. You can click “Fix” to see the reason.

In “Catalog Check Results,” you’ll see which items need attention and the number of affected products.

Required fixes: The affected products cannot be used. Common examples include:

Missing required fields, such as Product ID, title, description, link, image_link, or price
Duplicate Product IDs

Quality warnings: The data is incomplete but won’t block usage (recommended to complete). Common examples include:

Missing optional fields, such as brand or category

3. Product Feed status: Synced

If the Product Feed status is Synced, it means “all product data was uploaded successfully.” You can click “View” to see upload details.

# How to update my product data

Depending on your needs, you can update the existing Product Feed source (file or URL) or create a new Product Feed.

⚠️ After you update product data, it may affect all related features that use this product data in MAAC and CAAC.

1. Source: File upload

To modify an existing Product Feed: remove the original file, upload the updated file, and then click “Upload.”

2. Source: Product Feed URL

If your product data source (the file behind the URL) has been updated, the system will sync automatically every day at 01:30 (UTC+08:00). If you don’t want to wait for the schedule, click Manual Sync to update immediately.
If you want to replace the Product Feed URL, update the link and then click “Update.”

# Additional: How to get Product Feed links from e-commerce platforms

Below explains how to get Product Feed links from SHOPLINE, and Shopify. Currently, this feature does not support Flaps integration.

1. SHOPLINE

Step 1: Follow the Shopline help article to set up a product catalog in Facebook first

Step 2: In Facebook Commerce Manager, go to Catalog → Data Sources → select Shopline

Step 3: Go to Settings → copy the “Scheduled feed link”

Refer to “Create a Product Feed - Link” to upload the link to Crescendo Lab.

4. Shopify

Shopify does not provide a Product Feed URL that can be directly shared publicly.

To generate a Product Feed link, we recommend installing FeedNexa Google Shopping Feed from the Shopify App Store. The app can help you generate a usable Product Feed URL.

Step 1: Configure and save your product feed

Open the FeedNexa Google Shopping Feed app
Edit the product feed settings based on your needs
When finished, click “Save”

Step 2: Get your Product Feed URL

After saving, a pop-up window will appear and show the available Product Feed links.
Copy the XML feed link. This link can be used as your Shopify Product Feed URL and uploaded to Admin Center in Crescendo Lab.

# FAQ

Q: After I update product data in my e-commerce backend, when will it sync?

If your Product Feed is created using a URL, the system will sync automatically every day at 01:30 (UTC+08:00).

If you want the data to update immediately, go to the Feed URL sync status page and click Manual Sync / Manual Refresh. The system will re-fetch the data right away—no need to wait for the next scheduled sync.

Q: What does “Partially successful” mean when uploading a Product Feed?

“Partially successful” means your Product Feed was created or updated successfully, but some products have data issues. Other products can still be used normally in MAAC and CAAC. Please refer to “Product Feed status and error messages - Partially successful”.