Overview - CNET Content Solutions

CNET Content Solutions : Logo Service Integration Guide - Windows 7
This page last changed on Oct 19, 2009 by jglasser@cnet.com.
• Overview
• ° Logo Service Overview
• How It Works
• ° Features
° - Expandable Hover Content
- Windows 7 and Vista Logos
- - Windows 7 Logo Styles
- Windows 7 Logo Localization
- Windows 7 Hover Content
- Windows Vista Logos
- - Windows Vista Logo Styles
- Windows Vista Logo Localization
• Getting Started
• ° Requirements
° Logo Service Subscription
° Logo Service Implementation
° - Logo Container Code
- - Query Parameters
- Requesting by CNET DataSource Product ID
- Requesting by Manufacturer Name and Manufacturer Part Number
- Specifying Language/Locale
- Specifying Logo Layout
- locationId Parameter
• Contacting Support
Overview
This integration guide provides a brief overview as well as detailed and technical information about:
• How the Windows 7 Logo Service works.
• How to implement the Windows 7 Logo Service into the product pages on your website.
Logo Service Overview
CNET Content Solutions now offers a dynamic
logo service which is designed to automatically
display logos, including expandable logos that
offer relevant products, based on product
compatibility with manufacturer programs. The
Logo Service takes the guess work out of having
to determine whether a product is compatible
with other manufacturer products. If the product
is compatible with supported manufacturer
programs, the Logo Service will serve all the
compatible logos dynamically in a product
overview or landing page and link the logos to
additional content such as product promotions,
offerings, product tours or videos.
Document generated by Confluence on Oct 21, 2009 07:39 Page 1

How It Works
1. CNET Content Solutions collect lists of products that are compatible or certified for active
Manufacturer programs.
2. CNET Content Solutions provides all the product mapping for catalog coverage.
3. You embed a JavaScript Code Snippet in your product page on your website.
4. When your customer such as an online shopper views a product page on your website, the
JavaScript sends a real-time request for available logos and additional hover content by sending
either the product's manufacturer name and manufacturer part number or CNET DataSource Product
ID.
5. Logo Service performs a look up of enabled logo programs for your account that are compatible with
the product.
6. Logo Service then returns a localized stream of logos and hidden associated hover content on your
product page. If no logos are compatible with the product, the logo service will not return any
content.
7. Upon hover of the logo, the hidden content is displayed.
8. Upon clicking of the product offering, logo service takes the user either to your product offer page or
adds the offer to the cart.
Features
• Low Maintenance implementation allows you to receive upgrades, additional features and increased
product coverage without code changes on your website.
• Allows you to choose your logo size and style dynamically.
• Multi-lingual and localization support.
• Performance Tracking
• Manufacturer Mapping - Supports variations of Manufacturer names such as HP vs Hewlett Packard.
• Customizable hover content based on your preferences such as branding, appearance and behavior
to match your website. (Optional)
• Microsoft Windows® 7 and Vista® Logos -
Determines if the product is Windows® 7
compatible, Certified for Windows Vista or
Works With Windows Vista.
Expandable Hover Content
Each available logo comes with expandable hover content:
Document generated by Confluence on Oct 21, 2009 07:39 Page 2

Please note that certain manufacturers may have restrictions or minimal requirements to
display content on your website and this content can change at any time.
Windows 7 and Vista Logos
The Windows 7 Logo Program is an evolution of the Windows Vista Logo Program but simplified where
hardware devices and software now has one logo, Compatible with Windows 7, focused on ensuring that
applications and devices are compatible and reliable with Windows 7.
The Windows 7 and Vista Logos are multi-tiered and will return only 1 Windows logo based on the levels
of compatibility. For example, the logos will be returned in the following order:
1. If a product is Compatible with Windows 7, "Compatible with Windows 7" logo will be shown.
2. Else if a product is not compatible with Windows 7 but is Certified for Windows Vista, the "Certified
for Windows Vista" logo will be shown.
3. Else if a product "Work With" Windows Vista, the "Works with Windows Vista" logo will be shown.
Download Microsoft Windows Logo License Agreement * Requires IE6 or higher
• May require Microsoft Partner Program Sign-up or Login
Windows 7 Logo Styles
Style ID Logo Style Description Example
1 base 60x72
Windows 7 Logo Localization
The Microsoft Windows 7 Logo Service currently supports the languages listed below. The language can
be specified by using a locale code in the data request.
Locale Code Language Example Locale Code Language Example
Document generated by Confluence on Oct 21, 2009 07:39 Page 3

en English it Italian
fr French pt Portuguese
de German ru Russian
es Spanish uk Ukranian
zh
Simplified
Chinese
Windows 7 Hover Content
The default Windows 7 hover will provide an overview about the Compatible for Windows 7 Logo
Program. The Windows 7 hover is currently available for English only.
Document generated by Confluence on Oct 21, 2009 07:39 Page 4

Windows Vista Logos
Microsoft has established minimum size requirements for the logos when they are displayed online.
The "Certified for Windows Vista" logo must be a minimum of 60 pixels wide and 87 pixels tall (60x87).
The "Works with Windows Vista" logo must be a minimum of 72 pixels wide and 32 pixels tall (72x32).
Images may be displayed in a larger format, but they must at least be these minimum sizes. CNET
Content Solutions provides both logos in the minimum sizes required as well as larger sizes.
In addition, Microsoft has also established spacing requirements that must exist between the logo and
any other element on the web page. For the "Certified for Windows Vista" logos, the spacing must be at
least 1/4 of the width of the logo. At 60x87, this is 15 pixels on every side. For the "Works with Windows
Vista" logos, the spacing must be at least 1/6 of the width of the logo. At 72x32, this is 12 pixels on
every side.
Windows Vista Logo Styles
Style ID Logo Style Description Example
1 base (60x87 for the Certified
logo or 72x32 for the
"Works With" logo) The
base size is the logo
image in Microsoft's
minimum size.
Windows Vista Logo Localization
The Microsoft Windows Vista Logo Service currently supports four languages (English, French, German,
and Spanish). The language can be specified by using a locale code in the data request.
Locale Code Language Example
en
English
fr
French
Document generated by Confluence on Oct 21, 2009 07:39 Page 5

de
German
es
Spanish
Getting Started
Requirements
You will need the following in order to begin using the Logo Service:
• A valid subscription to the Logo Service
• A Customer ID enabled for at least one logo program (Windows 7 and Windows Vista, etc)
• To display additional or customized content within the hover unit, you will need to provide us with
the content so that we can updated your account preferences.
• Your logo preferences (as described later in this guide).
• Your hover content preferences.
• Access and permissions to make changes to your website product pages.
Logo Service Subscription
To subscribe to the Logo Service, please contact your CNET Sales Representative or contact Support.
When contacting your Sales Rep or Customer Support, please include which Logo Programs you would
like.
Once subscribed, you will receive a Customer ID Hash code to include within your logo requests.
Logo Service Implementation
In order to implement the Logo Service on your website, you will only need to implement 1-2 lines of
code into your product page. In order for the Logo Service to identify the product that is being queried,
you can pass the product identifiers using the following methods:
• Request by CNET DataSource Product ID
• Request by Manufacturer Name and Manufacturer Part Number
Logo Container Code
• A valid Customer ID is required. Replace "CUSTID" with your unique Customer ID.
Document generated by Confluence on Oct 21, 2009 07:39 Page 6

• We recommend placing the tag near the bottom of your product page as best practice. You
will need to keep the div tag in the location where you want the logos appear. Otherwise, you can
control the div location using CSS positioning.
Query Parameters
The script can accept a list of parameters to identify the product, customize the output, and define
preferences. See below for the standard list:
Parameter Description Examples
h
cds
mf
pn
locale
style
layout
Customer ID Hash Code.
Required.
CDS Product ID of the product
being requested.
You must either provide a CDS
Product ID or you must pass
the manufacturer name and
manufacturer part number as
described below.
See "Requesting by CNET
DataSource Product ID" for
more information.
mf = Manufacturer Name and pn
= Manufacturer Part Number of
the product being requested.
Both mf and pn must be passed
together as a pair otherwise you
must pass the cds (CDS Product
Id) parameter.
Both parameter values must be
URL encoded.
See "Requesting by
Manufacturer Name and
Manufacturer Part Number" for
more information.
2 letter ISO 639.1 language
code that should be returned.
To query against country or
market specific logo, append
an underscore and two letter
country code. Default is "en"
for English.
See "Specifying Language/
Locale" for more information.
Style ID or style names of
the logo(s) that should be
returned.
Refer to the available styles
under each logo section as they
may differ.
Logo table layout and
orientation for Logo 2.0
Container only. This parameter
is ignored when requesting
specific logos using tags.
h=a123b4ds
&cds=S1340191
&mf=Acer&pn=LX.T4706.015
locale=en
locale=de
locale=de_AT
style=1
style=base
layout=1x3
Document generated by Confluence on Oct 21, 2009 07:39 Page 7

locationId
See "Specifying Logo Layout" for
more information.
Name of the HTML/Div container
that will display the logos.
This parameter is ignored when
requesting specific logos using
tags.
locationId=ccslogos
Requesting by CNET DataSource Product ID
If you are a CNET DataSource customer and store the CNET DataSource Product ID into your local
product database, you can request the logos by passing the CDS ID. The following code will request the
logos using this method:
The value for "cds" should be replaced by the CNET DataSource Product ID.
Requesting by Manufacturer Name and Manufacturer Part Number
If you are not a CNET DataSource customer and do not have access to the CNET DataSource Product ID,
you can request the logos by passing the product's Manufacturer Name and Manufacturer Part Number.
The following code will request the logos using this method:
1. Replace "Fujifilm" with the manufacturer name of the product. The Logo Service supports
Manufacturer mapping which allows Manufacturer name variations. As an example, the following
values are valid:
• HP
• Hewlett-Packard
• Hewlett Packard
2. Replace "NC01610A" with the manufacturer part number of the product.
Please note that manufacturer names and part numbers often contain characters that
are not URL valid. These invalid characters will need to be URL-encoded for both fields.
Example:
Incorrect
&mf=Hewlett Packard&pn=12345#ABA
Correct
&mf=Hewlett%20Packard&pn=12345%23ABA or
&mf=Hewlett+Packard&pn=12345%23ABA
Specifying Language/Locale
The "locale" parameter accepts the 2 letter ISO 639.1 language code or two letter language code plus
two letter country code separated by an underscore or hyphen. A few examples are listed below:
Document generated by Confluence on Oct 21, 2009 07:39 Page 8

Locale Code
en
de
de_AT
fr
fr-FR
es
Language
English
German
German - Austria Market
French
Spanish
For a complete list of language codes, please visit the Library of Congress Representation of Codes.
• If the Logo Service does not have a logo in the requested locale, the logo will not be returned.
• If no locale parameter is specified in the URL request, the logo and content will be returned in
English (en) by default.
Specifying Logo Layout
The Logo Service supports customization of the logo layout and orientation.
&layout=COLSxROWS
The COLS signifies the number of columns and ROWS signifies the number of rows to create when
displaying the logos.
Layout
1x3
3x1
Example
This would provide 3 logos stacked on top of each
other in a vertical fashion.
This would provide 3 logos side-by-side in a
horizontal fashion.
The number of columns and rows sets the limit on the number of logos. Example: If your CNET account
is entitled to receive 5 logos but your request contains "layout=3x1", the logo service will return only 3
logos. If you do not wish to restrict the number of logos, you can specify a "0" such as "0x1" or "1x0".
Note that "0x0" is not a valid value as you must provide a value of 1 or greater for either row or column.
locationId Parameter
The "locationId" parameter specifies the name of the container that will display the logos. For example, if
you already have a div container with an id of "logos", you may change the id value to be unique:
If you change the container id, you must update the parameter in the URL:

&locationId=ccslogos" type="text/javascript">
Contacting Support
If you experience any issues or have additional questions about the Logo Service, please contact our
Customer Service group:
Online: http://cnetcontentsolutions.com/contact/techsupport.aspx
Americas/Asia Pacific
Phone: +1.877.276.5560 - select option 3, then press 2
Email: custservus@cnet.com
Europe
Phone: +41.21.943.03.77
Email: custserveu@cnet.com
Document generated by Confluence on Oct 21, 2009 07:39 Page 10