Formatting Results

There are some guidelines that apply to both paid and non-paid results, and others that are more specific to paid results.


Guidelines for displaying results

Anatomy of a typical result

Paid and non-paid web results contain the following:

  • Title
  • Display URL
  • Description

Order within a result

In practice, search results perform best when presented in the order described above, rather than with the Display URL below the description.

Suggested fonts & colors

Set the base to 10 so as to make the math easier for em conversion. For example, 1.2em = 12px font. Using em measurements for fonts allow them to scale more elegantly when a user resizes the page.

Arial is the preferred font face for results.

Text Color Size Line Height Decoration & Weight
Search Query Text
(within search box)
#333 1.8em None
Related Searches #12C,
#609
(visited)
Underline on Hover
Search Result Title or
“Call-Only” Link (mobile only)
#12C 1.6em 18 Search term bold &
underline entire result
Display URL Link #093 1.3em 16 Search term bold
Engine Attribution Text #999 1.1em None
Description Text #222 1.3em 16 None
Bold search term in description #000 1.3em 16 Bold weight
Click-to-Call phone number link
(mobile only)
#12c 1.3em 16 Underline
Click-to-Call disclaimer text
(mobile only)
#999 1.1em 16 None
Seller Ratings Text #999 1.3em 16 None
Seller Ratings “Reviews” Link #12C 1.3em 16 Underline
Deep links #12C 1.2em 16 None

Ordering, numbering and bulleting

Results must be displayed in the order they are delivered in the XML group. However, results must not be numbered or bulleted.

All requested ads must be displayed. If InfoSpace returns three ads, you cannot choose to display only two of the three ads returned.

Clicks

The title, display URL and any deep links are the only clickable objects. White space surrounding the listing must not be clickable.

The <site-link> parameter value must be used as the href (or destination URL) for the Title and Display URLs they are returned with.

Clicked queries must be sent without editing, filtering, truncating, appending terms to or otherwise modifying such queries individually or in the aggregate; the site-link must not be altered to be counted as a valid click.

The IP and the user agent for the user that generated the search query must match the IP and the user agent that clicks on a result.

Link target

It is strongly recommended that the results be written (or targeted) so that when clicked, the resulting page is opened in a new browser tab or instance. This way the user is not navigating away from the list of results and can easily return to select another. Opening result pages in a new tab or browser instance has usually resulted in a higher the click thru rate, including paid responses. For example:

<a target="_blank" href="">link text</a>

Spacing

Spacing between results of the same type (e.g. between two non-paid results) should be anywhere from 14px to 24px vertical space.

Bolding

When sending a query the ‘bold’ feature is on by default, to bold the query words in the returned text. This can help the user to find relevant sections in the description and decide if the response is what they are looking for. Similarly descriptions that do not contain the search query words may not be as strong of a choice.

Paid results & features

Attribution

Paid results must be accompanied by attribution. If this has been done with region-level attribution, then no result-level attribution is needed.

However, result-level attribution still requires that the paid results must be in visually distinct region, separated from non-paid results. This may be achieved by background shading of the paid result area. See region-level attribution for sample shading colors.

Ads using result-level attribution must be labeled as sponsored using one of the approved formats, for example:

  • www.displayURL.com • Sponsored: Ads by Google
  • Sponsored: www.displayURL.com

Completeness

The full text of the ads must be displayed.

Ad-specific features

Ads may have additional features that help increase the paid click-through rate, and assist with ad partner approvals. These include Seller Ratings with Reviews and Deep Links.

Seller Ratings

The seller rating provides visual interest and credibility to an ad.

To display seller ratings, three images will be needed to represent the ratings: a whole star, a half star and a blank star. A sprite (such as the one below) containing all three may be used to show everything from no stars to five stars.

star sprite for seller ratings

The seller-ratings-source-url is used as the href for the link for the number of reviews. The number of reviews should be clickable. The ratings line contains the values of the seller-ratings-advertiser-info, followed by a representation of the seller-ratings-rating and then the seller-ratings-review-count which is linked to the seller-ratings-source-url.

The image below shows an example implementation of a result with both seller ratings and sponsored sitelinks:

Seller ratings XML example:

<seller-ratings-advertiser-info>jcrew.com is rated</seller-ratings-advertiser-info>
<seller-ratings-rating>4.5</seller-ratings-rating>
<seller-ratings-review-count>8192</seller-ratings-review-count>
<seller-ratings-source-url>http://www.google.com/products/seller?zmi=jcrew.com</seller-ratings-source-url>

Sponsored Sitelinks

Sponsored sitelinks provide additional opportunities for paid clicks on the page to higher-paying ads from well-known advertisers, as well as a better end user experience.

Not all ads have sitelinks, but all ads should have the capability to display them.

There are two options for how sitelinks may be displayed: on multiple lines, or on one line. Once you choose how to render sitelinks, they must be consistently rendered in that format for all ads.

Multilple-line format

Sitelinks display in two columns below the ad, in the following order:

Primary ad content
------------------------------------
   Ad Sitelink 1    Ad Sitelink 2
   Ad Sitelink 3    Ad Sitelink 4
   Ad Sitelink n    Ad Sitelink n + 1

Sitelinks should be indented (10px minimum, 15px suggested), with space above (10px suggested) to separate them from the rest of the result, and space in between the two columns (10px minimum) to increase readability.

Single-line format

The formatting requirements for rendering sitelinks in a single-line are as follows:

  • Left margin: left aligned with standard ad text.
  • Top margin: should be standard line spacing
  • Horizontal separation: Use ” – ” (a space, followed by a dash, followed by another space) in between each sitelink when two or more sitelinks are displayed.

Additional requirements for single-line formatting:

  • If sitelinks are returned for an ad, you must display at least one sitelink.
  • You must render as many sitelinks as possible in a single line, within the allotted ad width.
  • Sitelinks must be displayed in the order received from left to right. If any sitelinks are not displayed due to exceeding the ad width, the sitelinks you remove should be removed from the bottom of the returned list.
  • Sitelinks cannot be shortened or trimmed.
Primary ad content
-------------------------------------------------
Ad Sitelink 1 - Ad Sitelink 2 - Ad Sitelink 3

 

Sitelinks XML Example:

<deeplinks>
  <result>
    <title>Search All Jobs</title>
    <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dCYPK_I_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUNOuoRxgyQaIAQGgAcvEsukDyAEBqgQcT9D3PMy0HRIFgX2Otd2xIya4MlY8EwarHCKswPoFCQgDEMHWpW8YAQ%26num%3d6%26ctype%3d4%26sig%3dAOD64_0QpPKlIYue6Vn6kKjT39GxU6Eiyg%26adurl%3dhttp%3a%2f%2fwww.indeed.com%2f%253Fkw%253Dboeing%252Bcom%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=1&mid=9&hash=AE022526DA3521B7AADB08475BC763C7</site-link>
  </result>
  <result>
    <title>Post Your Resume</title>
    <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dC3WZfI_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUNDGk4AHYMkGiAEBoAHLxLLpA8gBAaoEHE_Q9zzMtB0SBYF9jrXdsSMmuDJWPBMGqxwirMD6BQkIAxDB1qVvGAI%26num%3d6%26ctype%3d4%26sig%3dAOD64_2T1lLhzzBmR1GS3R5ace0T6ScqlA%26adurl%3dhttp%3a%2f%2fwww.indeed.com%2fpromo%2fresume%253Fkw%253Dboeing%252Bcom%2526sid%253Dgoog61srhttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=2&mid=9&hash=CD1087330FF56DB329244C4514DFCE93</site-link>
  </result>
  <result>
    <title>Post a Job</title>
    <site-link>http://demohostedclick.infospace.com/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dl%26ai%3dCRyTJI_5tUK-_C6KHigLToIF4vezDrwG5o7XcPM6Dge0DEAYg7vfKDCgIUN3Iu5MHYMkGiAEBoAHLxLLpA8gBAaoEHE_Q9zzMtB0SBYF9jrXdsSMmuDJWPBMGqxwirMD6BQkIAxDB1qVvGAM%26num%3d6%26ctype%3d4%26sig%3dAOD64_17etPaPEbQnq0OA_TBB1v0ZiAADg%26adurl%3dhttps%3a%2f%2fads.indeed.com%2fpromoredir%253Ftag%253Dpost-for-free%2526kw%253Dsitelink-haj%2526sid%253Dgoog61srchttlexact-boeing&ld=20121004&ap=15&app=1&c=magentic&s=magentic&coi=495&cop=main-title&euip=10.10.10.10&npp=7&p=1&pp=8&pvaid=56c75a25de174c2fb4d4c6eb67aef11a&ep=3&mid=9&hash=2B3F554FFCC0368DC4C4322DBEA91950</site-link>
  </result>
</deeplinks>

Click-to-Call (Mobile Only)

Click-to-call provides additional opportunities for paid clicks on a mobile search results page, and allows end-users to easily call an advertiser by clicking on a link in the ad result.

Click-to-Call links will only be returned for mobile-specific segments using an approved “mobile” syndication tag from Google. Your Infospace Partnership Manager will also need to enable the click-to-call feature for your api feed. Not all mobile ads will include the click-to-call extension, but all ads should have the capability to display click-to-call should it be returned.

Click-to-call results may be returned in one of two formats: “Click-to-Call” or “Call Only”. Either format may be returned by Google for any given search, so both options should be supported.

For a given result with a Click-to-Call result, a <click-to-call> element will be added to the normal <result> element as a child. The <click-to-call> element itself will have the following child elements:

  • <title>
  • <site-link>
  • <phone-number> (may be omitted)
  • <disclaimer> (may be omitted)
  • <phone-image-url> (may be omitted)

If the result is a “Call Only” result, an additional child element, <call-only>, will be added to the <result> element as a child with a value of True. In this instance, the normal <site-link> element will be omitted from the result (because a site-link will instead be returned as a part of the <click-to-call> element).

Click-to-Call and Website Match

If an ad result used by the Website Match feature includes a click-to-call link, a <click-to-call> element will be added to the <entity> element as a child. The <click-to-call> element will have the same child elements listed above. A Website Match result will never be Call Only.

Click-to-Call Ad Format

This format adds the clickable phone number, and potentially some additional disclaimer text, to the existing ad elements. Note that if disclaimer text is returned, it must be displayed adjacent to the phone number.

Ad Title
www.displayurl.com
Ad description
Call: 555-555-1234 Additional charges may apply

The font size and style of the phone number should be the same as the font of the description text. The link color should be the same as the Ad title link.
The clickable phone number should be positioned beneath the standard ad text, with a top margin of 10px. If other ad extensions such as seller ratings or sitelinks are returned, the click-to-call link should be placed above those extensions. If click-to-call disclaimer text is returned, it should be displayed on the same line as phone number.

Click-to-Call format XML example:

<result>
  <content-sources>
    <content-source friendly-name="Ads by Google" engine-original-position="1"/>
  </content-sources>
  <site-link>

http://devhostedclick.infospace.com/WsApiPrimeClickHandler-branches.develop-short/ClickHandler.ashx?du=www.hotels.com%2f&ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dL%26ai%3dCoENaydlZUdizGabiiQKMooCwDpbaiN0Cns7Y4jyX4OQFCAAQASDy9-AaKANQx4Cn4QZgyYaAgICA5BPIAQGqBB9P0Mmh8pqJqXTJkWdkQeqHxMMcSRtf8uRz8osQcmq72AYCgAfey5wh%26sig%3dAOD64_3NhQbm-UHKBKeTTXzfC9aOJH4UaQ%26adurl%3dhttp%3a%2f%2fwww.hotels.com%2fmobile%2fsearch.html%253Finit%253Dtrue%2526pos%253DHCOM_US%2526locale%253Den_US%2526PSRC%253DG21%2526rffrid%253Dsem.hcom.US.google.003.03.03.s.kwrd%253DZzZz.sfGx8s8tF.0.16221670502.1020j6l18765&ld=20130401&ap=1&app=1&c=info.dogpl.mobile&s=dogpile&coi=245874&cop=topnav&euip=63.63.63.64&npp=0&p=1&pp=1&pvaid=5b09e2e493924905ac28b76891f7aed8&rt=gp&ep=1&mid=9&hash=B5D90B7473E47EA35223070824BF763B

  </site-link>
  <paid>true</paid>
  <display-url>www.<strong>hotels</strong>.com/</display-url>
  <title>
    <strong>Hotels</strong> - <strong>Hotels</strong>.com
  </title>
  <description>
    Book Now on your Android Phone! Save w/our Price Match Guarantee.
  </description>
  <deeplinks>
    <result>
      <title>Download Our App</title>
      <site-link>

http://devhostedclick.infospace.com/WsApiPrimeClickHandler-branches.develop-short/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dL%26ai%3dCj3PwydlZUdizGabiiQKMooCwDpbaiN0Cns7Y4jyX4OQFCAAQASDy9-AaKANQiMWwSWDJhoCAgIDkE8gBAaoEH0_QyaHymompdMmRZ2RB6ofEwxxJG1_y5HPyixByarv6BQoIAxC-lueMAxgB2AYCgAfey5wh%26ctype%3d4%26sig%3dAOD64_2VC5L44-XB299qv34tlcYr3TJODA%26adurl%3dhttps%3a%2f%2fad-x.co.uk%2fAPI%2fclick%2fHotels.com%2f4e20131712ec4%2frffrid%2fsem.hcom.US.001.016.01.03&ld=20130401&ap=1&app=1&c=info.dogpl.mobile&s=dogpile&coi=495&cop=topnav&euip=63.63.63.64&npp=0&p=1&pp=1&pvaid=5b09e2e493924905ac28b76891f7aed8&rt=gp&ep=1&mid=5&hash=EAF53ECAA3221382088DBD5330C66476

      </site-link>
    </result>
    <result>
      <title>Last Minute Deals</title>
      <site-link>

http://devhostedclick.infospace.com/WsApiPrimeClickHandler-branches.develop-short/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dL%26ai%3dC6ZOFydlZUdizGabiiQKMooCwDpbaiN0Cns7Y4jyX4OQFCAAQASDy9-AaKANQxrukBWDJhoCAgIDkE8gBAaoEH0_QyaHymompdMmRZ2RB6ofEwxxJG1_y5HPyixByarv6BQoIAxC-lueMAxgC2AYCgAfey5wh%26ctype%3d4%26sig%3dAOD64_0cwPauHXJmykzufC2exfT2BqGSNw%26adurl%3dhttp%3a%2f%2fwww.hotels.com%2flast-minute-hotel-deals%2f%2526rffrid%253Dsem.hcom.US.google.003.03.03.s.kwrd%253DZzZz.sfGx8s8tF.0.16221670502.1020j6l18765&ld=20130401&ap=1&app=1&c=info.dogpl.mobile&s=dogpile&coi=495&cop=topnav&euip=63.63.63.64&npp=0&p=1&pp=1&pvaid=5b09e2e493924905ac28b76891f7aed8&rt=gp&ep=2&mid=5&hash=D8EF5590276309A273E0B671BFA8AE9E

      </site-link>
    </result>
  </deeplinks>
  <seller-ratings-advertiser-info>hotels.com is rated</seller-ratings-advertiser-info>
  <seller-ratings-rating>4</seller-ratings-rating>
  <seller-ratings-review-count>213</seller-ratings-review-count>
  <seller-ratings-source-url>

http://www.google.com/products/seller?zmi=hotels.com

  </seller-ratings-source-url>
  <click-to-call>
    <site-link>

http://devhostedclick.infospace.com/WsApiPrimeClickHandler-branches.develop-short/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dL%26ai%3dCUGpDydlZUdizGabiiQKMooCwDpbaiN0Cns7Y4jyX4OQFCAAQASDy9-AaKANQ0KHLqPz_____AWDJhoCAgIDkE8gBAaoEH0_QyaHymompdMmRZ2RB6ofEwxxJG1_y5HPyixByarvYBgKAB97LnCE%26sig%3dAOD64_3Mjy-BWbgOW8PwZPpiichmHblyIA%26adurl%3dhttp%3a%2f%2fwww.google.com%2fctc_ad%253Fphone_num%253D%25252B1%252B866-365-9867%2526hl%253Den%2526gl%253DUS%2526adtitle%253DHotels%252B-%252BHotels.com%2525C2%2525AE%26ctype%3d9&ld=20130401&ap=0&app=1&c=info.dogpl.mobile&s=dogpile&coi=780&cop=topnav&euip=63.63.63.64&npp=0&p=1&pp=0&pvaid=5b09e2e493924905ac28b76891f7aed8&rt=gp&mid=9&hash=46D9CF2DA3F3D6520F1CE745EB531982

    </site-link>
    <title>Call: +1 866-365-9867</title>
    <phone-number>+1 866-365-9867</phone-number>
    <disclaimer>(Additional changes may apply)</disclaimer>
  </click-to-call>
</result>

Call-Only Ad Format

This format presents a different ad layout, wherein the only clickable link in the ad is the phone number and accompanying phone icon, both of which should appear as the ad title.

The click-to-call link itself should be formatted to use the same font style, size, and color as a standard ad title.

Call: 555-555-1234
Ad Title
www.displayurl.com (not clickable)
Ad description

Call-Only format XML example:

<result>
 <content-sources>
 <content-source friendly-name="Ads by Google" engine-original-position="2"/>
 </content-sources>
 <paid>true</paid>
 <display-url>www.courtyard-<strong>hotels</strong>.mobi/</display-url>
 <title>Courtyard&#174; By Marriott</title>
 <description>
 Book at Courtyard Official Site From Your Phone. It&#39;s A New Stay&#174;.
 </description>
 <call-only>True</call-only>
 <click-to-call>
 <site-link>

http://devhostedclick.infospace.com/WsApiPrimeClickHandler-branches.develop-short/ClickHandler.ashx?ru=http%3a%2f%2fwww.google.com%2faclk%3fsa%3dL%26ai%3dCmk_FydlZUdizGabiiQKMooCwDqSCirQDvOHIrTKX4OQFCAAQAiDy9-AaKANQkd7h0P______AWDJhoCAgIDkE8gBAaoEH0_QyY-FmoqpdMmRZUlx64fEwxxJG1_y5HPyiwYGOp_YBgKAB8zkyQM%26sig%3dAOD64_033kQ6lPtEbTotpHI6UViEftyWlg%26adurl%3dhttp%3a%2f%2fwww.google.com%2fctc_ad%253Fphone_num%253D%25252B1%252B800-306-1902%2526hl%253Den%2526gl%253DUS%2526adtitle%253DCourtyard%2525C2%2525AE%252BBy%252BMarriott%26ctype%3d9&ld=20130401&ap=0&app=1&c=info.dogpl.mobile&s=dogpile&coi=780&cop=topnav&euip=63.63.63.64&npp=0&p=1&pp=0&pvaid=bb7a8faf3d114bdea81ec6979a8a6380&rt=gp&mid=9&hash=6A6DD83956D13900D61DB5C9174CD925

 </site-link>
 <title>Call: +1 800-306-1902</title>
 <phone-number>+1 800-306-1902</phone-number>
 <phone-image-url>http://www.infospace.com/dummy_phone_image.png</phone-image-url>
 </click-to-call>
</result>

Please note: for the recommended font sizes, colors, and styles for all ad elements, including click-to-call, please refer to the Suggested Fonts & Colors table at the top of the page.


Next: Implementing Features
Back to: The Result Set