Wiadomość dotycząca zasobów reklamowych

Omówienie

Komunikat o asortymencie (OTA_HotelInvCountNotifRQ) definiuje liczbę zasobów reklamowych (liczba sal fizycznych), które można zarezerwować dla określonej sali. . W wiadomości dotyczącej asortymentu wskażesz, ile z nich są dostępne w danym dniu. Jeśli nie ma dostępnych sal tego typu, produkty powiązane z tym typem pokoju i datą nie będą wyświetlane.

W poniższych sekcjach znajdziesz ogólne wskazówki, podstawowy przykład i instrukcje scenariusze, 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 artykule: Instrukcje.

Elementy wymagane i opcjonalne

Dokument XML zawiera opisy elementów wymaganych i opcjonalnych. Więcej informacji dotyczące atrybutów i elementów podrzędnych znajdziesz w sekcji Elementy zasobów reklamowych .

Składnia i schematy

Za pomocą narzędzia Zasoby reklamowe składni użyj tych danych podczas tworzenia wiadomości dotyczącej asortymentu. Będziesz mieć pewność, że postępujesz zgodnie w prawidłowym formacie.

Do weryfikacji plików danych możesz użyć narzędzia XML innej firmy, np. xmllint. opublikowane schematy przed przesłaniem do Google. Zasoby reklamowe schemat wiadomości znajdziesz w sekcji Schematy reklam hoteli.

Wytyczne

Przestrzegaj tych wskazówek dotyczących wiadomości dotyczącej asortymentu:

• Zasoby reklamowe zależą od hotelu, daty i typu pokoju.

• Liczba jednostek zasobów musi być większa niż 0 w przypadku wszystkich nocy pobytu, aby wyświetlić cenę dla powiązanego planu cenowego i liczby osób.

• Jeśli liczba dostępnych pokoi jest równa 0, rezerwacja sal nie będzie możliwa w przypadku określonego identyfikatora pokoju i zakresu dat.

• Aby funkcja CountType była poprawna, zawsze musi mieć wartość 2, ponieważ wskazuje liczbę „określonej dostępności”.

• Wysyłaj zaktualizowane zasoby za każdym razem, gdy rezerwujesz lub anulujesz pokój w Twoim systemie.

.

Uwaga: aby wysyłać liczbę zasobów reklamowych sal, użyj OTA_HotelInvCountNotifRQ (metoda zalecana) lub alternatywna metoda wykorzystująca Atrybut <BookingLimit> wiadomości OTA_HotelAvailNotifRQ.

Zasoby reklamowe a dostępność

Zasoby reklamowe to liczba sal do zarezerwowania ustalona na podstawie ich liczby „availability” wskazuje, czy połączenie typu pokoju i abonamentu jest które można zarezerwować. W przypadku ARI dostępność i zasoby reklamowe mogą się różnić w zależności od w danym dniu lub w ramach określonego typu zakwaterowania; oba te typy mają typy wiadomości. Informacje o asortymencie i dostępności zależą od hotelu, daty i pokoju z dodanym planem stawek na potrzeby dostępności.

Wartość „brak dostępności” nawet jeśli są dostępne zasoby, i dostępność są od siebie niezależne.

Są 2 pojęcia związane z dostępnością. Po pierwsze: ogólna dostępność danego produktu, na który mają wpływ takie czynniki jak: czy każda noc ma określoną stawkę, zasoby reklamowe powiązane z danym typem pokoju, a ograniczenie dostępności jest otwarte. Po drugie, mamy do czynienia ograniczenia dla produktu w danym dniu, reprezentowane przez <RestrictionStatus Restriction="Master" Status="Open"/> w OTA_HotelAvailNotifRQ, i zamykające ten stan dostępności określa się jako „stop sprzedaż”.

Wartość zasobów reklamowych musi być liczbą całkowitą większą niż 0 dla sali i dostępności ograniczenie musi być otwarte, aby cena produktu była wyświetlana.

Uwaga: jeśli sala zostanie wyprzedana, wszystkie powiązane z nim plany stawek mogą nie będą już sprzedawane.

Przykład

W tej sekcji znajdziesz podstawowy przykład wiadomości dotyczącej asortymentu z użyciem wymaganych i opcjonalnych. Po przygotowaniu pliku prześlij go do Google wysyłając komunikat POST do tego punktu końcowego:

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

Aby dowiedzieć się więcej o wysyłaniu/POSTĘPu wiadomości, zapoznaj się z sekcją Wysyłanie i POST wiadomości.

Ważne: wysyłaj do Google zaktualizowany komunikat o asortymencie za każdym razem, gdy informacje o Twoim asortymencie (np. kiedy następuje rezerwacja lub anulowanie rezerwacji).

W przypadku HotelCode użyj unikalnego identyfikatora hotelu użytego w systemie do identyfikacji usługi. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą elementu <id> w elementie <listing> w pliku danych z listą hoteli. W przypadku usługi <RoomID> użyj tego samego identyfikatora, który został użyty w systemie typów pokojów. Spójność z systemem jest kluczowa dla poprawnie wyświetla dane.

Uwaga: <CountType=2> to jedyna prawidłowa opcja, ponieważ wskazuje liczbę „dokładnej dostępności”.

W tym przykładzie pokazujemy, jak ustawić zasoby dla 13 sal dostępnych do zarezerwowania w miesiąc grudnia:

<?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 Zasoby reklamowe .

Instrukcje

W tej sekcji omawiamy scenariusz, który może wystąpić podczas wysyłania Komunikat dotyczący asortymentu.

Scenariusz: jak blokować możliwość rezerwacji sal

Opis

Musisz wskazać, że w danym typie pokoju nie ma już pokoi do zarezerwowania w określonym przedziale dat, najczęściej dlatego, że są wyprzedane.

Rozwiązanie

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

Przykład

Ten przykład pokazuje, jak za pomocą pola InvCount ustawić zasoby reklamowe na 0 w przypadku określone sale i daty (na przykład pierwsze kilka tygodni stycznia).

Uwaga: jeśli liczba zasobów reklamowych w pokoju wynosi 0 na dowolną noc, nie można zarezerwować pobytu w przypadku żadnych usług powiązanych z tą salą.

<?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>