Wiadomość dotycząca zasobów reklamowych

Opis

Komunikat dotyczący zasobów reklamowych (OTA_HotelInvCountNotifRQ) określa liczbę zasobów reklamowych (liczbę fizycznych sal), które można zarezerwować na potrzeby określonych typów sal. Wysyłając wiadomość o zasobach reklamowych, wskazujesz liczbę sal tego typu, które są dostępne w danym dniu. Jeśli nie ma dostępnych sal tego typu, produkty powiązane z tym typem i datą nie będą wyświetlane.

Sekcje poniżej zawierają ogólne wskazówki, podstawowe przykłady i instrukcje, które pomogą Ci zacząć dodawać i aktualizować zasoby reklamowe oraz wysyłać komunikaty dotyczące zasobów reklamowych.

Przykłady różnych scenariuszy związanych z zasobami reklamowymi znajdziesz w instrukcji.

Elementy wymagane i opcjonalne

Dokumentacja XML zawiera opisy elementów wymaganych i opcjonalnych. Szczegółowe informacje o atrybutach i elementach podrzędnych znajdziesz w artykule Elementy i atrybuty zasobów reklamowych.

Składnia i schematy

Podczas tworzenia wiadomości dotyczącej zasobów reklamowych użyj przykładu składni zasobów reklamowych, aby mieć pewność, że używasz właściwego formatu.

Aby zweryfikować pliki danych z opublikowanymi schematami przed przesłaniem ich do Google, możesz użyć narzędzia XML innej firmy, np. xmllint. Schemat wiadomości dotyczących zasobów reklamowych znajdziesz w sekcji Schematy reklam hoteli.

Wytyczne

W przypadku wiadomości dotyczącej zasobów reklamowych postępuj zgodnie z tymi wskazówkami:

  • Informacje o zasobach reklamowych zależą od hotelu, daty i typu pokoju.

  • Aby wyświetlić cenę za powiązany plan taryfowy i obłożenie, liczba zasobów reklamowych musi być większa niż 0 w przypadku wszystkich nocy pobytu.

  • Jeśli liczba zasobów reklamowych jest równa 0, sale nie będą dostępne do rezerwacji w przypadku podanego identyfikatora i zakresu dat.

  • Aby atrybut CountType był prawidłowy, musi zawsze mieć wartość 2, ponieważ wskazuje liczbę „nieokreślonej dostępności”.

  • Wysyłaj zaktualizowane zasoby reklamowe za każdym razem, gdy w systemie wystąpi rezerwacja lub anulowanie rezerwacji.

Zasoby reklamowe a dostępność

Zasoby reklamowe to liczba sal do zarezerwowania ustalona na podstawie liczby pokoi, a dostępność wskazuje, czy dozwolone jest rezerwowanie kombinacji typu pokoju i planu taryfowego. W przypadku ARI dostępność i zasoby reklamowe mogą się różnić w zależności od daty lub typu zastosowania, a obie mają odpowiadające im typy wiadomości. Zasoby i dostępność zależą od hotelu, daty i typu pokoju. Dodajemy też plan cenowy dotyczący dostępności.

Wartość „brak dostępności” może wystąpić nawet wtedy, gdy dostępne są zasoby reklamowe, ponieważ zasoby i dostępność są od siebie niezależne.

Istnieją 2 koncepcje dostępności. Po pierwsze, mamy do czynienia z ogólną dostępnością produktu w przypadku danego pobytu, na którą wpływają takie czynniki, jak to, czy każda noc ma określoną stawkę, zasoby dotyczące powiązanego typu pokoju oraz obowiązują ograniczenia dostępności. Po drugie: mamy ograniczone ograniczenie dotyczące produktu w danym dniu oznaczone jako <RestrictionStatus Restriction="Master" Status="Open"/> w OTA_HotelAvailNotifRQ, a zakończenie tej dostępności określa się mianem „przerwij sprzedaż”.

Asortyment musi być liczbą całkowitą większą niż 0 dotyczący sali, a ograniczenie dostępności musi być otwarte, aby cena produktu była widoczna.

Przykład

W tej sekcji znajdziesz podstawowy przykład komunikatu dotyczącego zasobów reklamowych, który zawiera elementy wymagane i opcjonalne. Po przygotowaniu pliku musisz wysłać go do Google za pomocą wiadomości POST do tego punktu końcowego:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Więcej informacji o przekazywaniu wiadomości w trybie push/OPUBLIKUJ znajdziesz w sekcji o wysyłaniu wiadomości.

W przypadku obiektu HotelCode użyj unikalnego identyfikatora hotelu użytego w systemie do identyfikacji obiektu. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą atrybutu <id> w elemencie <listing> w pliku danych Lista hoteli. W przypadku <RoomID> użyj tego samego identyfikatora, który został użyty w systemie do określenia typów sal. Systematyczność z systemem jest niezbędna do prawidłowego wyświetlania danych przez Google.

Ten przykład pokazuje, jak skonfigurować zasoby reklamowe dla 13 sal do zarezerwowania w grudniu:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Więcej przykładów znajdziesz w artykule Przykłady zasobów reklamowych.

Instrukcje

W tej sekcji opisano scenariusz, który może wystąpić podczas wysyłania wiadomości o asortymencie.

Scenariusz: jak zablokować rezerwację sal

Opis

Musisz wskazać, że nie ma żadnych innych sal, które można zarezerwować w określonym terminie, zwykle dlatego, że są wyprzedane.

Rozwiązanie

Ustawiasz dla parametru <InvCount Count> wartość 0 i dodajesz odpowiedni zakres dat.

Przykład

Ten przykład pokazuje, jak za pomocą pola InvCount ustawić 0 w zasobach reklamowych dla określonej sali i dat (np. w pierwszych tygodniach stycznia).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>