Dane strukturalne dotyczące ceny hotelu

Na tej stronie znajdziesz specyfikację techniczną i słownik znaczników danych strukturalnych hoteli w standardzie schema.org.

Uwaga: aby wdrożyć w witrynie automatyczną weryfikację dokładności cen za pomocą tagowania nawigacji i mikrodanych, zapoznaj się z przewodnikiem po nawigacji robota i tagowaniu cen.

Przegląd

Dane strukturalne dotyczące cen hoteli zapewniają standardowy format zrozumiały dla komputerów, który umożliwia wyjaśnianie, weryfikowanie i wyświetlanie cen hoteli podanych w Twojej witrynie, niezależnie od układu wizualnego. Obejmuje to ceny podstawowe, stawki, specyfikacje pokoju, wyszczególnione opłaty i podatki oraz zasady rezerwacji.

Aby dokładnie wyodrębniać ceny ze stron internetowych, zalecamy dodawanie do nich standardowych danych strukturalnych udostępnianych przez Schema.org.

Standardowe dane strukturalne umożliwiają skalowanie weryfikacji dokładności cen poprzez zwiększanie niezawodności robotów, zwiększanie liczby weryfikacji dokładności cen, umożliwianie bezpośredniego debugowania problemów z dokładnością cen i utrzymywanie stałego wyniku dokładności cen.

Uwaga: odpowiedzi na ogólne pytania dotyczące skrobania i indeksowania znajdziesz w artykule Najczęstsze pytania o indeksowanie i skanowanie w wyszukiwarce Google.

Jeśli dopiero zaczynasz, dowiedz się więcej o słownictwie i formacie uporządkowanych danych.

W przypadku sprawdzania dokładności cen hoteli w Google Hotels domyślnie zalecany jest format mikrodanych do oznaczania stron internetowych. Format JSON-LD jest wycofany w przypadku sprawdzania dokładności ceny. Pamiętaj, że ta rekomendacja dotyczy wyłącznie weryfikacji dokładności cen hoteli i nie ma wpływu na inne zastosowania danych strukturalnych w Google (np. wyniki z elementami rozszerzonymi w wyszukiwarce Google). Więcej informacji o formatach obsługiwanych w przypadku ogólnych funkcji wyszukiwania znajdziesz w sekcji obsługiwane formaty. Ta dokumentacja zawiera szczegółowe informacje referencyjne dotyczące implementacji uporządkowanych danych w przypadku hoteli.

Ważne: mikrodane to domyślny i zalecany format, szczególnie w przypadku weryfikacji dokładności cen hoteli. JSON-LD została wycofana w przypadku weryfikacji ceny hotelu i jest zachowana tylko do celów referencyjnych.

Uporządkowane dane Hotel służą do oznaczania pól związanych z hotelem na stronie internetowej. Uporządkowane dane Hotel mają te właściwości:

• Właściwości name i address

• makesOffer usługa

• Hotel priceSpecification usługa

• hasMerchantReturnPolicy usługa

• eligibleCustomerType usługa

dane strukturalne HotelRoom służą do dodawania adnotacji do pól dotyczących pokoju na stronie internetowej.

Ważne: zalecamy podanie cen pokoi, jeśli to możliwe.

Uporządkowane dane HotelRoom mają te właściwości:

• offers usługa

• Właściwości bed i occupancy

• HotelRoom priceSpecification usługa

• includesObject usługa

• availability usługa

• amenityFeature usługa

Atrybuty nawigacji służą do wyjaśniania robotom elementów interaktywnych i stanów strony. Więcej informacji znajdziesz w artykule o tagowaniu nawigacji.

Uporządkowane dane dotyczące hotelu

W przypadku elementu Hotel stosuje się poniższe właściwości.

name i address

Właściwości name i address służą do dodawania adnotacji do nazwy i lokalizacji hotelu. Właściwości name i address:

  "@type": "Hotel",
    "name": "hotel-name",
    "identifier": "hotel-id-1234",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "XX",
      "addressLocality": "City Name",
      "addressRegion": "State Name",
      "postalCode": "01234",
      "streetAddress": "1234 Main St."
    },

Składnia

Właściwości name i address używają tej składni:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">1234 Main St.</span>,
    <span itemprop="addressLocality">City Name</span>,
    <span itemprop="addressRegion">State Name</span>
    <span itemprop="postalCode">01234</span>
    <span itemprop="addressCountry">XX</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "XX",
    "addressLocality": "City Name",
    "addressRegion": "State Name",
    "postalCode": "01234",
    "streetAddress": "1234 Main St."
  },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"]
    ...
  }
}

Ważne: jeśli zdecydujesz się określić właściwość address, pola typu PostalAddress, takie jak addressCountry, postalCode, streetAddress i inne, są obowiązkowe.

Właściwości

Właściwości name i address:

Właściwość	Wymagany?	Typ	Opis
Hotel.name	Required	string	Nazwa hotelu
Hotel.identifier	Required	string	Identyfikator hotelu partnera. Identyfikator musi być niepowtarzalnym ciągiem znaków dla każdego hotelu i dokładnie odpowiadać ciągowi znaków używanemu w pliku danych o cenach.
Hotel.address	Optional	PostalAddress	Adres lub lokalizacja hotelu.

Przykład imienia i nazwiska oraz adresu

Oto podstawowy przykład dodawania adnotacji name i address:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <h1 itemprop="name">Mountain Hotel</h1>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">Technikerstrasse 21</span>,
    <span itemprop="addressLocality">Innsbruck</span>,
    <span itemprop="addressRegion">Tyrol</span>
    <span itemprop="postalCode">6020</span>
    <span itemprop="addressCountry">AT</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "Mountain Hotel",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "AT",
    "addressLocality": "Innsbruck",
    "addressRegion": "Tyrol",
    "postalCode": "6020",
    "streetAddress": "Technikerstrasse 21"
  },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    }
  }
}

makesOffer miejsce zakwaterowania

Adnotacje makesOffer służą do oznaczania planów podróży do hoteli.

  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    ...
  }

Składnia

Właściwość makesOffer ma tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    Check-out: <time itemprop="checkoutTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    <meta itemprop="availability" content="https://schema.org/InStock"/>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      ...
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/InStock",
    "priceSpecification": { ... }
  }
}

Ważne: w usłudze makesOffer można uwzględnić wiele ofert na poziomie hotelu. Najpierw powinna być podana stawka wyświetlana w Google. Podana kwota ceny zawiera wszystkie obowiązujące podatki i opłaty.

Właściwości

Oto właściwości makesOffer:

Właściwość	Wymagany?	Typ	Opis
makesOffer	Required	Offer and LodgingReservation	Oferty hoteli dla danego planu podróży. Właściwość makesOffer może zawierać tablicę ofert.
LodgingReservation.checkinTime	Required	DateTime	Godzina zameldowania w strefie czasowej użytkownika. Jeśli Twoja strefa czasowa nie jest wymieniona, brana jest pod uwagę strefa czasowa hotelu.
LodgingReservation.checkoutTime	Required	DateTime	Godzina wymeldowania w strefie czasowej użytkownika. Jeśli Twoja strefa czasowa nie jest wymieniona, brana jest pod uwagę strefa czasowa hotelu.

Ważne: wartość @type dla wszystkich ofert powinna być tablicą zawierającą zarówno Offer, jak i LodgingReservation.

makesOffer – przykład

Oto podstawowy przykład adnotacji do ofert hoteli. Możesz określić wiele ofert dla planu podróży, ale najpierw podaj stawkę wyświetlaną w Google, a potem inne stawki. Podana kwota ceny zawiera wszystkie obowiązujące podatki.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">Mountain Hotel</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1200.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "Mountain Hotel",
  "identifier": "hotel-id-1234",
  "address": { ... },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    }
  ]
}

Hotel priceSpecification miejsce zakwaterowania

Ta właściwość służy do dodawania adnotacji do informacji o cenach hoteli lub pokoi hotelowych. Aby dodać adnotacje do cen i podatków, musisz podać 2 dodatkowe właściwości. Aby określić łączne informacje o cenach, takie jak stawka podstawowa, podatki i rabaty, użyj elementu CompoundPriceSpecification. Użyj UnitPriceSpecification, aby określić dodatkowe podatki lub specjalne rodzaje opłat, takie jak ResortFee, GenericTax i ServiceFee. Usługa priceSpecification jest połączona z usługą Offer.

Ważna informacja: właściwość potentialAction jest używana, gdy użytkownik musi zapłacić w hotelu podczas zameldowania zaległą kwotę lub inne opłaty.

  {
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      ]
    }
  }

Składnia

Właściwość Hotel priceSpecification ma tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name"></span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "name-of-the-business"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Właściwości

Oto właściwości hotel priceSpecification:

Właściwość	Wymagany?	Typ	Opis
Hotel.Offer.priceSpecification.price	Required	float	Łączna cena hotelu z podatkami i opłatami. Cena w Google powinna być zawsze oznaczona na stronie docelowej wraz ze wszystkimi szczegółami ceny. Dodawanie adnotacji do szczegółów stawek umożliwia przeprowadzanie kontroli dokładności cen. Google akceptuje ceny na poziomie hotelu i na poziomie pokoju.
Hotel.Offer.priceSpecification.priceCurrency	Required	currency	Trzyliterowy kod waluty określonej ceny. Np. "USD" .
Hotel.Offer.priceSpecification.priceComponent	Optional	UnitPriceSpecification[]	Szczegółowe zestawienie łącznej ceny hotelu, w tym podatki i opłaty. Istnieją 2 rodzaje danych strukturalnych dotyczących ceny: CompoundPriceSpecification podaje szczegółowe informacje o cenach, w tym: Cena podstawowa: podstawowa cena za noc. Podatki za pobyt: cena za noc z podatkami. Opłaty za osobę: cena za noc za osobę. Rabat: kwota odliczenia. UnitPriceSpecification służy do określania rodzaju opłat. Powinieneś podać wartości PriceComponentTypeEnumeration , aby określić dodatkowe opłaty. Wartości w polu PriceComponentTypeEnumeration to: Discount: ogólny rabat na cenę. ResortFee: jest to dodatkowa opłata, którą należy uiścić w hotelu. Może się różnić w zależności od typu obiektu noclegowego. GenericTax: jest to dodatkowy podatek różny od pozostałych. ServiceFee: jest to dodatkowa opłata pobierana przez kanał rezerwacji. TransferFee: jest to obowiązkowa opłata za transport do hotelu, pobierana przez hotel lub kanał rezerwacji. Wartości musisz ustawić we właściwości priceComponentType . Jeśli zdecydujesz się uwzględnić UnitPriceSpecification, wszystkie wartości są wymagane i muszą być określone we właściwości UnitPriceSpecification.
Hotel.Offer.priceSpecification.priceComponent. potentialAction	Optional	PayAction	Punkt płatności w hotelu.Procesy płatności w hotelu obejmują ceny, które są pobierane w momencie wymeldowania na stronie rezerwacji i w hotelu podczas zameldowania. Aby wskazać punkt płatności, użyj właściwości potentialAction , która jest dołączona do pola PayAction „recipient”. Więcej informacji o właściwości recipient znajdziesz w artykule PayAction. Google obsługuje te 2 ustawienia odbiorcy PayAction: recipient.@type = "OnlineBusiness" oznacza płatność pobraną w momencie rezerwacji przez sprzedawcę internetowego. Jest to ustawienie domyślne, jeśli nie podasz wartości potentialAction. recipient.@type = "Hotel" oznacza płatność pobieraną w hotelu.

Przykłady

Oto przykłady specyfikacji cen hoteli.

Cena

Oto podstawowy przykład dodawania danych strukturalnych dotyczących ceny do strony internetowej. Właściwość makesOffer może zawierać wiele ofert na poziomie hotelu.

Typy PostalAddress, takie jak addressCountry, postalCode, streetAddress i inne pola, są obowiązkowe, jeśli zdecydujesz się określić właściwość address. Stawka wyświetlana przez Google powinna być wymieniona jako pierwsza we właściwości makesOffer. Podana kwota ceny zawiera wszystkie obowiązujące podatki.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">Technikerstrasse 21</span>,
    <span itemprop="addressLocality">Innsbruck</span>,
    <span itemprop="addressRegion">Tyrol</span>
    <span itemprop="postalCode">6020</span>
    <span itemprop="addressCountry">AT</span>
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1200.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {
    "@type": "PostalAddress",
    "addressCountry": "AT",
    "addressLocality": "Innsbruck",
    "addressRegion": "Tyrol",
    "postalCode": "6020",
    "streetAddress": "Technikerstrasse 21"
  },
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1200.74,
        "priceCurrency": "USD"
      }
    }
  ]
}

Zestawienie cen

Oto przykład właściwości priceSpecification z rozbiciem ceny: Stawka podstawowa, podatki, takie jak podatek ogólny, i rabat są definiowane za pomocą komponentu UnitPriceSpecification. Pamiętaj, aby ustawić pole priceComponentType na wartości odpowiadające komponentowi UnitPriceSpecification.

Łączna cena za długość pobytu powinna być określona we właściwości CompoundPriceSpecification. Zestawienie cen należy podać we właściwości priceComponent.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <h1 itemprop="name">ACME Hotel</h1>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">123 Main street</span>,
    <span itemprop="addressLocality">Mountain View</span>,
    <span itemprop="addressRegion">Santa Clara</span>
    <span itemprop="postalCode">94040</span>
    <span itemprop="addressCountry">US</span>
  </div>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total Price: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>

      <!-- Price Components -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base Rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
        <meta itemprop="priceComponentType" content="GenericTax" />
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">-100</span>
        <meta itemprop="priceComponentType" content="Discount" />
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Punkt płatności

Poniżej znajdziesz przykład specyfikacji potentialAction w przypadku użycia typu odbiorcy PayAction.

Łączna cena pakietu wynosi 1170 PLN, a witryna online pobiera część łącznej ceny, czyli 1150 PLN, w momencie rezerwacji określonym za pomocą elementu "@type": "OnlineBusiness". Pozostałe 20 PLN użytkownik musi zapłacić w momencie zameldowania w hotelu, co jest określone za pomocą elementu @type": "Hotel".

Aby podzielić płatność w momencie rezerwacji i w hotelu, musisz określić komponent potentialAction. Jeśli nie jest określony, payAction interpretuje płatność w momencie rezerwacji jako domyślną formę płatności.

Ważne: musisz zdefiniować potentialAction osobno dla płatności w momencie rezerwacji i w hotelu.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Price Due: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1170</span>

      <!-- Paid Online -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
        <div itemprop="potentialAction" itemscope itemtype="https://schema.org/PayAction">
          <div itemprop="recipient" itemscope itemtype="https://schema.org/OnlineBusiness">
            <span itemprop="name">myonlinebusiness</span>
          </div>
        </div>
      </div>

      <!-- Paid at Hotel -->
      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">20</span>
        <div itemprop="potentialAction" itemscope itemtype="https://schema.org/PayAction">
          <div itemprop="recipient" itemscope itemtype="https://schema.org/Hotel">
            <span itemprop="name">The Langham, Boston</span>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1170,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "price": 1150,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "OnlineBusiness",
              "name": "myonlinebusiness"
            }
          }
        },
        {
          "@type": "UnitPriceSpecification",
          "price": 20,
          "priceCurrency": "USD",
          "potentialAction": {
            "@type": "https://schema.org/PayAction",
            "recipient": {
              "@type": "Hotel",
              "name": "The Langham, Boston",
              "address": { ... }
            }
          }
        }
      ]
    }
  }
}

hasMerchantReturnPolicy miejsce zakwaterowania

Ta właściwość służy do dodawania adnotacji do zasad zwrotów sprzedawcy w planach podróży.

    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }

Składnia

hasMerchantReturnPolicy ma następującą składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="hasMerchantReturnPolicy" itemscope itemtype="https://schema.org/MerchantReturnPolicy">
      <link itemprop="returnPolicyCategory" href="https://schema.org/MerchantReturnFiniteReturnWindow"/>
      <link itemprop="refundType" href="https://schema.org/FullRefund"/>
      <meta itemprop="merchantReturnDays" content="YYYY-MM-DDTHH:mm:ss"/>
      <meta itemprop="restockingFee" content="0"/>
    </div>
  </div>
</div>

JSON-LD (wycofano)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": { ... },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
      "restockingFee": 0
    }
  }
}

Właściwość

Właściwość hasMerchantReturnPolicy:

Atrybut	Wymagany?	Typ	Opis
Offer.hasMerchantReturnPolicy	Optional	MerchantReturnPolicy	Zasady zwrotów sprzedawcy. Partnerzy powinni używać MerchantReturnPolicy.restockingFee , aby wskazywać zasady anulowania, które nie przewidują zwrotu pełnej kwoty za długość pobytu. Jeśli parametr hasMerchantReturnPolicy nie jest określony lub jest pusty, zakłada się, że kwota nie podlega zwrotowi. Zasady dotyczące braku możliwości zwrotu środków możesz określić za pomocą właściwości returnPolicyCategory: MerchantReturnNotPermitted.

Przykład zasad zwrotów

Oto podstawowy przykład danych strukturalnych dotyczących hotelu z informacjami o pokojach i cenie łącznej z podatkami i opłatami. Ten przykład oznacza pobyt, który można anulować bez opłat do 23:00 (UTC) 18 grudnia 2023 r. Partnerzy powinni używać symbolu "MerchantReturnPolicy.restockingFee", aby wskazywać zasady anulowania niezwracające pełnej kwoty za pobyt. Wartość domyślna parametru restockingFee to $0.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="hasMerchantReturnPolicy" itemscope itemtype="https://schema.org/MerchantReturnPolicy">
      <link itemprop="returnPolicyCategory" href="https://schema.org/MerchantReturnFiniteReturnWindow"/>
      <link itemprop="refundType" href="https://schema.org/FullRefund"/>
      Cancellation Deadline: <time itemprop="merchantReturnDays" content="2023-12-18T23:00:00">2023-12-18 23:00:00</time>
      Fee: $<span itemprop="restockingFee">0</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "description": "Beautiful resort in the outskirts of the city",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "priceSpecification": {...},
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "refundType": "https://schema.org/FullRefund",
      "merchantReturnDays": "2023-12-18 23:00:00",
      "restockingFee": 0
    }
  }
}

eligibleCustomerType miejsce zakwaterowania

Ta właściwość może służyć do dodawania adnotacji do programów nagród oferowanych klientom, którzy są członkami programu lojalnościowego hotelu.

"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
    "@type": "CompoundPriceSpecification",
    "price": "float",
    "priceCurrency": "currency"
 }

Składnia

Właściwość eligibleCustomerType ma tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>
    ...
  </div>
</div>

JSON-LD (wycofano)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": { ... }
  }
}

Właściwość

Właściwość eligibleCustomerType:

Atrybut	Wymagany?	Typ	Opis
Offer.eligibleCustomerType	Optional	BusinessEntityType	Programy lojalnościowe lub nagrody dla uczestników oferowane klientom. Wiele stron hoteli wyświetla ceny dla klientów z członkostwem wraz z cenami publicznymi, aby zachęcić użytkowników do rejestracji w programach lojalnościowych. Ceny ograniczone do określonych odbiorców, np. ceny dla uczestników, można określić, ustawiając właściwość Offer.eligibleCustomerType.

Przykłady

Oto przykłady stawek dla uczestników programu nagród.

Stawki członkowskie

Poniżej znajdziesz podstawowy przykład specyfikacji ceny dla uczestników programu lub ceny ograniczonej dla programów lojalnościowych. Klient jest uczestnikiem programu lojalnościowego hotelu.

Ważne: właściwości name i eligibleCustomerType muszą być określone we właściwości Offer.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <!-- Address details -->
  </div>

  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">RewardsMember</span>
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1342.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1069.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": {
    "@type": ["Offer", "LodgingReservation"],
    "name": "RewardsMember",
    "checkinTime": "2023-12-15 16:00:00",
    "checkoutTime": "2023-12-20 11:00:00",
    "eligibleCustomerType": "RewardsMember",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1342.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1069.98,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "ResortFee",
          "price": 100,
          "priceCurrency": "USD"
        }
      ]
    }
  }
}

Stawki dla członków i standardowe

To przykład adnotacji dotyczących zarówno ceny regularnej, jak i ceny dla uczestników programu. Najpierw wyświetlana jest cena dla subskrybentów, a potem ceny regularne.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <!-- Address details -->
  </div>

  <!-- Member Rate -->
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">RewardsMember</span>
    <meta itemprop="eligibleCustomerType" content="RewardsMember"/>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1342.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1069.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="currency">$</span><span itemprop="price">172.74</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>

  <!-- Regular Rate -->
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <span itemprop="name">regularRate</span>

    Check-in: <time itemprop="checkinTime" content="2023-12-15T16:00:00">Dec 15, 2023 4:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-12-20T11:00:00">Dec 20, 2023 11:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1572.24</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1369.98</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="currency">$</span><span itemprop="price">202.26</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">ResortFee</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">100</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "identifier": "hotel-id-1234",
  "address": {...},
  "makesOffer": [
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "RewardsMember",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "eligibleCustomerType": "RewardsMember",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1342.74,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1069.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 172.74,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    },
    {
      "@type": ["Offer", "LodgingReservation"],
      "name": "regularRate",
      "checkinTime": "2023-12-15 16:00:00",
      "checkoutTime": "2023-12-20 11:00:00",
      "priceSpecification": {
        "price": 1572.24,
        "priceCurrency": "USD",
        "priceComponent": [
          {
            "@type": "UnitPriceSpecification",
            "name": "Base rate",
            "price": 1369.98,
            "priceCurrency": "USD"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "GenericTax",
            "price": 202.26,
            "priceCurrency": "currency"
          },
          {
            "@type": "UnitPriceSpecification",
            "name": "ResortFee",
            "price": 100,
            "priceCurrency": "USD"
          }
        ]
      }
    }
  ]
}

HotelRoom – uporządkowane dane

W przypadku elementu HotelRoom stosuje się poniższe właściwości.

offers miejsce zakwaterowania

Adnotacje offers służą do oznaczania planów podróży dotyczących pokoi. W przypadku specyfikacji HotelRoom należy użyć właściwości offers.

"offers": {
  "@type": ["Offer", "LodgingReservation"],
  "identifier": "hotel-room-id-1234",
  "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
  "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
  "priceSpecification": {...}
}

Składnia

Właściwość offers ma tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    Check-out: <time itemprop="checkoutTime" content="YYYY-MM-DDTHH:mm:ss">YYYY-MM-DD[THH:mm:ss]</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      ...
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "HotelRoom",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      ...
    }
  }
}

Właściwości

Oto właściwości offers:

Właściwość	Wymagany?	Typ	Opis
offers	Required	Offer and LodgingReservation	Specyfikacja ceny pokoju dla danego planu podróży. Właściwość offers może zawierać tablicę ofert.
LodgingReservation.checkinTime	Required	DateTime	Godzina zameldowania w strefie czasowej użytkownika. Jeśli Twoja strefa czasowa nie jest wymieniona, brana jest pod uwagę strefa czasowa hotelu.
LodgingReservation.checkoutTime	Required	DateTime	Godzina wymeldowania w strefie czasowej użytkownika. Jeśli Twoja strefa czasowa nie jest wymieniona, brana jest pod uwagę strefa czasowa hotelu.

Najważniejsza uwaga: godzina zameldowania i wymeldowania w hotelu LodgingReservation powinna być określona w dodatkowej właściwości @type we wszystkich ofertach.

offers – przykład

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "HotelRoom",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    }
  }
}

Usługi bed i occupancy

Właściwość bed służy do dodawania adnotacji o typie i liczbie łóżek dostępnych w pokoju. Właściwość occupancy służy do dodawania adnotacji do liczby gości w pomieszczeniu. Właściwości bed i occupancy można określić za pomocą właściwości HotelRoom.

"@type": "Hotel",
"identifier": "hotel-id-1234",
"containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "identifier": "hotel-room-id",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  }
}

Składnia

Właściwości bed i occupancy mają tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>
  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
    <span itemprop="name">room-name</span>
    <meta itemprop="identifier" content="hotel-room-id-1234"/>

    <!-- Bed Details -->
    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">integer</span>
      <span itemprop="typeOfBed">KING</span>
    </div>

    <!-- Occupancy -->
    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">integer</span>
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      ...
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "room-name",
    "identifier": "hotel-room-id-1234",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": "integer",
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": "integer"
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
      "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": "float",
        "priceCurrency": "currency",
        "priceComponent": {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        ...
      }
    }
  }
}

Właściwości bed i occupancy można ustawić tylko za pomocą właściwości HotelRoom. Informacje dotyczące pokoju, w tym ceny na poziomie pokoju, można uwzględnić we właściwości Hotel za pomocą właściwości containsPlace. Zapoznaj się z Hotel i HotelRoom przykładową specyfikacją.

Ważne: jeśli to możliwe, zalecamy dodanie adnotacji do cen na poziomie pokoju.

Właściwości

Właściwości bed i occupancy:

Właściwość	Wymagany?	Typ	Opis
HotelRoom.bed	Optional (Recommended)	bed	Rodzaj łóżek w obiekcie i liczba osób, które mogą się w nim zatrzymać. Obsługiwane wartości to: CALIFORNIA_KING KING QUEEN FULL DOUBLE SEMI_DOUBLE SINGLE
HotelRoom.occupancy	Optional (Recommended)	QuantitativeValue	Liczba gości w pokoju hotelowym. Typ zajętości to QuantitativeValue. Właściwość Occupancy jest właściwością HotelRoom, a nie konkretnego Offer. Ceny powinny być tagowane tylko dla żądanej liczby osób.
containsPlace	Optional (Recommended)	LocationFeatureSpecification	Służy do dodawania adnotacji do stawek na poziomie pokoju powiązanych z określonymi pokojami. Można go też używać do określania udogodnień w pokoju. Dowiedz się więcej o używaniu containsPlace w właściwości amenityFeature.

Przykłady

Oto przykłady specyfikacji łóżek i liczby osób, które mogą w nich spać.

HotelRoom – przykład

Poniżej znajdziesz podstawowy przykład łóżek i liczby osób w specyfikacji pokoju.

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <meta itemprop="identifier" content="hotel-room-id-1234"/>
  <span itemprop="name">Deluxe Room, 1 King Bed</span>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    }
  }
}

Hotel i HotelRoom – przykład

Poniżej znajdziesz przykład adnotacji właściwości Hotel i HotelRoom wraz z bed, occupancy i priceSpecification.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">hotel-name</span>
  <meta itemprop="identifier" content="hotel-id-1234"/>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
    <span itemprop="name">Deluxe Room, 1 King Bed</span>
    <meta itemprop="identifier" content="hotel-room-id"/>

    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">KING</span>
    </div>

    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">2</span>
    </div>

    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>
      <meta itemprop="value" content="true"/>
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
      Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
      Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
      <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "hotel-name",
  "identifier": "hotel-id-1234",
  "containsPlace": {
    "@type": ["HotelRoom", "Product"],
    "name": "Deluxe Room, 1 King Bed",
    "identifier": "hotel-room-id",
    "bed": {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": true
    },
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    }
  }
}

HotelRoom priceSpecification miejsce zakwaterowania

Specyfikacja ceny pokoju hotelowego jest podobna do specyfikacji ceny hotelu.Różnica polega na tym, że ceny pokoi są określane za pomocą właściwości Product.offers zamiast właściwości Hotel.makesOffer.

"priceSpecification": {
  "@type": "CompoundPriceSpecification",
  "price": "float",
  "priceCurrency": "currency",
  "priceComponent": {
    "@type": "UnitPriceSpecification",
    "name": "GenericTax",
    "price": "float",
    "priceCurrency": "currency"
  }
  ...
}

Składnia

Właściwość priceSpecification w przypadku pokoi hotelowych ma taką składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name"></span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">float</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  ...
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "",
          "price": "float",
          "priceCurrency": "currency"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": "float",
          "priceCurrency": "currency",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

Ważne:jeśli podano pokoje hotelowe, partner powinien oznaczyć ceny na pokojach, a nie na hotelu.

Właściwości

Oto właściwości HotelRoom priceSpecification:

Właściwość	Wymagany?	Typ	Opis
Hotel.Offer.priceSpecification.price	Required	float	Cena za pokój, w tym podatki i opłaty za Product. Cena w Google powinna być zawsze oznaczona na stronie docelowej wraz ze wszystkimi szczegółami ceny. Dodawanie adnotacji do szczegółów stawek umożliwia przeprowadzanie kontroli dokładności cen. Google akceptuje ceny na poziomie hotelu i na poziomie pokoju.
Hotel.Offer.priceSpecification.priceCurrency	Required	currency	Trzyliterowy kod waluty określonej ceny. Np. "USD" .
Hotel.Offer.priceSpecification.priceComponent	Optional	UnitPriceSpecification[]	Szczegółowy podział ceny całkowitej, w tym podatki i opłaty za pokój hotelowy oraz liczbę osób z ofertami połączonymi z HotelRoom i Product. Istnieją 2 rodzaje danych strukturalnych dotyczących ceny: CompoundPriceSpecification podaje szczegółowe informacje o cenach, w tym: Cena podstawowa: podstawowa cena za noc. Podatki za pobyt: cena za noc z podatkami. Opłaty za osobę: cena za noc za osobę. occupancy to jawna właściwość elementu HotelRoom, a nie konkretnego elementu Offer. Ceny powinny być tagowane tylko dla żądanej liczby osób. Rabat: kwota odliczenia. UnitPriceSpecification służy do określania rodzaju opłat. Powinieneś podać wartości PriceComponentTypeEnumeration , aby określić dodatkowe opłaty. Wartości w polu PriceComponentTypeEnumeration to: Discount: ogólny rabat na cenę. ResortFee: jest to dodatkowa opłata, którą należy uiścić w hotelu. Może się różnić w zależności od typu obiektu noclegowego. GenericTax: Jest to dodatkowy podatek różny. ServiceFee: jest to dodatkowa opłata pobierana przez kanał rezerwacji. Wartości musisz ustawić we właściwości name elementu UnitPriceSpecification. Jeśli zdecydujesz się uwzględnić podział ceny, wszystkie wartości są wymagane i muszą być podane w komponencie UnitPriceSpecification.

Przykłady

Oto przykłady specyfikacji ceny HotelRoom.

Przykład łącznej ceny pokoju

Poniżej znajdziesz podstawowy przykład określania łącznej ceny za długość pobytu i ceny za liczbę osób.

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room King, 1 Single Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1232.74</span>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1232.74,
      "priceCurrency": "USD"
    }
  }
}

Przykład zestawienia ceny pokoju

Poniżej znajdziesz przykład ceny za pokój lub plan. Szczegółowy podział ceny jest określony dla typu pokoju, np. pokoju Deluxe, oraz typu bed i occupancy, np. łóżek KING i SINGLE oraz liczby gości – 2.

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room King, 1 Single Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">KING</span>
    </div>
    <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
      <span itemprop="numberOfBeds">1</span>
      <span itemprop="typeOfBed">SINGLE</span>
    </div>

    <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
      Occupancy: <span itemprop="value">2</span>
    </div>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      Total: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Base rate</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1150</span>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">GenericTax</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">172.74</span>
        <meta itemprop="priceComponentType" content="GenericTax"/>
      </div>

      <div itemprop="priceComponent" itemscope itemtype="https://schema.org/UnitPriceSpecification">
        <span itemprop="name">Discount</span>: <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">-100</span>
        <meta itemprop="priceComponentType" content="Discount"/>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room King, 1 Single Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "bed": [
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "KING"
      },
      {
        "@type": "BedDetails",
        "numberOfBeds": 1,
        "typeOfBed": "SINGLE"
      }
    ],
    "occupancy": {
      "@type": "QuantitativeValue",
      "value": 2
    },
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD",
      "priceComponent": [
        {
          "@type": "UnitPriceSpecification",
          "name": "Base rate",
          "price": 1150,
          "priceCurrency": "USD"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "GenericTax",
          "price": 172.74,
          "priceCurrency": "USD",
          "priceComponentType": "GenericTax"
        },
        {
          "@type": "UnitPriceSpecification",
          "name": "Discount",
          "price": -100,
          "priceCurrency": "USD",
          "priceComponentType": "Discount"
        }
      ]
    }
  }
}

includesObject miejsce zakwaterowania

Ta właściwość służy do opisywania usług związanych z ceną, które są dostępne w hotelu lub pokoju, takich jak opcje posiłków i usługa parkowania. Adnotacje includesObject możesz dodawać we właściwości Hotel lub HotelRoom.

{
  "includesObject": [
    {
      "@type": "TypeAndQuantityNode",
      "typeOfGood": {
        "@type": "Service",
        "name": "Valet"
      }
    },
    {
      "@type": "TypeAndQuantityNode",
      "amountOfThisGood": "float",
      "unitText": "currency",
      "typeOfGood": {
        "@type": "FoodService",
        "name": "MealCredit"
      }
    }
  ]
}

Składnia

Element includesObject ma następującą składnię w przypadku usług związanych z ceną dostępnych w pokoju:

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/Service">
        <span itemprop="name">Valet</span>
      </div>
    </div>

    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <meta itemprop="amountOfThisGood" content="float"/>
      <meta itemprop="unitText" content="currency"/>
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/FoodService">
        <span itemprop="name">MealCredit</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofano)

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  ...
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    ...
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": "float",
      "priceCurrency": "currency"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": "float",
        "unitText": "currency",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

Ważne: jeśli podasz pokoje hotelowe, adnotacje o cenach powinny dotyczyć pokoi, a nie hotelu.

Właściwość

Element includesObject ma tę właściwość:

Atrybut	Wymagany?	Typ	Opis
Offer.includesObject	Optional	TypeAndQuantityNode	usługi świadczone w hotelu lub pokoju; Funkcje związane z ceną są uwzględnione we właściwości includesObject. Pole nazwy na stronie "TypeAndQuantityNode.typeOfGood" powinno być używane do określania typu usługi, np. usługi parkingowej lub usługi gastronomicznej. Funkcje związane z ceną mogą być też uwzględnione w ofertach podstawowych lub określone jako dodatki za dodatkową opłatą. Pole includesObject wymaga wartości typu TypeAndQuantityNode w tym formacie: BreakfastIncluded DinnerIncluded Valet MealCredit

includesObject – przykład

Poniżej znajdziesz podstawowy przykład funkcji związanych z cenami w przypadku parkowania z obsługą i usług gastronomicznych. Funkcje związane z ceną należy określić za pomocą właściwości Offer.includesObject. Pole name w TypeAndQuantityNode.typeOfGood powinno służyć do określania typu usługi.

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room, 1 King Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
    </div>

    <!-- Included Services -->
    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/Service">
        <span itemprop="name">Valet</span>
      </div>
    </div>

    <div itemprop="includesObject" itemscope itemtype="https://schema.org/TypeAndQuantityNode">
      <meta itemprop="amountOfThisGood" content="50"/>
      <meta itemprop="unitText" content="USD"/>
      <div itemprop="typeOfGood" itemscope itemtype="https://schema.org/FoodService">
        <span itemprop="name">MealCredit</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "identifier": "rate-plan-id-of-member-rate",
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "priceSpecification": {
      "@type": "CompoundPriceSpecification",
      "price": 1222.74,
      "priceCurrency": "USD"
    },
    "includesObject": [
      {
        "@type": "TypeAndQuantityNode",
        "typeOfGood": {
          "@type": "Service",
          "name": "Valet"
        }
      },
      {
        "@type": "TypeAndQuantityNode",
        "amountOfThisGood": 50,
        "unitText": "USD",
        "typeOfGood": {
          "@type": "FoodService",
          "name": "MealCredit"
        }
      }
    ]
  }
}

availability miejsce zakwaterowania

Właściwość offer.availability służy do oznaczania wyprzedanych planów podróży w przypadku pokoi hotelowych.

"offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
}

Składnia

Właściwość availability ma tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  ...
  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    ...
    <meta itemprop="availability" content="https://schema.org/SoldOut"/>
    Sold Out
  </div>
</div>

JSON-LD (wycofano)

{
  "@context": "https://schema.org",
  ...
  "@type": ["HotelRoom", "Product"],
  "name": "room-type",
  "identifier": "hotel-room-id-1234",
  "bed": {
    "@type": "BedDetails",
    "numberOfBeds": "integer",
    "typeOfBed": "KING"
  },
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": "integer"
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "YYYY-MM-DD[THH:mm:ss]",
    "checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
    "availability": "https://schema.org/SoldOut"
  }
}

Właściwość

Właściwość availability:

Atrybut	Wymagany?	Typ	Opis
Offer.availability	Optional	ItemAvailability	Dostępność hotelu lub pokoju. Stawki są pobierane z  schema.org/Offer, a informacje o stawkach nie są tworzone przy użyciu schema.org/Hotel ani schema.org/HotelRoom. Oznacza to, że nawet wyprzedane trasy muszą mieć ofertę. Oferta bez wartości priceSpecification jest uznawana za niedostępną. Niedostępne oferty powinny być oznaczone jako "Offer.availability= https://schema.org/SoldOut". Nie musisz określać atrybutu Offer.availability, jeśli oferta jest opatrzona prawidłowym atrybutem priceSpecification..

availability – przykład

Poniżej znajdziesz podstawowy przykład pokazujący niedostępność pokoju hotelowego. Podaj rodzaj łóżka, liczbę łóżek i szczegóły dotyczące liczby osób w danym pokoju.

Mikrodane

<div itemscope itemtype="https://schema.org/HotelRoom https://schema.org/Product">
  <span itemprop="name">Deluxe Room, 1 King Bed</span>
  <meta itemprop="identifier" content="hotel-room-id-1234"/>

  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">KING</span>
  </div>
  <div itemprop="bed" itemscope itemtype="https://schema.org/BedDetails">
    <span itemprop="numberOfBeds">1</span>
    <span itemprop="typeOfBed">SINGLE</span>
  </div>

  <div itemprop="occupancy" itemscope itemtype="https://schema.org/QuantitativeValue">
    Occupancy: <span itemprop="value">2</span>
  </div>

  <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
    Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
    Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
    <meta itemprop="availability" content="https://schema.org/SoldOut"/>
    Sold Out

    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
      <!-- Price Specification details -->
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": ["HotelRoom", "Product"],
  "name": "Deluxe Room, 1 King Bed",
  "identifier": "hotel-room-id-1234",
  "bed": [
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "KING"
    },
    {
      "@type": "BedDetails",
      "numberOfBeds": 1,
      "typeOfBed": "SINGLE"
    }
  ],
  "occupancy": {
    "@type": "QuantitativeValue",
    "value": 2
  },
  "offers": {
    "@type": ["Offer", "LodgingReservation"],
    "checkinTime": "2023-03-10 15:00:00",
    "checkoutTime": "2023-03-16 10:00:00",
    "availability": "https://schema.org/SoldOut",
    "priceSpecification": {...}
  }
}

Najważniejsza uwaga: w przypadku wyprzedanych tras należy podać wartość Offers.

amenityFeature miejsce zakwaterowania

Udogodnienia można określić w typie Hotel lub HotelRoom za pomocą właściwości amenityFeature. Aby określić udogodnienia w pokoju, użyj właściwości containsPlace.

{
  "@type": "Hotel",
  "amenityFeature": [
    {
      "@type": "LocationFeatureSpecification",
      "name": "HotTub",
      "hoursAvailable": {
        "@type": "OpeningHoursSpecification",
        "opens": "HH:mm:ss",
        "closes": "HH:mm:ss"
      }
    },
    {
      "@type": "LocationFeatureSpecification",
      "name": "GymFitnessEquipment",
      "value": "boolean"
    }
  ],
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": [
      {
        "@type": "LocationFeatureSpecification",
        "name": "Minibar",
        "value": true
      },
      {
        "@type": "LocationFeatureSpecification",
        "name": "Smoking",
        "value": false
      }
    ]
  }
}

Składnia

Właściwości amenityFeature i containsPlace mają tę składnię:

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  ...
  <!-- Hotel Amenity -->
  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">HotTub</span>
    <div itemprop="hoursAvailable" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
      <time itemprop="opens" content="HH:mm:ss">HH:mm:ss</time>
      <time itemprop="closes" content="HH:mm:ss">HH:mm:ss</time>
    </div>
  </div>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom">
    <!-- Room Amenity -->
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>
      <meta itemprop="value" content="boolean"/>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  ...
  "amenityFeature": {
    "@type": "LocationFeatureSpecification",
    "name": "HotTub",
    "hoursAvailable": {
      "@type": "OpeningHoursSpecification",
      "opens": "HH:mm:ss",
      "closes": "HH:mm:ss"
    }
  },
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": {
      "@type": "LocationFeatureSpecification",
      "name": "Minibar",
      "value": "boolean"
    }
  }
}

Udogodnienia

Te udogodnienia są dozwolone i zdefiniowane we właściwości name.

Atrybut	Wymagany?	Typ	Opis
amenityFeature.AC	Optional	boolean	Czy obiekt jest klimatyzowany.
amenityFeature.AirportShuttle	Optional	boolean	Czy gospodarz zapewnia transport między hotelem a lotniskiem lub innymi terminalami.
amenityFeature.Balcony	Optional	boolean	Czy obiekt ma balkon.
amenityFeature.BeachAccess	Optional	boolean	Czy obiekt ma dostęp do publicznej plaży w pobliżu.
amenityFeature.ChildFriendly	Optional	boolean	Czy obiekt jest odpowiedni dla dzieci.
amenityFeature.Crib	Optional	boolean	Dostępność łóżeczka dziecięcego.
amenityFeature.Elevator	Optional	boolean	Czy w obiekcie znajduje się winda.
amenityFeature.FirePlace	Optional	boolean	Czy w obiekcie znajduje się kominek.
amenityFeature.FreeBreakfast	Optional	boolean	Czy śniadanie jest wliczone w cenę dla wszystkich gości. Użyj funkcji stawek, aby wskazać, czy śniadanie jest wliczone tylko w przypadku określonych planów stawek.
amenityFeature.GymFitnessEquipment	Optional	boolean	Czy w obiekcie znajduje się siłownia lub sprzęt do ćwiczeń.
amenityFeature.Heating	Optional	boolean	Czy obiekt jest ogrzewany.
amenityFeature.HotTub	Optional	boolean	Czy obiekt ma jacuzzi.
amenityFeature.InstantBookable	Optional	boolean	Czy w procesie płatności można natychmiast zarezerwować pokój. Alternatywą jest oczekiwanie na zatwierdzenie.
amenityFeature.IroningBoard	Optional	boolean	Czy w obiekcie znajduje się deska do prasowania.
amenityFeature.Kitchen	Optional	boolean	Czy w obiekcie znajduje się kuchnia.
amenityFeature.Microwave	Optional	boolean	Czy w obiekcie znajduje się kuchenka mikrofalowa.
amenityFeature.OpenAirBath(Hotels only)	Optional	boolean	Czy w obiekcie znajduje się łaźnia na świeżym powietrzu. Jeśli jest określona na poziomie pokoju, łazienka powinna być prywatna i przeznaczona tylko dla osób zajmujących pokój.
amenityFeature.OutdoorGrill	Optional	boolean	Czy obiekt ma grilla.
amenityFeature.OvenStove	Optional	boolean	Czy w obiekcie znajduje się kuchenka.
amenityFeature.Patio	Optional	boolean	Czy obiekt ma patio.
amenityFeature.Pool	Optional	boolean	Czy obiekt ma basen.
amenityFeature.PrivateBeachAccess	Optional	boolean	Czy obiekt ma specjalny dostęp do niepublicznej plaży.
amenityFeature.SelfCheckinCheckout	Optional	boolean	Czy obiekt umożliwia samodzielne zameldowanie się i wymeldowanie.
amenityFeature.WasherDryer	Optional	boolean	Czy w obiekcie znajdują się pralki.
amenityFeature.Wifi	Optional	boolean	Czy w obiekcie jest Wi-Fi.
amenityFeature.Smoking	Optional	boolean	Czy w obiekcie można palić.
amenityFeature.InternetType	Optional	Enum	Rodzaj internetu dostępnego w obiekcie. Obsługiwane wartości to: FREE PAID NONE
amenityFeature.ParkingType	Optional	Enum	Rodzaj parkingu dostępnego na terenie obiektu. Obsługiwane wartości to: FREE PAID NONE
amenityFeature.PoolType	Optional	Enum	Rodzaj basenu dostępnego w obiekcie. Obsługiwane wartości to: INDOOR OUTDOOR NONE
amenityFeature.RoomStyle	Optional	Enum	Wskazuje, czy pokój jest urządzony w stylu japońskim. Obsługiwane wartości to: WESTERN JAPANESE JAPANESE_WESTERN
amenityFeature.LicenseNum	Required	string	Numer licencji firmy, który ma być wyświetlany w obiekcie w określonych regionach świata. Można go powtarzać. Jeśli istnieje kilka licencji, zalecamy dodanie właściciela lub urzędu wystawiającego licencję. Na przykład: "Paris: 123456ABC"

Właściwości

Oto właściwości amenityFeature:

Właściwość	Wymagany?	Typ	Opis
amenityFeature	Optional	LocationFeatureSpecification	Udogodnienia dostępne w hotelu lub pokoju. Można ją określić za pomocą właściwości amenityFeature . Udogodnienia powinny być dostępne dla wszystkich gości hotelu niezależnie od wybranego planu cenowego. amenityFeature jest określana za pomocą wartości właściwości LocationFeatureSpecification. Udogodnienia można określić na poziomie Hotel lub HotelRoom.
containsPlace	Optional	LocationFeatureSpecification	Udogodnienia dostępne w hotelu lub pokoju dla wszystkich gości hotelowych. Można ją określić za pomocą amenityFeature . Udogodnienia powinny być dostępne dla wszystkich gości w pokoju hotelowym niezależnie od wybranego planu cenowego. Hotel.containsPlace.amenityFeature to udogodnienia dostępne w hotelu. HotelRoom.containsPlace.amenityFeature to udogodnienia dostępne w pokoju.

Przykład udogodnień

Oto podstawowy przykład hotelu z basenem otwartym od 10:00 do 22:00, w którym nie ma siłowni. W pokoju hotelowym obowiązuje zakaz palenia, a w jego wyposażeniu jest minibar.

Mikrodane

<div itemscope itemtype="https://schema.org/Hotel">
  <span itemprop="name">ACME Hotel</span>

  <!-- Amenities -->
  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">HotTub</span>
    <div itemprop="hoursAvailable" itemscope itemtype="https://schema.org/OpeningHoursSpecification">
      Open from <time itemprop="opens" content="10:00:00">10:00</time>
      to <time itemprop="closes" content="22:00:00">22:00</time>
    </div>
  </div>

  <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
    <span itemprop="name">GymFitnessEquipment</span>:
    <meta itemprop="value" content="false"/> No
  </div>

  <div itemprop="containsPlace" itemscope itemtype="https://schema.org/HotelRoom">
    <!-- Room Amenities -->
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Minibar</span>:
      <meta itemprop="value" content="true"/> Yes
    </div>
    <div itemprop="amenityFeature" itemscope itemtype="https://schema.org/LocationFeatureSpecification">
      <span itemprop="name">Smoking</span>:
      <meta itemprop="value" content="false"/> No
    </div>

    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation">
      <meta itemprop="identifier" content="rate-plan-id-of-member-rate"/>
      Check-in: <time itemprop="checkinTime" content="2023-03-10T15:00:00">Mar 10, 2023 3:00 PM</time>
      Check-out: <time itemprop="checkoutTime" content="2023-03-16T10:00:00">Mar 16, 2023 10:00 AM</time>
      <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/CompoundPriceSpecification">
        <span itemprop="priceCurrency" content="USD">$</span><span itemprop="price">1222.74</span>
      </div>
    </div>
  </div>
</div>

JSON-LD (wycofane)

{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "ACME Hotel",
  "address": { ... },
  "amenityFeature": [
    {
      "@type": "LocationFeatureSpecification",
      "name": "HotTub",
      "hoursAvailable": {
        "@type": "OpeningHoursSpecification",
        "opens": "10:00:00",
        "closes": "22:00:00"
      }
    },
    {
      "@type": "LocationFeatureSpecification",
      "name": "GymFitnessEquipment",
      "value": false
    }
  ],
  "containsPlace": {
    "@type": "HotelRoom",
    "amenityFeature": [
      {
        "@type": "LocationFeatureSpecification",
        "name": "Minibar",
        "value": true
      },
      {
        "@type": "LocationFeatureSpecification",
        "name": "Smoking",
        "value": false
      }
    ],
    "offers": {
      "@type": ["Offer", "LodgingReservation"],
      "identifier": "rate-plan-id-of-member-rate",
      "checkinTime": "2023-03-10 15:00:00",
      "checkoutTime": "2023-03-16 10:00:00",
      "priceSpecification": {
        "@type": "CompoundPriceSpecification",
        "price": 1222.74,
        "priceCurrency": "USD"
      }
    }
  }
}

Tagowanie nawigacji

Niestandardowe atrybuty HTML5 z prefiksem data-nav- służą do dodawania adnotacji do elementów interaktywnych i deklarowania stanów strony, co umożliwia robotowi indeksującemu poruszanie się po procesie rezerwacji.

Składnia

Tagowanie nawigacji wykorzystuje następującą składnię atrybutów:

Atrybuty

<body data-nav-stage="stage_name">
  ...
  <button data-nav-criticalpath="true"
          data-nav-interactiontype="CLICK"
          data-nav-interactionorder="1">
    Action
  </button>
  ...
  <button data-nav-close="true">Dismiss</button>
</body>

Właściwości

Oto atrybuty nawigacji:

Atrybut	Wartości	Opis
data-nav-stage	landing, room-selection, checkout, confirmation	Deklaruje aktywny stan ścieżki dla robotów indeksujących. Powiązany z elementem <body> lub elementem opakowującym wyższego poziomu.
data-nav-stage-final	true, false	Wskaźnik ostatniej strony ścieżki (domyślnie false). Jeśli na stronie nie ma elementów z atrybutem data-nav-criticalpath="true", robot automatycznie uznaje ją za ostatnią stronę ścieżki.
data-nav-criticalpath	true, false	Oznacza element, z którym robot musi wejść w interakcję, aby dotrzeć do ostatecznej strony rezerwacji. Jeśli na stronie nie ma elementów z atrybutem data-nav-criticalpath="true", robot indeksujący automatycznie uzna ją za ostatnią stronę w procesie.
data-nav-interactiontype	CLICK, SELECT	Określa działanie związane z interakcją. CLICK służy do przycisków i linków. SELECT dotyczy menu i grup przycisków opcji.
data-nav-interactionorder	integer	Określa sekwencję wykonywania wieloetapowej nawigacji. Najpierw wykonywane są reguły o niższych numerach.
data-nav-close	true	Oznacza przyciski zamykania w wyskakujących okienkach, nakładkach banerów z informacją o plikach cookie lub wyskakujących okienkach z ofertą dodatkową.

Przykład nawigacji

Poniżej znajdziesz przykłady tagowania nawigacji.

Kliknij nawigację

Poniżej znajdziesz podstawowy przykład nawigacji za pomocą kliknięć, która deklaruje etap ścieżki.

<body data-nav-stage="room-selection" data-nav-stage-final="false">
  <h1>Select Your Room</h1>
  
  <!-- Crawler needs to click this to proceed -->
  <button data-nav-criticalpath="true"
          data-nav-interactiontype="CLICK"
          data-nav-interactionorder="1">
    Select & Proceed
  </button>
</body>

Nawigacja wieloetapowa

Poniżej znajdziesz przykład wieloetapowej nawigacji obejmującej baner z prośbą o zgodę na stosowanie plików cookie, rozwinięcie akordeonu i kliknięcie.

<div data-nav-stage="landing" data-nav-stage-final="false">
  <!-- Hotel, LodgingReservation info, and Offer price are expected to be included in this page -->

  <!-- Step 1: Accept cookies -->
  <div class="cookie-banner">
    <p>We use cookies to improve your experience.</p>
    <button data-nav-close="true"
            data-nav-criticalpath="true"
            data-nav-interactiontype="CLICK"
            data-nav-interactionorder="1">Accept cookies</button>
  </div>

  <!-- Step 2: Open accordion to reveal pricing (Crucial for making prices visible in Mobile UIs) -->
  <div data-nav-criticalpath="true"
       data-nav-interactiontype="CLICK"
       data-nav-interactionorder="2"
       class="accordion-header">
    <span>View Room Rates</span>
  </div>


  <!-- Step 3: Book the room -->
  <div class="accordion-content">
    <button data-nav-criticalpath="true"
            data-nav-interactiontype="CLICK"
            data-nav-interactionorder="3">
      Book Now
    </button>
  </div>
</div>

Deklaracja strony końcowej

Poniżej znajdziesz przykład deklarowania ostatniej strony procesu rezerwacji.

<!-- Marks this as the final confirmation page where price is extracted -->
<!-- Hotel, LodgingReservation info, and Offer price are expected to be included in this page -->
<div data-nav-stage="confirmation" data-nav-stage-final="true">
  <h1>Grand View Hotel</h1>
  <!-- Price and other details here -->
</div>