RevenueWire Tutorial Center

Product XML Feed

Introduction

The Product XML Feed is a simple and effective solution for affiliates to access ongoing, up-to-date product information including image assets, pricing information and affiliated links.

The Product XML feed is easy-to-use and incredibly useful to your campaigns. By manipulating the URL query string with various parameters, you can get faster access to the specific product information you want and filter out any information that’s outside the scope of your objectives.

The Product XML feed is available at the following URL:

https://affiliate.revenuewire.com/products/xmlfeed/getFeed?affiliate={YourAffID}

Note: {YourAffID} must be replaced by your RW affiliate ID in order to use the feed.

Parameters

You can use the XML Feed by adding parameters to the URL’s query string. The query parameters ‘narrow down’ the feed’s search results in order to display the information you’ve selected.

For example, if you wanted the feed to display only the product information for ParetoLogic products, all you would have to do is append the URL with the command “&merchant=paretologic”.

If you’re only selling ParetoLogic’s RegCure product, you could further append the URL with &merchant=paretologic&product=regcure.

Note: When using the Product XML feed, the ‘affiliate’ parameter is required and must exist in all requests. If the ‘affiliate’ parameter is not passed through the query string, the feed will return an error.

Here is a full list of the Product XML Feed query parameters available to you:

Paramater	Description	Required?
affiliate	The ID (human readable) of the affiliate requesting the feed. This parameter is checked against the database and will throw an error if the affiliate does not exist.	Yes
merchant	This parameter will tell the XML Feed to only display active products belonging to the requested merchant.	No
product	This parameter will tell the XML Feed to only display a single product matching the request Product ID (FID).	No

XML Field Definitions

Field	Section	Type	Length	Description
merchant	merchant	Container	-	This container holds details specific to a merchant account
id	merchant	String	15	The human-readable merchant identifier
name	merchant	String	100	The merchant's company name
supportEmail	merchant	String	255	The merchant's customer support email
supportPhone	merchant	String	255	The merchant's customer support telephone number
supportUrl	merchant	String	255	The merchant's customer support website/web interface
product	merchant	Container	-	This container holds details specific to a product
id	product	String	30	The human-readable product identifier
name	product	String	255	The name of the product
customerDescription	product	String	64000	The customer-facing description of the product
category	product	String	30	The category this product fits into. For example: 'Registries', 'Disk Utilities', 'Drivers'
dateAdded	product	String	9	The date the product was added to the RevenueWire network.
prices	product	Container	-	This container holds the prices for each enabled currency.
	product > prices	String	Float: 6,2	The price of this enabled currency. The XML entity will be named as the 3-digit currency code this prices is represented by. For example, $29.95 US Dollars will be shown as $29.95.
commission	product	String	4	The affiliate commission offered by the merchant, displayed in percentage. Example: '75%'
details	product	String	255	The description, specific to affiliates. This is where the merchant describes the affiliate incentives for selling this product.
downloadUrl	product	String	255	The download link to the trial version of the product. This link tracks affiliation to a specific customer
assets	product	Container	-	This container holds assets for this product. Assets can include marketing materials, landing pages, box shots and sales graphics.
landingPage	product > assets	Container	-	A container for landing page- specific details. This entity will be created multiple times for multiple landing pages.
url	product > assets > landingPage	String	255	The URL for the landing page.
salesGraphic	product > assets	Container	-	A container for sales graphics. This entity will be created multiple times for multiple sales graphics.
url	product > assets > salesGraphic	String	255	The URL for the sales graphic.
boxShot	product > assets	Container	-	A container for box shot graphics. This entity will be created multiple times for multiple box shots.
url	product > assets > boxShot	String	255	The URL for the box shot.

Sample XML Output

This is a sample of the XML returned by a request to the Product XML Feed. In a sample environment, the feed below would be accessed using: https://affiliate.revenuewire.com/products/xmlfeed/getFeed?affiliate=affiliateid&merchant=testmerchant

Note:

With each available merchant, a new ‘merchant’ section will be added to the XML.
With each available product, a new ‘product’ section will be added to the XML.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

<?xml version="1.0" encoding="UTF-8"?>
<catalog>
<merchant>
<id>testmerchant</id>
<name>Test Merchant</name>
<supportEmail>help@example.com</supportEmail>
<supportPhone>1-250-555-1212</supportPhone>
<supportUrl>http://www.example.com/</supportUrl>
<product>
<id>testregproduct</id>
<name>Test Product</name>
<customerDescription>This is the customer facing description</customerDescription>
<category>Registries</category>
<dateAdded>17-Jul-10</dateAdded>
<prices>
<USD>$34.95</USD>
<CAD>$33.70</CAD>
<GBP>?21.70</GBP>
</prices>
<comission>75%</comission>
<details>This is the affiliate facing description</details>

<downloadUrl>http://affiliateid.testmerchant.revenuewire.net/testregproduct/downl oad</downloadUrl>

<registrationUrl>http://affiliateid.testmerchant.revenuewire.net/testregproduct/regi ster</registrationUrl>
<assets>
<landingPage>

<url>http://affiliateid.testmerchant.revenuewire.net/testregproduct/landingpage1< /url>
</landingPage>
<landingPage>

<url>http://affiliateid.testmerchant.revenuewire.net/testregproduct/landingpage2< /url>
</landingPage>
<salesGraphic>

<url>https://affiliate.revenuewire.com/media/testmerchant/graphics/1- 1.jpg</url>
</salesGraphic>
<salesGraphic>

<url>https://affiliate.revenuewire.com/media/testmerchant/graphics/1- 2.jpg</url>
</salesGraphic>
<boxShot>

<url>https://affiliate.revenuewire.com/media/testmerchant/catalog/1- box.jpg</url>
</boxShot>
</assets>
</product>
<product>
<id>testdriverproduct</id>
<name>Test Driver Product</name>
<customerDescription/>
<category>Drivers</category>
<dateAdded>11-Jan-10</dateAdded>
<prices>
<USD>$29.97</USD>
<CAD>$33.97</CAD>
<EUR>€29.97</EUR>
<GBP>£19.97</GBP>
<AUD>$0.00</AUD>
</prices>
<comission>60%</comission>
<details>This is the affiliate facing description</details>

<downloadUrl>http://affiliateid.testmerchant.revenuewire.net/testdriverproduct/do wnload</downloadUrl>

<registrationUrl>http://affiliateid.testmerchant.revenuewire.net/testdriverproduct/r egister</registrationUrl>
<assets>
<landingPage>

<url>http://affiliateid.testmerchant.revenuewire.net/testdriverproduct/customlandin gpage1</url>
</landingPage>
<boxShot>

<url>https://affiliate.revenuewire.com/media/testmerchant/catalog/2279- box.jpg</url>
</boxShot>
</assets>
</product>
</merchant>
</catalog>

For Further information or inquiries, please contact your affiliate manager or send an email to affiliates@revenuewire.com.