Yahoo! SearchMonkey のセマンティック構造記述例｜Product
Yahoo! Search Monkey > Start Overview > Productの自分用まとめメモ。
- 注意
-
- 超訳なので、少し日本語おかしいところがありますが、英語レベル低いため正しく書こうとすると分かりにくくなっちゃうのでそのままにしています。
- あまりセマンティックの知識ないんで、サンプルを見ながら学習しています。なので全然見当違いのことを書いているかもしれません。ごめんなさい。
表示内容
商品情報（価格・画像・レイティング含む）
反映時間
マークアップが正しければ、リクロールの際に enhanced result が表示される。
サイトによっては数日〜数週間の間。
RDFa - SM Product
「SM Product」がよくわかんない・・・なんだろこれ。
REQUIRED
- xmlns:product (url)：SearchMonkey Productの独自ネームスペース
- product:Product (-)：以下要素がproductに属することを明示
RECOMMENDED
- xmlms:rdfs (url)：RDFSネームスペース
- rdfs:label (string)：プロダクト名
- product:listPrice (float)：価格表示
- product:currency (currency)：価格通貨
OPTIONAL
- xmlns:review(url)： RDF Reviewネームスペース。レビュー表示がある場合のみに使用。valueは定型："http://purl.org/stuff/rev#"
- xmlns:xsd(url)：XMLスキーマネームスペース。xsd:float や xsd:integer のようなフォーマットがあるときにのみ使われる。validは定型："http://www.w3.org/2001/XMLSchema#"
- xmlns:vcard(url)：VCardネームスペース。アドレス・電話番号・写真・URLなどに使われる。valueは定型："http://www.w3.org/2006/vcard/ns#"
- xmlns:rdfs(url)：RDFSネームスペース。ラベルやコメントに使われる。valueは定型："http://www.w3.org/2000/01/rdf-schema#"
- xmlns:commerce(url)：SearchMonkey Commerceネームスペース。商品生産者が組織であるときに使われる。
- xmlns:media(url)：SearchMonkey Mediaネームスペース。商品画像があることを明示する際に使われる。valueは定型："http://search.yahoo.com/searchmonkey/media/"
- xmlns:use(url)：SearchMonkey Use ネームスペース。商品識別型を明示する際に使われる。valueは定型："http://search.yahoo.com/searchmonkey-datatype/use/"
- xmlns:currency(url)：SearchMonkey Currency ネームスペース。価格表示の通貨型を明示する際に使われる。datatype="currency:USD"のように、基本的にdatatype属性で使用される。3文字のISO4217通貨コードを用いる。valueは定型："http://search.yahoo.com/searchmonkey-datatype/currency/"
- product:salePrice(float)：gr:hasPriceSpecificationが定価かどうかを指し示す（gr=GoodRelation）。販売価格と定価どちらも表示する場合、Yahoo!では定価に取り消し線をつけて両方の値段を表示する。27.99のような浮動少数形式がフォーマットで、通貨単位はproduct:currencyで定義する。
- product:identifier(string)：SKUのような商品認識コード。use:sku/use:upc/use:isbn/use:ean13など、20種類のフォーマットがある。
- rdfs:comment(string)：product:Product内では、製品の説明に使われる。最大200文字がフォーマット。
- rdfs:seeAlso media:image(gif, jpg, png)：製品画像。[注意]無関係な画像や、広告めいた画像はCTRにネガティブインパクトを与える。フォーマットはGIF/PNG/JPGなどへのURL。画像は検索結果と同じドメインにないといけない。また、画像サイズは85x65。
- product:manufacturer(string)：製造者。この要素内では、vcardが使われることが期待される。
- product:specification(url)：製品規格（仕様）へのリンク。
- product:faq(url)：製品へのFAQへのリンク。
- product:manual(url)：製品マニュアルへのリンク。
- review:rating(float)：総レビュー値。デフォルトでは0-5の値。Yahoo!ではスターで表現する（半スターもあり）。review:ratingsがあっても、Yahoo!ではレビューは表示しない。[補足]product:manufactureにネストされていなければ、レビューは商品に対するものであって、販売者へのレビューではない。
- review:minRating(integer)：レビューの最低点数。デフォルトは0。もし最低値が明示されていれば、Yahoo!ではスター表示よりも提示されたレイティングのほうを表示する。review:maxRatingよりも低い数字であることが条件。
- review:maxRating(integer)：レビューの最高点数。デフォルトは5。もし最高値が明示されていれば、Yahoo!ではスター表示よりも提示されたレイティングのほうを表示する。review:minRatingよりも高い数字であることが条件。
- review:totalRatings(integer)：ユーザーレビューの総評価。
サンプル１
<div typeof="product:Product" xmlns:product="http://search.yahoo.com/searchmonkey/product/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"> <span property="product:listPrice">27.99</span> <span property="product:currency" content="USD"></span> <span property="rdfs:label">Startech Serial ATA Cable - 45.72cm - Red</span> </div>
サンプル2
<div typeof="product:Product"
xmlns:product="http://search.yahoo.com/searchmonkey/product/"
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
xmlns:commerce="http://search.yahoo.com/searchmonkey/commerce/"
xmlns:media="http://search.yahoo.com/searchmonkey/media/"
xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
xmlns:review="http://purl.org/stuff/rev#"
xmlns:xsd="http://www.w3.org/2001/XMLSchema#"
xmlns:use="http://search.yahoo.com/searchmonkey-datatype/use/"
xmlns:currency="http://search.yahoo.com/searchmonkey-datatype/currency/">
<span property=" product:listPrice">34.99</span>
<span property="product:salePrice">27.99</span>
<span property="product:currency" content="USD" />
<span property=" product:identifier" datatype="use:sku">10363780</span>
<span property=" rdfs:label">Startech Serial ATA Cable - 45.72cm - Red</span>
<span property=" rdfs:comment">If you're one of the growing
numbers of PC users with a mini or micro form factor case, you know that
you don't have a lot of room to spare. These right-angle Serial ATA
cables guarantee you''ll be able to plug in your high-performance Serial
ATA 150 hard drives, no matter how tight your space is. With their thin,
narrow construction, these flexible cables improve airflow and reduce
clutter in your case, helping to keep your case clean and cool. And,
like all our cables, they're backed by our lifetime warranty.</span>
<span rel=" rdfs:seeAlso media:image">
<img src="http://example.com/product.jpg"/>
</span>
<div rel=" product:manufacturer">
<span typeof="vcard:VCard commerce:Business">
<a rel="vcard:url" href="http://www.example.org/company"></a>
<span property="vcard:organization-name">Startech Computer Products</span>
</span>
</div>
<a rel=" product:specification" href="http://example.com/spec"></a>
<a rel="product:faq" href="http://example.com/faq"></a>
<a rel="product:manual" href="http://example.com/manual"></a>
<!-- NOTE: this is the review of the product, not the seller! -->
<div rel=" review:hasReview">
<span typeof="review:Review">
<span property="review:rating" datatype="xsd:float">4.5</span>
<span property="review:minRating" datatype="xsd:integer">0</span>
<span property="review:maxRating" datatype="xsd:integer">5</span>
<span property="review:totalRatings" datatype="xsd:integer">45</span>
</span>
</div>
</div>
RDFa - GoodRelations
「GoodRelations」は商品語彙の共通規格・・のことだと思われる。"gr:XXXXX"で表現する。
REQUIRED
- xmlns:gr(url)：GoodRelationsネームスペース。製品情報に特化して使われる。
- grOffering(-)：子要素が製品に関することを指し示す。
RECOMMENDED
- gr:hasCurrencyValue(float)：製品価格。価格に幅があれば、gr:hasCurrencyValueMin/gr:hasCurrencyValueMaxを使う。デフォルトではここは定価。販売価格にするときは、gr:isListPriceを参照。フォーマットは浮動少数形式。通貨はgr:hasCurrencyで設定。
- gr:hasCurrency(currency)：製品価格の通貨単位。通貨コードを使うときは、content属性で指定。"USD"のようなISO 4217 で決められた3文字のabbrがフォーマット。
OPTIONAL
- xmlns:product(url)：SearchMonkeyネームスペース。製品情報がある際に使われる。
- gr:isListPrice(boolean)：gr:hasPriceSpecificationが定価かどうかを指示する。デフォルトではtrue。gr:hasPriceSpecificationを2つ使うことで販売価格を明示できる。その場合、gr:isListPriceはfalse、低い方のgr:hasCurrencyValueで表現される。
- gr:amoundOgThisGood(float)：販売可能な商品個数を明示する。
- gr:hasEAN_UCC-13(string)：製品のEAN UCC-13コード。
サンプル1
<div typeof="gr:Offering"
xmlns:gr="http://purl.org/goodrelations/v1#"
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#">
<div rel="gr:hasPriceSpecification">
<span property="gr:hasCurrencyValue">34.99</span>
<span property="gr:hasCurrency">USD</span>
</div>
<div rel="gr:includesObject">
<div rel="gr:typeOfGood">
<div typeof="gr:ProductOrServicesSomeInstancesPlaceholder">
<span property="rdfs:label">Startech Serial ATA Cable - 45.72cm - Red</span>
</div>
</div>
</div>
</div>
サンプル2
<div typeof="gr:Offering"
xmlns:gr="http://purl.org/goodrelations/v1#"
xmlns:product="http://search.yahoo.com/searchmonkey/product/"
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
xmlns:media="http://search.yahoo.com/searchmonkey/media/"
xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
xmlns:review="http://purl.org/stuff/rev#"
xmlns:xsd="http://www.w3.org/2001/XMLSchema#"
xmlns:use="http://search.yahoo.com/searchmonkey-datatype/use/"
xmlns:currency="http://search.yahoo.com/searchmonkey-datatype/currency/">
<!-- Two price specifications: a list price and a sale price -->
<div rel=" gr:hasPriceSpecification">
<span property="gr:hasCurrencyValue">34.99</span>
<span property="gr:hasCurrency">USD</span>
</div>
<div rel="gr:hasPriceSpecification">
<span property="gr:isListPrice" datatype="xsd:boolean">false</span>
<span property="gr:hasCurrencyValue">27.99</span>
<span property="gr:hasCurrency">USD</span>
</div>
<div rel=" gr:includesObject">
<span property=" gr:amountOfThisGood" datatype="xsd:float">1.0</span>
<div rel=" gr:typeOfGood">
<div typeof="product:Product gr:ProductOrServicesSomeInstancesPlaceholder">
<span property="gr:hasEAN_UCC-13">00010363780</span>
<span property="product:identifier" datatype="use:sku">10363780</span>
<span property=" rdfs:label">Startech Serial ATA Cable - 45.72cm - Red</span>
<span property=" rdfs:comment">If you're one of the growing
numbers of PC users with a mini or micro form factor case, you know that
you don't have a lot of room to spare. These right-angle Serial ATA
cables guarantee you''ll be able to plug in your high-performance Serial
ATA 150 hard drives, no matter how tight your space is. With their thin,
narrow construction, these flexible cables improve airflow and reduce
clutter in your case, helping to keep your case clean and cool. And,
like all our cables, they're backed by our lifetime warranty.</span>
<span rel=" rdfs:seeAlso media:image">
<img src="http://example.com/product.jpg"/>
</span>
<div rel=" product:manufacturer">
<span typeof="vcard:VCard commerce:Business">
<a rel="vcard:url" href="http://www.example.org/company"></a>
<span property="vcard:organization-name">Startech Computer Products</span>
</span>
</div>
<a rel=" product:specification" href="http://example.com/spec"></a>
<a rel="product:faq" href="http://example.com/faq"></a>
<a rel="product:manual" href="http://example.com/manual"></a>
<!-- NOTE: this is the review of the product, not the seller! -->
<div rel=" review:hasReview">
<span typeof="review:Review">
<span property="review:rating" datatype="xsd:float">4.5</span>
<span property="review:minRating" datatype="xsd:integer">0</span>
<span property="review:maxRating" datatype="xsd:integer">5</span>
<span property="review:totalRatings" datatype="xsd:integer">45</span>
</span>
</div>
</div>
</div>
</div>
</div>
