订单是交易确认(收据),可以包含多个订单项,每个订单项都由客户接受的 Offer 表示。
使用场景
基本订单
订单的最小示例:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "29.99",
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
}
}
</script>
微数据
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
</div>
查看订单操作
您可以通过设置 url 属性,向订单添加查看订单按钮。如需直接链接到移动应用,请添加 ViewAction:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"orderStatus": "http://schema.org/OrderProcessing",
"priceCurrency": "USD",
"price": "29.99",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
},
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
}
}
</script>
微数据
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
包含结算详细信息的订单
包含详细结算信息的订单示例:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "539.00",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": [
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Samsung Chromebook",
"sku": "B009LL9VDG",
"url": "http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/",
"image": "http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"
},
"price": "249.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "2"
},
"seller": {
"@type": "Organization",
"name": "Samsung Marketplace Store"
}
},
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
},
"seller": {
"@type": "Organization",
"name": "Google Store @ Amazon"
}
}
],
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
},
"orderStatus": "http://schema.org/OrderProcessing",
"paymentMethod": {
"@type": "PaymentMethod",
"name": "http://schema.org/CreditCard"
},
"paymentMethodId": "**** **** **** 1234",
"orderDate": "2027-11-07T23:30:00-08:00",
"isGift": "false",
"discount": "0.97",
"discountCurrency": "USD",
"customer": {
"@type": "Person",
"name": "John Smith"
},
"billingAddress": {
"@type": "PostalAddress",
"name": "Google",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"addressCountry": "USA"
}
}
</script>
微数据
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="539.00"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Samsung Chromebook"/>
<meta itemprop="sku" content="B009LL9VDG"/>
<link itemprop="url" href="http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"/>
</div>
<meta itemprop="price" content="249.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="2"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Samsung Marketplace Store"/>
</div>
</div>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Google Store @ Amazon"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<div itemprop="paymentMethod" itemscope itemtype="http://schema.org/PaymentMethod">
<meta itemprop="name" content="http://schema.org/CreditCard"/>
</div>
<meta itemprop="paymentMethodId" content="**** **** **** 1234"/>
<meta itemprop="orderDate" content="2027-11-07T23:30:00-08:00"/>
<meta itemprop="isGift" content="false"/>
<meta itemprop="discount" content="0.97"/>
<meta itemprop="discountCurrency" content="USD"/>
<div itemprop="customer" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="billingAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Google"/>
<meta itemprop="streetAddress" content="1600 Amphitheatre Pkwy"/>
<meta itemprop="addressLocality" content="Mountain View"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
测试您的标记
您可以使用电子邮件标记测试工具验证标记。 粘贴您的标记代码,然后点击验证按钮扫描内容,并接收有关是否存在任何错误的报告。
规范
下表列出了此类型的所有可用属性:
| 属性 | 类型 | 说明 |
|---|---|---|
| 商家 | Organization 或 Person | (必需)接受订单的一方(例如,Amazon.com 是许多卖家的商家)。也接受字符串(例如“Amazon.com”)。 |
| 商人.名称 | 文本 | (必填)组织名称。 |
| 商户.相同 | 网址 | 商家的 Freebase 网址。 |
| orderNumber | 文本 | (必填)交易的商户特定标识符。 |
| priceCurrency | 文本 | (必填)订单价格的货币(采用 3 个字母的 ISO 4217 格式)。 |
| 价格 | 号码或短信 | (必填)整个交易的总价。 |
| acceptedOffer | 优惠 | (必填)订单中包含的优惠。还接受对象数组。 |
| 已接受报价.已提供物品 | 产品 或 预订 | (必填)待售商品。 |
| acceptedOffer.itemOffered.name | 文本 | (必填)产品名称。 |
| acceptedOffer.itemOffered.sku | 文本 | (推荐用于确认卡/搜索答案)库存单位 (SKU),即商家对产品或服务的特定标识符,或报价所指的产品。 |
| acceptedOffer.itemOffered.url | 网址 | (推荐用于确认卡/搜索答案)产品网址,通常是商家网站上的产品着陆页。 |
| acceptedOffer.itemOffered.图片 | 网址 | (推荐用于确认卡/搜索答案)产品图片的 网址,通常是商家网站上的图片。 |
| acceptedOffer.itemOffered.颜色 | 文本 | 产品的颜色。 |
| 已接受报价。价格 | 号码或短信 | (required)产品的单价。 |
| 已接受报价.价格货币 | 文本 | (必填)价格的货币(采用 3 个字母的 ISO 4217 格式)。 |
| 已接受报价.符合条件的数量 | QuantitativeValue | (required)报价或价格规格有效的订购数量的区间和计量单位。 |
| acceptedOffer.eligibleQuantity.value | 数字 | (必填)产品特性值。 |
| 已接受报价。价格规格 | PriceSpecification | 一份或多份详细的价格说明,注明单价和运费或手续费。 |
| 已接受报价.价格规格.价格 | 号码或短信 | 整个交易的总价。 |
| 已接受报价.价格规格.价格货币 | 文本 | 订单价格的货币(采用 ISO 4217 三字母格式)。 |
| 已接受报价。商品状况 | OfferItemCondition | 商品或服务状况的文字说明,或优惠中包含的商品或服务。 |
| acceptedOffer.seller | Organization 或 Person | 下单方。也接受字符串(例如“”“)。 |
| acceptedOffer.seller.name | 文本 | 组织名称。 |
| priceSpecification | PriceSpecification | (建议用于确认卡片/Google 搜索答案)比 price/priceCurrency 更详细的替代方案。还用于指定税费和送货费用。还接受对象数组。 |
| 网址 | 网址 | (建议用于确认卡片/Google 搜索答案)订单的网址,通常是指向商家网站的链接,用户可以在该网站上检索有关订单的更多详细信息。 |
| orderStatus | OrderStatus | (建议用于确认卡片/Google 搜索答案)订单的当前状态。 |
| paymentMethod | PaymentMethod | 订单所用信用卡或其他付款方式的名称。 |
| paymentMethodId | 文本 | 所用付款方式的标识符(例如信用卡的最后 4 位数字)。 |
| orderDate | DateTime | 下单日期。 |
| isGift | 布尔值 | 该报价是否被当作礼物送给了买家以外的其他人? |
| discount | 号码或短信 | 已应用任何折扣。 |
| discountCurrency | 文本 | 折扣的货币(采用 ISO 4217 三字母格式)。 |
| 客户 | 个人 或 组织 | 下单方。 |
| 客户.姓名 | 文本 | 人员姓名。 |
| billingAddress | PostalAddress | 订单的账单地址。 |
| 账单地址.名称 | 文本 | PostalAddress 的名称。 |
| 账单地址.街道地址 | 文本 | 街道地址。例如,1600 Amphitheatre Pkwy。 |
| 账单地址.地址位置 | 文本 | 地点。例如,山景城。 |
| billingAddress.addressRegion | 文本 | 地区。例如,CA。 |
| billingAddress.addressCountry | 文本或国家/地区 | 国家/地区。例如,美国。您也可以提供由 2 个字母表示的 ISO 3166-1 alpha-2 国家/地区代码。 |