awoo Datafeed Specification

✨ Preface

Your datafeed (or product catalog) is an essential component of our service. It's the key to unlock a host of benefits: extracting critical features of your products, delivering customized recommendations, displaying relevant search results, and constructing a detailed affinity profile by analyzing your customers' preferences, among others. Sharing your datafeed in the correct format is important for those mentioned benefits.

🔑 Prepare File with EC Platform

Before considering to prepare your own datafeed file, if your EC website is built with those platforms, then you're almost ready to go! awoo has been integrated with those platforms to provide seamless/painless service for our customers. Check preparation method below for each EC platform, and skip rest of the guide!

🔑 Preparing File by Yourself

If you're the one who build their own website, please consider either methods to provide your datafeed file. Also see sections below for datafeed specification and example.

❗️

While utilizing CSV format

Please ensure that your CSV file is delineated by commas.

❗️

While delivering datafeed file through FTP/SFTP

Please notice that we'll only retrieve files from the address and update with the latest file (we won't search into subdirectories.) After reading the file, no further actions will be taken, and file will not be deleted.

👍

If you have multiple files

You can bundle multiple files into a .zip file and provide through URL/FTP/SFTP.

📜 Datafeed Specification

As you're the one who has to prepare their own datafeed file (either in XML or CSV,) having your datafeed in correct format is the essential steps to reap the functionality of awoo AMP. Please read the following section attentively while preparing your datafeed. Let's go through the schema first, then we'll introduce format, sample value, and awoo AMP usage for each field.

🚧

Case sensitive!

One must notice that each element name in XML or column name in CSV has to be case consistent with our datafeed schema. Any mismatch will lead to error and misalignment while integrating with awoo AMP.

📘

Swipe the following table to the far right -->

Also see how each field is related to the functionalities of awoo AMP.

Detailed Field Specifications

<?xml version="1.0"?>
<rss xmlns:g="http://base.google.com/ns/1.0" xmlns:a="http://www.awoo.org/ns/1.0" version="2.0">
<channel>
<title>example x nununi</title>
<link>https://www.example.com</link>
<description>example product feed</description>


<item>
	<g:id>id00001</g:id>
	<g:title>id00001 Product page's title</g:title>
	<g:description>id00001 Product page's description</g:description>
	<g:link>https:/example.com/product/id00001</g:link>
	<g:image_link>http://lorempixel.com/200/200/fashion/1</g:image_link>
	<g:availability>in stock</g:availability>
	<g:price>240 TWD</g:price>
	<g:sale_price>99 TWD</g:sale_price>
	<g:brand>brand 99</g:brand>
	<g:product_type>Home > Dresses > Maxi Dresses</g:product_type>
	<g:attributes>
		<g:attribute>dimension:spec1|spec2|spec3</g:attribute>
		<g:attribute>dimension2:spec1|spec2</g:attribute>
		<g:attribute>gender:male</g:attribute>
		<g:attribute>color:black|gold</g:attribute>
		<g:attribute>feature:swimming|scuba diving</g:attribute>
	</g:attributes> 
	<a:item_sort_volume>
		<a:popularity>99</a:popularity>
		<a:favorite>99</a:favorite>
		<a:sales_volume>99</a:sales_volume>
		<a:rating>5</a:rating>
		<a:reviewCount>99</a:reviewCount>
	</a:item_sort_volume>
</item>

</channel>
</rss>

Edited by: Justin Sung