wishads affiliate tools

WishAds for Zazzle - Release Notes

10/30/08 - Initial release

This is the initial release date for WishAds for Zazzle. The creation of ads for this release can be accomplished through our ad tool. The following settings control the contents of the ad, which ideally is contained within an iframe.

With the additional feedback from users, we expect several additional features to be released soon.

parameter description example default value notes

rf Zazzle referral id rf=238363208708474223 238363208708474223 This default value is our referral id

qs search query qs=cancer awareness funny This default value is subject to change

pt product type
pt=235

0

"pt=0" returns random products.

At the time of this release, the zazzle api does not support multiple product types in the feed request. For example, "pt=235,168" would not return shirts and mugs. I will return all random products as if the request were "pt=0"

ret Number of products to load in the ad
ret=50

15
WishAds caches each ad request daily and stores 50 results on our server for that day. The ad is also shown in an iframe. Therefore, it should not have any significant performance issues if you load 5 or 50 products into your ad. The limit is 50.

visible Number of products to display visible=5 4 "visible=5" creates an ad with 5 products displayed. Adding the "ret=15" would mean the customer could scroll to see 10 more products before reaching the end.

target target frame of the link target=_blank _parent The ad is displayed in an iframe named "wishads". The default setting will replace your current page with the link to zazzle. "target=_blank" will open the ad in a new window. "target=_self" should not be used, as that would load the zazzle page into the small iframe replacing the wishad.

size size of the thumbnail size=medium small
The three options return various sizes of the product thumbnails. "size=small" returns a 92x92 thumbnail. "size=medium" returns a 152x152 thumbnail. "size=large" returns a 210x210 thumbnail. We currently do not support the "huge" size of 328x328.

st sort type st=date_created popularity "st=popularity" will return the most popular products according to zazzle. "st=date_created" will return the most recent products.

parameter description example default value notes

sp sort period sp=1 0 "sp=0" sorts the above field of "st" over the entire life of zazzle. 1 = today, 7 = this week, 30 = this month. Use "qs=holiday&st=popularity&sp=7" to show an ad returning the most popular holiday products this past week.

pagebg iframe page background color pagebg=999999 ffffff Use this parameter to match the iframe background color to your page background color or ad wrapper color so it appears to be part of the page or ad wrapper. Note that the leading "#" is not used. Currently only hexadecimal colors are allowed. "pagebg=blue" will not work.

imgborder image border color imgborder=999999 999999 This is a 1 pixel border around the image.

bg image background color bg=999999 ffffff This is the background color of the product thumbnail. A very nice feature from the folks at Zazzle.

box border color of the hover box box=999999 ffffff This is the color of the 1 pixel border around the image and the link text.

hover hover box border when moused over hover=ff0000 999999 This is the color of the 1 pixel border around the image and text link when moused over to give a visual cue to the customer.

linktext text under the thumbnail linktext=Buy Now! (empty) The default setting on this parameter is empty and will result in only thumbnails showing without text underneath. We strongly recommend some "call to action" to help clickthroughs.

linkcolor linktext color linkcolor=ffffff 000000 This is the hyperlink color for all states of the link.

orientation direction of the ad orientation=vertical horizontal "orientation=vertical" will arrange the ad so that it is a one-column ad that scrolls up and down. "orientation=horizontal" will arrange the ad so that it is a one-row ad that scrolls left and right. We have not yet perfected diagonal.

linkfont link font face linkfont=Times Roman Arial This parameter allows you to integrate the ad text into the style of your own site.

For more details on the Zazzle RSS Feeds, download the Zazzle RSS Guide - version 1.02 (pdf: 847KB)

parameter	description	example	default value	notes
rf	Zazzle referral id	rf=238363208708474223	238363208708474223	This default value is our referral id
qs	search query	qs=cancer awareness	funny	This default value is subject to change
pt	product type	pt=235	0	"pt=0" returns random products. At the time of this release, the zazzle api does not support multiple product types in the feed request. For example, "pt=235,168" would not return shirts and mugs. I will return all random products as if the request were "pt=0"
ret	Number of products to load in the ad	ret=50	15	WishAds caches each ad request daily and stores 50 results on our server for that day. The ad is also shown in an iframe. Therefore, it should not have any significant performance issues if you load 5 or 50 products into your ad. The limit is 50.
visible	Number of products to display	visible=5	4	"visible=5" creates an ad with 5 products displayed. Adding the "ret=15" would mean the customer could scroll to see 10 more products before reaching the end.
target	target frame of the link	target=_blank	_parent	The ad is displayed in an iframe named "wishads". The default setting will replace your current page with the link to zazzle. "target=_blank" will open the ad in a new window. "target=_self" should not be used, as that would load the zazzle page into the small iframe replacing the wishad.
size	size of the thumbnail	size=medium	small	The three options return various sizes of the product thumbnails. "size=small" returns a 92x92 thumbnail. "size=medium" returns a 152x152 thumbnail. "size=large" returns a 210x210 thumbnail. We currently do not support the "huge" size of 328x328.
st	sort type	st=date_created	popularity	"st=popularity" will return the most popular products according to zazzle. "st=date_created" will return the most recent products.
parameter	description	example	default value	notes
sp	sort period	sp=1	0	"sp=0" sorts the above field of "st" over the entire life of zazzle. 1 = today, 7 = this week, 30 = this month. Use "qs=holiday&st=popularity&sp=7" to show an ad returning the most popular holiday products this past week.
pagebg	iframe page background color	pagebg=999999	ffffff	Use this parameter to match the iframe background color to your page background color or ad wrapper color so it appears to be part of the page or ad wrapper. Note that the leading "#" is not used. Currently only hexadecimal colors are allowed. "pagebg=blue" will not work.
imgborder	image border color	imgborder=999999	999999	This is a 1 pixel border around the image.
bg	image background color	bg=999999	ffffff	This is the background color of the product thumbnail. A very nice feature from the folks at Zazzle.
box	border color of the hover box	box=999999	ffffff	This is the color of the 1 pixel border around the image and the link text.
hover	hover box border when moused over	hover=ff0000	999999	This is the color of the 1 pixel border around the image and text link when moused over to give a visual cue to the customer.
linktext	text under the thumbnail	linktext=Buy Now!	(empty)	The default setting on this parameter is empty and will result in only thumbnails showing without text underneath. We strongly recommend some "call to action" to help clickthroughs.
linkcolor	linktext color	linkcolor=ffffff	000000	This is the hyperlink color for all states of the link.
orientation	direction of the ad	orientation=vertical	horizontal	"orientation=vertical" will arrange the ad so that it is a one-column ad that scrolls up and down. "orientation=horizontal" will arrange the ad so that it is a one-row ad that scrolls left and right. We have not yet perfected diagonal.
linkfont	link font face	linkfont=Times Roman	Arial	This parameter allows you to integrate the ad text into the style of your own site.