Open Searchmercials

Introduction

To turn your web pages into rich search objects, you need to add basic metadata to your page. We've based the initial version of the protocol on RDFa which means that you'll place additional metatags inside the <head> tags </head> of your web pages.

Overview

A searchmercial is new industry jargon for "a video commercial designed specifically for online search and directories...the purpose of the searchmercial is to appeal to the active searcher by providing the information they seek quickly and clearly. With a searchmerical there is no need to cut through the clutter or generate effective reach; you simply need to tell your story and communicate value. In fact, where traditional advertising is designed to stand out from the content the audience is viewing, the searchmercial is the content, and as with all video, has the added benefit of improving your search engine rankings."

Open Searchmercials Protocol

The Open Searchmercials protocol version 3.0 is compatible with Open Graph protocol and  is backward compatible with Searchmercials protocol version 1 and 2 and sub-versions.

The Open Searchmercials protocol and its compatibility with Open Graph protocol will open up Searchmercials to main stream internet search services. The Open Searchmercials protocol version 3.0 is based on the Open Graph protocol. This documentation is written in similarly in form and in terms as Open Graph documentation in order to provide similarities between the two protocols.

The Open Searchmercials protocol enables any web page to become a rich object in search results in representation of your website URL. For instance, this is used on Searchmercials to allow any web page to submit a searchmercial listing by submitting a website URL that has automatic or scheduled updateable metadata from your webpage metatags.

While many different technologies and schemas exist and could be combined together, there isn't a single technology which provides enough information to richly represent any web page within the search results.

The Open Searchmercials protocol builds on these existing technologies and gives developers one thing to implement. Developer simplicity is a key goal of the Open Searchmercials protocol.

The system spiders these custom Meta tags or feeds for new Metadata on a scheduled basis to automate the submission and programming of the searchmercials content over the search engine. The system provides videos tailored for search in the results list in order to better inform users as to the contents of a link URL. The system can also provide users with other call to action options such as click to call, literature, order forms, etc. The system can schedule searchmercials to target users by time of day, location, device, and other parameters to offer a call to action to different audiences.

Settings Metadata

Important: The following metatags are used to set specific settings and functions for your searchmercial listing. Some metatags are optional as they have default settings.

Property Content Required
os:settings:canonical

The canonical URL of your searchmercial that will be used as its permanent ID, (duplicates are NOT allowed.) This value must match the actual URL where metatags reside.

YES
Notes:

The canonical URL helps prevent duplicate content issues. It does this by specifying the "canonical URL", the "preferred" version of a web page. Using it well improves a site's SEO on Searchmercials and other search engines.

For example:
<meta property='os:settings:canonical' content='http://mydomain.com/myproduct.html' />
os:settings:type A type of searchmercials as indicated in the table below. YES
For example:
<meta property='os:settings:type' content='Company' />
See table below for options and criteria...
Types Criteria
Business

Business and Industry Searchmercials exists solely to provide official broadcasts (audio/video) for and about corporations and other business entities as well as commercial enterprises that offer products and services to businesses (B2B) and/or consumers (B2C); with a primary focus on presentations, information and call to action related to a company or business.

Example:


<meta property='os:type' content='Business' />"
Products

Shopping Searchmercials provide information on shopping over the internet and directs users to the resources, tools and functionalities that enhance online shopping; and also provides information on commercial exchanges in general related to shopping, both for businesses (B2B) and consumers (B2C); with a primary focus on presentation and information and call to action related to shopping.

Example:


<meta property='os:type' content='Products' />"
Services

Services Searchmercials provide information on professional and specialized services such as financial services, legal services, consulting services, support services, etc.; and on commercial exchanges in general related to professional and specialized services, both for businesses (B2B) and consumers (B2C); with a primary focus on presentation and information and call to action related to professional and specialized services.

Example:


<meta property='os:type' content='Services' />"
Reference

Reference and Information Searchmercials provide information on referential and information sources, as well as vertical references and other categorized information distributors, such as: portals, search engines, yellow pages, dictionaries, bibliographies, directories, etc. which aim to inform, market and sell information related to links and references for both businesses (B2B) as well as consumers (B2C), with a primary focus on presentation and information and call to action related to referential and information sources.

Example:


<meta property='os:type' content='Reference' />"
Classifieds

Classifieds Searchmercials provide information on classified ads; and on commercial exchanges in general related to the classifieds, both for businesses (B2B) and consumers (B2C); with a primary focus on presentation and information and call to action related to classified ads.

Example:


<meta property='os:type' content='Classifieds' />"
Events

Events Directory provides information on special events as well as commercial exchanges related to events in general, both for businesses (B2B), as well as consumers (B2C), with a primary focus on presentation and information s, news s, advertisement s related to events.

Example:


<meta property='os:type' content='Events' />"
Entertainment

Entertainment Searchmercials provide information on entertainment such as games, movies, live events, music, PPV, etc.; and on commercial exchanges related to entertainment in general, both for businesses (B2B), as well as consumers (B2C), with a primary focus on presentation and information and call to action related to entertainment.

Example:


<meta property='os:type' content='Entertainment' />"
Recreation

Leisure and Recreation Searchmercials provide information on leisure and recreation activities; and on commercial exchanges in general related to leisure and recreation, both for businesses (B2B) and consumers (B2C); with a primary focus on presentation and information and call to action related to leisure and recreation activities.

Example:


<meta property='os:type' content='Recreation' />"
Government

Government Searchmercials provide information on regulatory agencies, policies and regulations for areas under governmental regulatory jurisdiction; as well as on commercial exchanges in general related to regulatory government agencies, both for businesses (B2B) and consumers (B2C); with a primary focus on presentation and information and call to action related to municipal, local, city, county, state, federal, international government regulatory agencies, policies, politics, and regulations.

Example:


<meta property='os:type' content='Government' />"
os:settings:topic

The topic metatag is used for indexing into the searchmercials directory.

YES
Notes:

Should be a subcategory of the searchmercial type (os:type) metatag. For example: Type = Business, Topic = Accounting or Type = Service, Topic = Landscaping.

For example:
<meta property='os:settings:topic' content='Accounting' />
os:settings:subject

A brief elaboration of the topic subject matter.

YES
Notes:

This field is used to assist our Directory Services Editors in indexing your searchmercial in the Directory. (150 characteers)

For example:
<meta property='os:settings:subject' content='Bookkeeping and Accounting services for the Atlanta Metro Area.' />
os:settings:revisit_after

The system will revisit your URL and update the metadata automatically based on this setting.

OTIONAL*
Notes:

It is specified in the number of days. For example, if you need to specify an interval of 3 months, the correct syntax would be specified in days, not months. Example: 3 months = 93 days

If this tag is not present, the URL will be checked for accuracy and validation of media assets and metadata periodically. If the current metatags validation is different from original post, the URL may become inactive until corrected. You will receive an email that your searchmercial listing is inactive with intructions on how to deal with the ticket.

It is HIGHLY RECOMMENDED that metatags and metadata is not changed often as it will cause the system to have to re-index the searchmercial and you will losse your SEO rank in Searchmercials and other systems and search engines.

For example:
<meta property='os:settings:revisit_after' content='93 days' />
*It is recommended that a URL and its metadata not change constantly as URL and Searchmercials are shared in social sites as well as other sharing platforms and the data will be different on the currently updated URL from the previous version of the shared URL. We make this feature available due to the fact that in some cases it is pertinent that the content changes periodically, we recommend you change the media assets themselves if necessary leaving all metadata intact, but in the end, it is up to the discretion of the publisher how this is handled.
os:settings:expires

The metatag distribution defines the level or degree of distribution of your URL and how it should be classified in relation to methods of distribution on the Searchmercials system.

OPTIONAL*
Notes:

The expires meta tag defines the expiration date and time of the document being indexed. If tag is not present listing will NEVER expire.

For example:
<meta property='os:settings:expires' content='01/01/2020' />
*Most common use for this tag are time sensative URLs. For example holiday URLs, event URLs, etc...
os:settings:site_name

Name OR DOMAIN of the site.

Optional
Notes:

If your object is part of a larger web site, the name which should be displayed for the overall site. The site name is sused to assign the account ID or network ID. Tipically this would be a domain name or company trademark.

For example:
<meta property='os:settings:site_name' content='atlantalandscapegroup.com' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:settings:site_name' content='atlantalandscapegroup.com' />
os:settings:icon

An URL to an Icon representing your company or network. Accepted format is PNG.

YES
For example:

The Icon settings is used to assign the account or network with an icon similar to how a site uses a favicon to brand/identify the site. Width = 310px & Height 310px with clear background preferred.


<meta property='os:settings:icon' content='http://mywebsite/icon.png' />
os:settings:distribution

The meta tag distribution defines the level or degree of distribution of your webpage and how it should be classified in relation to methods of distribution on the world wide web.

OPTIONAL
Notes:

There are currently only three forms of distribution supported by the distribution tag:

For example:
  • Global (default value) - indicates that your webpage is intended for everyone(default value)
  • Local - intended for local distribution of your document (os:locational:coverage is required if local)
  • IU - Internal Use, not intended for public distribution (listing will only be displayed in your API upon authentication)

<meta property='os:settings:distribution' content='global' />
os:settings:is_adult

The meta tag is_adult defines the maturity of the audience and content.

YES*
Notes:

There are only two options for the is_adult metatag true or false. Although it is not allowed to display mature content in Searchmercials (adult searchmercials should be done tastefully) we MUST be careful NOT to lead minors to mature content. Mature content relates to nudity, porn, weapons, violence, crime, profanity, mature subjects, mature content, as well as other searchmercial types, topics and subject matter that may be considered for mature audiences over the age of 18.

Options

  • FALSE - indicates that your webpage is intended for everyone(audiences of all ages)
  • TRUE - intended for audiences over 18 years of age.
For example:
<meta property='os:settings:is_adult' content='FALSE' />
* If the os:settings:is_adult metatag is not present, the URL will NOT be indexed.

In most cases it is also required to place the RTA (Restricted To Adults) label between your head tags on URLs containing adult subject matter. Learn more

For Example:
<meta name="RATING" content="RTA-5042-1996-1400-1577-RTA" />
Please read "Publisher Responsibility" listed below before continuing forward with this documentation.

To All Publishers

Searchmercials is a new and informative way to search and market on World Wide Web. They are directed and intended for connected devices, Internet TV, connected program guides and other similar applications. Utilized properly the provide huge benefits to publishers and publishers inteded audiences alike.

It is the responsibility of every publisher to know and understand who is their intended and target audience. These metatags are used to identify and segemnt that intended audience. Not utilized properly can and WILL likely be construed as an illegal act on the publisher's part, as it is indicated on the publisher's matatags on your URLs.

For example, if you have mature content on your URL and the metatags is set for all audiences, it is probable and very likely that authorities will be contacting you, and the notion that this was an accident CANNOT be widely accepted, as the publisher's intention is defined in the metatags and these metatags are set only by the publisher and their webmasters. In most cases, charges will be filed, with little to NO defense on the publisher's part, since this setting is ONLY set by the publisher.

Audio and Video Searchmercials are 70% more impactful that regular text-based search results, therefore, we provide safeguards in order to protect both, publishers as well as minors, as long as the parameters of these metatags are being adhered to. We understand that information and content has their targeted audiences, and we support this, but if publisher's are intending to exploit, inform, or provide minors with mature subject matter, WE WILL SEEK TO PENALIZE IN ANY AND ALL POSSIBLE FORMS and MEANS available to us.

The Searchmercials system adheres to rules of the FCC, CIPA, and NETmundial.

Basic Metadata

Property Content Required
os:title

The title of your searchmercial as it should appear within the results.

YES
Notes:

Up to 40 characters permitted. (30 characters recommended)

For example:
<meta property='os:title' content='Atlanta Landscape Group' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:title' content='Atlanta Landscape Services' />
os:headline

The headline (subtitle or title-tag) of your searchmercial as it should appear within the results.

YES
Notes:

An explanatory or alternate title, in addition to its main title. The headline is the text indicating the nature of the searchmercial. Up to 80 characters permitted (40 characters recommended)

For example:
<meta property='os:headline' content='Servicing the Atlanta metro area.' />
os:decription

The description of your object as it should appear within the results.

YES
Notes:

Up to 180 characters permitted. (80 characters recommended)

For example:
<meta property='os:decription' content='Providing unparalleled customer service.' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:decription' content='Providing unparalleled customer service.' />
os:keywords

The keywords of your object separated by comma,
e.g., "keyword1, keyword2, keyword3".

YES
Notes:

Keep keywords relative to the call for action, up to 200 characters permitted. (Three keywords or search terms recommended)

For example:
<meta property='os:keywords' content='keyword1, keyword2, keyword3' />

Call For Action Metadata

Property Content Required
os:cfa:url

A Call For Action landing page URL
e.g., "http://www.domainname.com/products/prod1111/".

YES*
Notes:

The call for action URL of your searchmercial, may be same or different from the canonical URL.

For example:
<meta property='os:cfa:url' content='http://www.domainname.com/products/prod1111/' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:url' content='http://www.domainname.com/products/prod1111/' />

*The URL for your searchmercial that will be used as a primary Call For Action. This value can be the same as the os:settings:conanical URL, but doesn't have to be. For example, in some cases the conanical URL may be that of a product URL and the Call For Action URL may be that of a shopping cart, a Paypal or other gateway URL, a PDF file URL for literature, etc. Both URLs are made available "When Different" in most cases.

os:cfa:phone

A valid contact phone number.

OPTIONAL*
Notes:

A valid phone number with country code, area code, and number

For example:
<meta property='os:cfa:phone' content='1-404-718-0044' />"

*In some applications phone or email may be optionally presented to users as well as the URL as Call For Action options. These cases are usually determined by the app, device or other conditions.

os:cfa:email

A valid email address

OPTIONAL*
Notes:

A valid contact email address.

For example:
<meta property='os:cfa:email' content='email@myemail.com' />

*In some applications email may be optionally presented to users as well as the URL as Call For Action options. These cases are usually determined by the app, device or other conditions.

Image Metadata

Property Content Required
os:image:poster

An image URL (W320px X H180px) which should represent your object within the results.

YES
For example:
<meta property='os:image:poster' content='http://image-URL.com/image.jpg' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:image' content='http://image-URL.com/image.jpg' />
os:image:thumbnail

An image thumbnail URL (W120px X H90px) which should represent your object within the results.

YES
For example:
<meta property='os:image:thumbnail' content='http://image-URL.com/thumbnail.jpg' />
os:image:SD

An image URL (W720px X H480px) which should represent your object within the results.

YES
For example:
<meta property='os:image:SD' content='http://image-URL.com/image.jpg' />
os:image:HD

An image URL (W1080px X H720px) which should represent your object within the graph.

OPTIONAL*
For example:
<meta property='os:image:HD' content='http://image-URL.com/image.jpg' />
os:image:FullHD

An image URL (W1920px X H1080px) which should represent your object within the graph.

OPTIONAL*
For example:
<meta property='os:image:FullHD' content='http://image-URL.com/image.jpg' />

*Optional image metatags are optional as of now. They in cases where searchmercials are displayed on devices with resolutions above SD the images supplied will be stretched to match higher resolution devices such as Internet TV, tablets, gaming consoles, etc. It is recommended that high resolutions images are used where possible. More resolutions may be added as devices become available.

Audio Metadata

Property Content Required
os:audio

An audio URL which should represent your object within the results.

OPTIONAL*
Notes:

Not used if using os:audio:embed

For example:
<meta property='os:audio' content='http://example.com/sound.mp3' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:audio' content='http://example.com/sound.mp3' />
os:audio:type

Audio file Mime Type.

OPTIONAL*
Notes:

Required if using os:audio

For example:
<meta property='os:audio:type' content='audio/mpeg' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:audio:type' content='audio/mpeg' />
os:audio:embed

A URL to an audio embed audio player

OPTIONAL*
Notes:

Not used if using os:audio

For example:
<meta property='os:audio:embed' content='https://w.soundcloud.com/player/tracks/318511652' />

*Audio metadata is not required to post a searchmercial. Searchmercials without audio metadata will not appear in audio based search results or ad placements.

Video Metadata

Property Content Required
os:video:embed

A URL to an embed video player

YES/NO*
Notes:

Not used if using os:video. This is the preferred method.

For example:
<meta property='os:video:embed' content='https://www.youtube.com/embed/Zl0CmMJvwGk?ecver=2' />
os:video

An video URL which should represent your object within the results.

YES/NO*
Notes:

Not used if using os:video:embed

For example:
<meta property='os:video' content='http://example.com/video.mp4' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:video' content='http://example.com/video.mp4' />
os:video:type

Video file Mime Type.

YES/NO*
Notes:

Required if using os:video. Not used if using os:video:embed.

For example:
<meta property='os:video:type' content='audio/mp4' />

Compatible with : Open Graph

Open Graph example:
<meta property='og:video:type' content='audio/mp4' />

*Video metadata is required to post a searchmercial in file form os:video or embed form os:video:embed. Searchmercials without video metadata will not appear in video based search results or ad placements.

Locational Metadata

PropertyContentRequired
os:locational:address

The street address and extended address or its internation equivalent.

OPTIONAL*
Notes:

An address, may include suite #, apt., etc..

For example:
<meta property='os:locational:address' content='180 Peachtree Street' />
os:locational:city

name of the city or its internation equivalent. No abbreviations.

OPTIONAL/YES**
Notes:

Required if using os:locational:address. Full Name , no abbreviations.

For example:
<meta property='os:locational:city' content='Atlanta' />
os:locational:state

A name of the state/province or its internation equivalent. No abbreviations.

OPTIONAL/YES**
Notes:

Required if using os:locational:address. Full Name , no abbreviations.

For example:
<meta property='os:address:state' content='Georgia' />
os:locational:postalcode

The postal code or zip code or its internation equivalent.

OPTIONAL/YES**
Notes:

Required if using os:locational:address

For example:
<meta property='os:locational:postalcode' content='30018' />
os:locational:country

The country's three letter equivalent.

OPTIONAL/YES**
Notes:

Required if using os:locational:address

For example:
<meta property='os:locational:country' content='USA' />
os:locational:latitude

The latitude value.

OPTIONAL***
For example:
<meta property='os:locational:latitude' content='33.7585673' />
os:locational:longitude

The longitude value.

OPTIONAL***
For example:
<meta property='os:locational:longitude' content='-84.3900626' />

*If using os:address, you must use the locational metatags with OPTIONAL/YES** in the required column.

**This value is required if using os:locational:address

***Latitude and Longitude can be automatically obtained if os:locational:address is used.

Shopping Metadata

Property Content Required
os:shopping:price

A price for your product, service, event, classified, etc.

OPTIONAL
Notes:

Up to 10 characters permitted with 2 decimals.

For example:
<meta property='os:shopping:price' content='120.00' />
os:shopping:currency

OPTIONAL
Notes:

The currency your price is reflecting (USD is default - ONLY used if os:shopping:price is present)

For example:
<meta property='os:shopping:currency' content='USD ($)' />
os:shopping:availability

The availability of your product, service, event, classified, etc. (instock is default)

OPTIONAL
Notes:

Options: instock / in stock / preorder/backorder / out of stock / discontinued

For example:
<meta property='os:shopping:availability' content='instock' />
os:shopping:brand

A brand or name (if any) for your product, service, event, classified, etc.

OPTIONAL
Notes:

Up to 30 characters allowed.

For example:
<meta property='os:shopping:brand' content='Fiero' />

Open Searchmercials Debugger

So you have used the Metatag, Icon, Image Generator Tools and you have all your metadata on your Searchmercial URL, GREAT!

You are now ready to submit it, but before submitting your Searchmercial URL, it is good practice to pass it though the Open Searchmercials Debugger Tool (OS Debugger), in order to make sure it is formatted correctly and it has all the required matatags and metadata.

Open Searchmercials Metatag Generator

The Metatag Generator will need to check that you are submitting a valid URL. Then it will scrape any available metadata to get you started. Please enter a valid active URL.

Select an option that is best associated with the URL you are submitting


Click on Settings Metadata button to view documentation

A URL to a business (homepage, about us, mission, company information), a product, a service, an event, a reference, entertainment, a classified listing, or gevernmental agency.

Important: The canonical URL of your searchmercial that will be used as its permanent ID, (duplicates are NOT allowed.) This value must match the actual URL where metatags reside.
Click on Settings Metadata button to view documentation
There are only two options for the is_adult metatag true or false. Although it is not allowed to display mature content in Searchmercials (adult searchmercials should be done tastefully) we MUST be careful NOT to use Call For Action that will lead minors to mature content or subject matter. Mature content relates to nudity, porn, weapons, violence, crime, profanity, mature subjects, mature content, as well as other searchmercial types, topics and subject matter that may be considered for mature audiences over the age of 18.
Click on Settings Metadata button to learn more

URL Scraper Tool

This tool will scrape and let you analyze your URLs for image assets, metadata, and internal/external links.

This information is helpful in helping you asses what you are currently working on with your URLs.




Icon Generator Tool

Searchmercial Images Generator Tool