תרחישים לדוגמה
בדוגמאות הבאות מופיעים תרחישי שימוש נפוצים בסכימה BusReservation. הדוגמאות האלה יעזרו לכם לוודא שהתגי עיצוב מובְנים בצורה נכונה.
אישור הזמנה בסיסי
כששולחים אישור הזמנה, מטמיעים את תגי ה-markup הבאים באימייל.
אפליקציית Google תציג את פרטי ההזמנה ביום הנסיעה ותשלח למשתמש הודעה על זמן לצאת כדי להגיע לתחנת האוטובוס בזמן (בהתחשב באמצעי התחבורה, בתנועה וכו'). אם תספקו כתובת URL לביצוע צ'ק-אין כמו בדוגמה שלמטה, אפליקציית Google תציג אותה למשתמש 24 שעות לפני הנסיעה.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": {
"@type": "Organization",
"name": "Bolt NYC"
},
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
}
}
</script>
מיקרו נתונים
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<div itemprop="busCompany" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt NYC"/>
</div>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
</div>
כרטיס עלייה למטוס וכרטיס
בנוסף לאישור ההזמנה, יכול להיות שתקבלו כרטיס עלייה למטוס ככרטיס אישור באימייל נפרד.
כרטיסי אישור יכולים לעזור למשתמש להגיע לתחנת האוטובוס בזמן, וגם להציג לו את הכרטיס במהלך הנסיעה. לשם כך, צריך לכלול בתגי העיצוב כמה שדות נוספים. אם יש שדות נוספים שצריך למלא כדי להעלות נוסעים למטוס, צריך לכלול אותם בשדה additionalTicketText.
לכרטיסים ללא מקומות ישיבה שמורים, השדות האלה הם : numSeats, ticketNumber, ticketToken
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": "Bolt NYC",
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"underName": "John Smith",
"ticketNumber": "123XYZ",
"ticketToken": "aztecCode:AB34",
"additionalTicketText": "We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."
}
}
</script>
מיקרו נתונים
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="busCompany" content="Bolt NYC"/>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="underName" content="John Smith"/>
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="ticketToken" content="aztecCode:AB34"/>
<meta itemprop="additionalTicketText" content="We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."/>
</div>
</div>
לכרטיסים עם מקומות שמורים, השדות האלה הם : seatNumber, seatingType, ticketNumber, ticketToken
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": "Bolt NYC",
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"underName": "John Smith",
"ticketedSeat": {
"@type": "Seat",
"seatNumber": "27B",
"seatingType": "Coach"
},
"ticketNumber": "123XYZ",
"ticketToken": "aztecCode:AB34",
"additionalTicketText": "We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."
}
}
</script>
מיקרו נתונים
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="busCompany" content="Bolt NYC"/>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="underName" content="John Smith"/>
<div itemprop="ticketedSeat" itemscope itemtype="http://schema.org/Seat">
<meta itemprop="seatNumber" content="27B"/>
<meta itemprop="seatingType" content="Coach"/>
</div>
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="ticketToken" content="aztecCode:AB34"/>
<meta itemprop="additionalTicketText" content="We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."/>
</div>
</div>
דוגמה עם כל השדות הנתמכים
לעיון, הנה דוגמה עם כל השדות הנתמכים שמולאו:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"url": "http://boltbus.com/view/123456",
"underName": {
"@type": "Person",
"name": "John Smith",
"email": "john@mail.com"
},
"programMembership": {
"@type": "ProgramMembership",
"memberNumber": "12345",
"program": "STA"
},
"bookingAgent": {
"@type": "Organization",
"name": "Bolt Bus NYC",
"url": "http://boltbus.com/"
},
"bookingTime": "2013-01-14T13:05:00-05:00",
"modifiedTime": "2013-03-14T13:05:00-05:00",
"confirmReservationUrl": "http://boltbus.com/confirm?id=123456",
"cancelReservationUrl": "http://boltbus.com/cancel?id=123456",
"modifyReservationUrl": "http://boltbus.com/edit?id=123456",
"checkinUrl": "http://boltbus.com/checkin?id=AB3XY2",
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"name": "?",
"busNumber": "63",
"busName": "Bolt Bus NY:Boston",
"busCompany": {
"@type": "Organization",
"name": "Bolt NYC"
},
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC",
"address": {
"@type": "PostalAddress",
"streetAddress": "625 8th Avenue",
"addressLocality": "New York",
"addressRegion": "NY",
"postalCode": "10018",
"addressCountry": "USA"
},
"directions": "Bus terminals are at floors 2-4 of the Port Authority building"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station",
"address": {
"@type": "PostalAddress",
"streetAddress": "Summer St.",
"addressLocality": "Boston",
"addressRegion": "MA",
"postalCode": "02111",
"addressCountry": "USA"
},
"directions": "Bus stops are at thewest side of the train station."
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"ticketNumber": "123XYZ",
"downloadUrl": "?",
"printUrl": "?",
"ticketToken": "qrCode:123456789",
"additionalTicketText": "?",
"price": "45.00",
"priceCurrency": "USD",
"underName": {
"@type": "Person",
"name": "Mary Smith"
},
"ticketedSeat": {
"@type": "Seat",
"seatingType": "Coach",
"seatNumber": "27",
"seatRow": "A"
}
}
}
</script>
מיקרו נתונים
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<link itemprop="url" href="http://boltbus.com/view/123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
<meta itemprop="email" content="john@mail.com"/>
</div>
<div itemprop="programMembership" itemscope itemtype="http://schema.org/ProgramMembership">
<meta itemprop="memberNumber" content="12345"/>
<meta itemprop="program" content="STA"/>
</div>
<div itemprop="bookingAgent" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt Bus NYC"/>
<link itemprop="url" href="http://boltbus.com/"/>
</div>
<meta itemprop="bookingTime" content="2013-01-14T13:05:00-05:00"/>
<meta itemprop="modifiedTime" content="2013-03-14T13:05:00-05:00"/>
<link itemprop="confirmReservationUrl" href="http://boltbus.com/confirm?id=123456"/>
<link itemprop="cancelReservationUrl" href="http://boltbus.com/cancel?id=123456"/>
<link itemprop="modifyReservationUrl" href="http://boltbus.com/edit?id=123456"/>
<link itemprop="checkinUrl" href="http://boltbus.com/checkin?id=AB3XY2"/>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="name" content="?"/>
<meta itemprop="busNumber" content="63"/>
<meta itemprop="busName" content="Bolt Bus NY:Boston"/>
<div itemprop="busCompany" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt NYC"/>
</div>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="625 8th Avenue"/>
<meta itemprop="addressLocality" content="New York"/>
<meta itemprop="addressRegion" content="NY"/>
<meta itemprop="postalCode" content="10018"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<meta itemprop="directions" content="Bus terminals are at floors 2-4 of the Port Authority building"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="Summer St."/>
<meta itemprop="addressLocality" content="Boston"/>
<meta itemprop="addressRegion" content="MA"/>
<meta itemprop="postalCode" content="02111"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<meta itemprop="directions" content="Bus stops are at thewest side of the train station."/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="downloadUrl" content="?"/>
<meta itemprop="printUrl" content="?"/>
<meta itemprop="ticketToken" content="qrCode:123456789"/>
<meta itemprop="additionalTicketText" content="?"/>
<meta itemprop="price" content="45.00"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="Mary Smith"/>
</div>
<div itemprop="ticketedSeat" itemscope itemtype="http://schema.org/Seat">
<meta itemprop="seatingType" content="Coach"/>
<meta itemprop="seatNumber" content="27"/>
<meta itemprop="seatRow" content="A"/>
</div>
</div>
</div>
בדיקת תגי העיצוב
אתם יכולים לאמת את תגי העיצוב באמצעות הכלי לבדיקת תגי עיצוב של אימיילים. מדביקים את קוד התיוג ולוחצים על הלחצן אימות כדי לסרוק את התוכן ולקבל דוח על שגיאות שקיימות בו.
מפרט
כדאי לעיין בפרטי האימייל כדי לראות אם אחת מהתכונות האלה רלוונטית להזמנת הכרטיס לאוטובוס. סימון המאפיינים הנוספים האלה מאפשר ל-Google להציג למשתמש תיאור עשיר יותר של הזמנת הכרטיס לאוטובוס.
| נכס | סוג | תיאור |
|---|---|---|
| reservationNumber | טקסט | (חובה) המספר או המזהה של ההזמנה. |
| כתובת אתר | כתובת URL | דף אינטרנט שבו אפשר לראות את ההזמנה. |
| underName | אדם או ארגון | (required) הנוסע. |
| underName.name | טקסט | (חובה) שם האדם. |
| underName.email | טקסט | כתובת אימייל. |
| programMembership | ProgramMembership | חברות במועדון נוסע מתמיד, בתוכנית נאמנות של בתי מלון וכו' שרלוונטית להזמנה. |
| programMembership.memberNumber | טקסט | המזהה של המינוי. |
| programMembership.program | טקסט | שם התוכנית. |
| bookingAgent | ארגון או אדם | סוכן נסיעות או סוכנות נסיעות. אפשר גם להזין מחרוזת (למשל ""). |
| bookingAgent.name | טקסט | שם הסוכן או השירות. |
| bookingAgent.url | כתובת URL | האתר של הסוכן או השירות. |
| bookingTime | DateTime | התאריך שבו בוצעה ההזמנה. |
| modifiedTime | DateTime | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) השעה שבה בוצע השינוי האחרון בהזמנה. |
| confirmReservationUrl | כתובת URL | דף האינטרנט שבו אפשר לאשר את ההזמנה. |
| cancelReservationUrl | כתובת URL | דף אינטרנט שבו אפשר לבטל את ההזמנה. |
| modifyReservationUrl | כתובת URL | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) דף אינטרנט שבו אפשר לשנות את ההזמנה. |
| checkinUrl | כתובת URL | דף האינטרנט שבו הנוסעים יכולים לבצע צ'ק-אין. |
| reservationStatus | ReservationStatus | (חובה) הסטטוס הנוכחי של ההזמנה. |
| reservationFor | BusTrip | (חובה) מידע על הנסיעה באוטובוס. |
| reservationFor.name | טקסט | שם הנסיעה באוטובוס. |
| reservationFor.busNumber | טקסט | לדוגמה, 101. |
| reservationFor.busName | טקסט | לדוגמה, Bolt Express. |
| reservationFor.busCompany | ארגון | (חובה) לדוגמה: Bolt NYC. אפשר להזין גם מחרוזת (למשל, Bolt NYC). |
| reservationFor.busCompany.name | טקסט | (חובה) שם הארגון. |
| reservationFor.departureBusStop | BusStop או BusStation | (חובה) המקום שממנו האוטובוס יוצא. |
| reservationFor.departureBusStop.name | טקסט | (required) שם תחנת האוטובוס. |
| reservationFor.departureBusStop.address | PostalAddress | הכתובת של תחנת האוטובוס או התחנה שממנה יוצאים. |
| reservationFor.departureBusStop.address.streetAddress | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) כתובת הרחוב של תחנת האוטובוס או הרכבת שממנה יוצאים. |
| reservationFor.departureBusStop.address.addressLocality | טקסט | (מומלץ לכרטיסי אישור ולתשובות בחיפוש) רשות מוניציפאלית (למשל העיר) של תחנת האוטובוס או הרכבת שממנה יוצאים. |
| reservationFor.departureBusStop.address.addressRegion | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) האזור (לדוגמה, מדינה) של תחנת האוטובוס או הרכבת שמהן יוצאים. |
| reservationFor.departureBusStop.address.postalCode | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) מיקוד של תחנת האוטובוס או הרכבת שממנה יוצאים. |
| reservationFor.departureBusStop.address.addressCountry | טקסט או מדינה | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) המדינה שבה נמצאת תחנת האוטובוס או הרכבת שממנה יוצאים. |
| reservationFor.departureBusStop.directions | טקסט | הוראות הגעה לתחנת האוטובוס. |
| reservationFor.departureTime | DateTime | (חובה) שעת היציאה של האוטובוס. |
| reservationFor.arrivalBusStop | BusStop או BusStation | (חובה) המקום שאליו האוטובוס מגיע. |
| reservationFor.arrivalBusStop.name | טקסט | (חובה) שם תחנת האוטובוס. |
| reservationFor.arrivalBusStop.address | PostalAddress | הכתובת של תחנת האוטובוס או התחנה שבה מגיעים. |
| reservationFor.arrivalBusStop.address.streetAddress | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) כתובת הרחוב של תחנת האוטובוס או הרכבת שאליה מגיעים. |
| reservationFor.arrivalBusStop.address.addressLocality | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) היישוב (למשל עיר) של תחנת האוטובוס או הרכבת של ההגעה. |
| reservationFor.arrivalBusStop.address.addressRegion | טקסט | (מומלץ לכרטיסי אישור/תשובות לחיפוש) האזור (לדוגמה, מדינה) של תחנת האוטובוס או הרכבת של ההגעה. |
| reservationFor.arrivalBusStop.address.postalCode | טקסט | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) מיקוד של תחנת האוטובוס או הרכבת של ההגעה. |
| reservationFor.arrivalBusStop.address.addressCountry | טקסט או מדינה | (מומלץ לכרטיסי אישור או לתשובות בחיפוש) המדינה שבה נמצאת תחנת האוטובוס או הרכבת של ההגעה. |
| reservationFor.arrivalBusStop.directions | טקסט | הוראות הגעה לתחנת האוטובוס. |
| reservationFor.arrivalTime | DateTime | (required) זמן ההגעה של האוטובוס. |
| reservedTicket | כרטיס | מידע על הכרטיס. |
| reservedTicket.ticketNumber | טקסט | המספר או המזהה של הכרטיס. |
| reservedTicket.downloadUrl | כתובת URL | . |
| reservedTicket.printUrl | כתובת URL | . |
| reservedTicket.ticketToken | טקסט או כתובת אתר | אם תמונת הברקוד מתארחת באתר שלכם, הערך של השדה הוא כתובת ה-URL של התמונה, או URI של ברקוד או קוד QR, כמו barcode128:AB34 (ברקודים מסוג ISO-15417), qrCode:AB34 (קודי QR), aztecCode:AB34 (קודי Aztec), barcodeEAN:1234 (קודי EAN) ו-barcodeUPCA:1234 (קודי UPCA). |
| reservedTicket.additionalTicketText | טקסט | טקסט הסבר נוסף לגבי הכרטיס. |
| reservedTicket.price | טקסט | המחיר הכולל של הכרטיס. |
| reservedTicket.priceCurrency | טקסט | המטבע (בפורמט ISO 4217 בן 3 אותיות) של מחיר הכרטיס. |
| reservedTicket.underName | אדם או ארגון | האדם או הארגון שהכרטיס מיועד להם. |
| reservedTicket.underName.name | טקסט | שם האדם. |
| reservedTicket.ticketedSeat | מושב | המיקום של המושב המוזמן (לדוגמה, 27B). . |
| reservedTicket.ticketedSeat.seatingType | טקסט | סוג או מחלקה של המושב. |
| reservedTicket.ticketedSeat.seatNumber | טקסט | המיקום של המושב המוזמן. |
| reservedTicket.ticketedSeat.seatRow | טקסט | המיקום של השורה של המושב המוזמן. |