Ticket option description allow multiple ticket types to be listed under the same service but are grouped together by a shared attribute. For example, tour languages and/or add-ons can be specified as ticket options using the option description. When a user selects an option, all of their tickets must be purchased under that option (for example, they would not be able to buy one tour under English and another in Spanish).
When to use ticket options
Ticket options allow users to select from a list of options or add-ons that are applicable to an order. The options selected should apply to all tickets in that order.
Examples of ticket options
- Rental duration (1h, 2h, ...)
- Language selection for audio guide for the tour (e.g. English Audio Guide, Spanish Audio Guide, Chinese Audio Guide)
- Add-ons
- Temporary exposition of a museum
- Meal option
- Transportation
- Audio guide
Examples of incorrect usage of ticket options
- Pick up location: Use intake form instead
- Time of departure: Use availability instead
- General information about the experience: Use service description instead
If your use case is not clearly included in the list of use cases supported by ticket options, please ask your Google contact.
How to implement ticket options
- Set ServiceFeed.service.ticket_type.localized_option_description, it will be used as the matching key to gather multiple ticket types under the same option radio button. The option description supports HTML markup (check the example below).
When the user clicks on the radio button representing this localized_option_description (localized), the front-end will only display all the available ticket types that have the selected localized_option_description value.
Guidelines
- ServiceFeed.service.localized_description must explain in detail the limitations and differences between the different options.
- ServiceFeed.service.tours_and_activities_content must only include information that is valid for all options.
Example
In this example, the "Future and Beyond Museum" provides audio guided tours. This option can be either in English or in French.
Feed Snippet
Service
"service": [
{
"service_id": "975275",
"merchant_id": "146382",
"localized_service_name": {
"value": "F&B Museum Admissions",
"localized_value": [
{
"locale": "en",
"value": "F&B Museum Admissions"
},
{
"locale": "fr",
"value": "Admissions au musée F&B"
}
]
},
"localized_description": {
"value": "Bring your family and friends to see the latest and greatest technology. Admissions to the Future and Beyond Museum will guarantee a fun and educational experience.<br/><em>If you selected the option \"Audio Guide: French\" or \"Audio Guide: English\" you will be provided with the audio guide equipment at the distribution counter. This equipment will provide audio explanation of the expositions for a total of about 1 hour of audio descriptions. It will allow you to conduct a self-guided tour following the instruction provided by the Audio Guide.<br/>The language of \"Audio Guide: French\" is Metropolitan French and the language of the \"Audio Guide: English\" is American English<br/>If you selected \"No Audio Guide\", no equipment will be provided at the counter</em>",
"localized_value": [
{
"locale": "en",
"value": "Bring your family and friends to see the latest and greatest technology. Admissions to the Future and Beyond Museum will guarantee a fun and educational experience.<br/><em>If you selected the option \"Audio Guide: French\" or \"Audio Guide: English\" you will be provided with the audio guide equipment at the distribution counter. This equipment will provide audio explanation of the expositions for a total of about 1 hour of audio descriptions. It will allow you to conduct a self-guided tour following the instruction provided by the Audio Guide.<br/>The language of \"Audio Guide: French\" is Metropolitan French and the language of the \"Audio Guide: English\" is American English<br/>If you selected \"No Audio Guide\", no equipment will be provided at the counter</em>"
},
{
"locale": "fr",
"value": "Amenez votre famille et vos amis pour découvrir les technologies les plus récentes et les plus impressionnantes. La visite du Future and Beyond Museum garantira une expérience amusante et éducative.<br/><em>Si vous avez sélectionné l'option \"Audioguide: Français\" ou \"Audioguide: Anglais\", vous recevrez un appareil audio au guichet. Cet appareil vous fournira des explication audio à propos de l'exposition pour une durée totale d'environ 1 heure. Ceci vous permettra de faire une visite auto-guidée du musée en suivant les instructions de l'appareil.<br/>La langue pour l'option \"Audioguide: Français\" est le français métropolitain et le langage pour l'option \"Audioguide: Anglais\" est l'anglais américain<br/>Si vous avez sélectionné \"Sans audioguide\", vous ne recevrez aucun appareil au guichet</em>"
}
]
},
"ticket_type": [
{
"ticket_type_id": "2003-1",
"localized_short_description": {
"value": "Adult: Age: 13 - 64",
"localized_value": [...]
},
"price": {
"price_micros": 45000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit",
"localized_value": [
{
"locale": "en",
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit"
},
{
"locale": "fr",
"value": "<em>Sans audioguide</em><br/>Visite auto-guidée standard"
}
]
}
},
{
"ticket_type_id": "2004-1",
"localized_short_description": {
"value": "Reduced Ticket: Seniors 65+ and Students with a student ID",
"localized_value": [...]
},
"price": {
"price_micros": 25000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit",
"localized_value": [
{
"locale": "en",
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit"
},
{
"locale": "fr",
"value": "<em>Sans audioguide</em><br/>Visite auto-guidée standard"
}
]
}
},
{
"ticket_type_id": "2005-1",
"localized_short_description": {
"value": "Child: Age: 6 - 12",
"localized_value": [...]
},
"price": {
"price_micros": 20000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit",
"localized_value": [
{
"locale": "en",
"value": "<em>No Audio Guide</em><br/>Standard self-guided visit"
},
{
"locale": "fr",
"value": "<em>Sans audioguide</em><br/>Visite auto-guidée standard"
}
]
}
},
{
"ticket_type_id": "2003-2",
"localized_short_description": {
"value": "Adult: Age: 13 - 64",
"localized_value": [...]
},
"price": {
"price_micros": 60000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English"
},
{
"locale": "fr",
"value": "<em>Audioguide: Anglais</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en anglais"
}
]
}
},
{
"ticket_type_id": "2004-2",
"localized_short_description": {
"value": "Reduced Ticket: Seniors 65+ and Students with a student ID",
"localized_value": [...]
},
"price": {
"price_micros": 35000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English"
},
{
"locale": "fr",
"value": "<em>Audioguide: Anglais</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en anglais"
}
]
}
},
{
"ticket_type_id": "2005-2",
"localized_short_description": {
"value": "Child: Age: 6 - 12",
"localized_value": [...]
},
"price": {
"price_micros": 30000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: English</em><br/>Standard self guided visit + about 1 hour audio guide commentary in English"
},
{
"locale": "fr",
"value": "<em>Audioguide: Anglais</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en anglais"
}
]
}
},
{
"ticket_type_id": "2003-3",
"localized_short_description": {
"value": "Adult: Age: 13 - 64",
"localized_value": [...]
},
"price": {
"price_micros": 60000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French"
},
{
"locale": "fr",
"value": "<em>Audioguide: Français</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en français"
}
]
}
},
{
"ticket_type_id": "2004-3",
"localized_short_description": {
"value": "Reduced Ticket: Seniors 65+ and Students with a student ID",
"localized_value": [...]
},
"price": {
"price_micros": 35000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French"
},
{
"locale": "fr",
"value": "<em>Audioguide: Français</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en français"
}
]
}
},
{
"ticket_type_id": "2005-3",
"localized_short_description": {
"value": "Child: Age: 6 - 12",
"localized_value": [...]
},
"price": {
"price_micros": 30000000,
"currency_code": "USD"
},
"localized_option_description": {
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French",
"localized_value": [
{
"locale": "en",
"value": "<em>Audio Guide: French</em><br/>Standard self guided visit + about 1 hour audio guide commentary in French"
},
{
"locale": "fr",
"value": "<em>Audioguide: Français</em><br/>Visite auto-guidée standard + environ 1 heure de commentaires audio en français"
}
]
}
}
],
[...],
"tours_and_activities_content": { // Must apply to all options
"highlights": [...],
"inclusions": [...],
"exclusions": [...],
"must_know": [...]
}
}
]
Result
