הזמנה היא אישור של עסקה (קבלה), שיכולה להכיל כמה פריטים, שכל אחד מהם מיוצג על ידי תג 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>
הצגת פעולות שקשורות להזמנה
אפשר להוסיף כפתור View Order (הצגת ההזמנה) להזמנות על ידי הגדרת המאפיין 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>
בדיקת תגי העיצוב
אתם יכולים לאמת את תגי העיצוב באמצעות הכלי לבדיקת תגי עיצוב לאימייל. מדביקים את קוד התיוג ולוחצים על הלחצן אימות כדי לסרוק את התוכן ולקבל דוח על שגיאות שקיימות בו.
מפרט
בטבלה הבאה מפורטים כל המאפיינים שזמינים לסוג הזה:
| נכס | סוג | תיאור |
|---|---|---|
| מוֹכר | ארגון או אדם | (חובה) הצד שמקבל את ההזמנה (לדוגמה, Amazon.com היא מוכרת עבור מוכרים רבים). אפשר גם להזין מחרוזת (למשל, Amazon.com). |
| merchant.name | טקסט | (חובה) שם הארגון. |
| merchant.sameAs | כתובת URL | כתובת ה-URL של המוֹכר ב-Freebase. |
| orderNumber | טקסט | (חובה) המזהה הספציפי לעסק של העסקה. |
| priceCurrency | טקסט | (חובה) המטבע (בפורמט ISO 4217 של 3 אותיות) של מחיר ההזמנה. |
| price | מספר או טקסט | (required) המחיר הכולל של העסקה כולה. |
| acceptedOffer | מבצע | (חובה) המבצעים שכלולים בהזמנה. אפשר גם להזין מערך של אובייקטים. |
| acceptedOffer.itemOffered | מוצר או הזמנה | (required) הפריט שנמכר. |
| acceptedOffer.itemOffered.name | טקסט | (חובה) שם המוצר. |
| acceptedOffer.itemOffered.sku | טקסט | (מומלץ לכרטיסי אישור הזמנה ולתשובות בחיפוש Google) מספר קטלוגי (מק"ט), כלומר מזהה ספציפי למוצר או לשירות, או המוצר שאליו מתייחסת המבצע. |
| acceptedOffer.itemOffered.url | כתובת URL | (מומלץ לכרטיסי אישור/תשובות בחיפוש) כתובת ה-URL של המוצר, בדרך כלל דף הנחיתה של המוצר באתר של המוכר. |
| acceptedOffer.itemOffered.image | כתובת URL | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) כתובת URL של תמונה של המוצר, בדרך כלל תמונה באתר של המוכר. |
| acceptedOffer.itemOffered.color | טקסט | צבע המוצר. |
| acceptedOffer.price | מספר או טקסט | (required) מחיר היחידה של המוצר. |
| acceptedOffer.priceCurrency | טקסט | (חובה) המטבע (בפורמט ISO 4217 של 3 אותיות) של המחיר. |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (required) המרווח ויחידת המידה של הכמויות להזמנה שעליהן חל המבצע או המחיר. |
| acceptedOffer.eligibleQuantity.value | מספר | (חובה) הערך של מאפיין המוצר. |
| acceptedOffer.priceSpecification | PriceSpecification | מפרט מחיר מפורט אחד או יותר, שכולל את המחיר ליחידה ואת עלויות המשלוח או התשלום. |
| acceptedOffer.priceSpecification.price | מספר או טקסט | המחיר הכולל של העסקה כולה. |
| acceptedOffer.priceSpecification.priceCurrency | טקסט | המטבע (בפורמט ISO 4217 בן 3 אותיות) של מחיר ההזמנה. |
| acceptedOffer.itemCondition | OfferItemCondition | תיאור מילולי של מצב המוצר או השירות, או של המוצרים או השירותים שכלולים במבצע. |
| acceptedOffer.seller | ארגון או אדם | הצד שאליו נשלחה ההזמנה. אפשר גם להזין מחרוזת (למשל, ""). |
| acceptedOffer.seller.name | טקסט | שם הארגון. |
| priceSpecification | PriceSpecification | (מומלץ לכרטיסי אישור/תשובות בחיפוש) חלופות מפורטות יותר לערכים price או priceCurrency. המאפיין משמש גם לציון מיסי משלוח ודמי משלוח. אפשר גם להזין מערך של אובייקטים. |
| url | כתובת URL | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) כתובת ה-URL של ההזמנה, בדרך כלל קישור לאתר של המוכר שבו המשתמש יכול לקבל פרטים נוספים על ההזמנה. |
| orderStatus | OrderStatus | (מומלץ לכרטיסי אישור/תשובות בחיפוש) הסטטוס הנוכחי של ההזמנה. |
| paymentMethod | PaymentMethod | השם שמופיע על כרטיס האשראי או אמצעי התשלום האחר שמשמש להזמנה. |
| paymentMethodId | טקסט | מזהה של אמצעי התשלום שבו נעשה שימוש (למשל, 4 הספרות האחרונות של כרטיס האשראי). |
| orderDate | DateTime | התאריך שבו בוצעה ההזמנה. |
| isGift | בוליאני | האם ההצעה התקבלה כמתנה למישהו אחר ולא לקונה. |
| discount | מספר או טקסט | כל הנחה שחלה. |
| discountCurrency | טקסט | המטבע (בפורמט ISO 4217 בן 3 אותיות) של ההנחה. |
| לקוח | אדם או ארגון | הצד שמבצע את ההזמנה. |
| customer.name | טקסט | שם האדם. |
| billingAddress | PostalAddress | הכתובת לחיוב של ההזמנה. |
| billingAddress.name | טקסט | שם ה-PostalAddress. |
| billingAddress.streetAddress | טקסט | כתובת הרחוב. לדוגמה, 1600 Amphitheatre Pkwy. |
| billingAddress.addressLocality | טקסט | היישוב. לדוגמה, מאונטיין ויו. |
| billingAddress.addressRegion | טקסט | האזור. לדוגמה, CA. |
| billingAddress.addressCountry | טקסט או מדינה | המדינה. לדוגמה, USA. אפשר גם לציין את קוד המדינה בן שתי האותיות לפי תקן ISO 3166-1 alpha-2. |