İpucu Yanıtı Mesajları

Google bir İpucu İsteği mesajı gönderdiğinde sunucularınız, Google'ın aynı sunuculardan başarılı bir İpucu Yanıtı almasından bu yana fiyatlarının değiştiği otelleri belirten bir İpucu Yanıtı mesajı ile yanıt vermelidir. Herhangi bir fiyat değişikliği varsa Google, belirtilen oteller ve seyahat planlarının güncellenmiş fiyatlandırma verilerini getiren bir <Query> gönderir.

Yeniden fiyatlandırma sürecine genel bakış için Fiyatlandırmaya Genel Bakış konusuna bakın.

Önemli Nokta: Değişen Fiyatlandırma'yı uygulamazsanız Google, Otel Listenizdeki tüm otellerin verilerini getirir.

İpucu Yanıtı mesajları, seçilen otelleri ve seyahat planlarını yeniden fiyatlandırmak için aşağıdaki yöntemleri kullanır:

• Tam seyahat planları
• Giriş tarih aralıkları
• Aralıklı konaklamalar

Not: Değiştirilen Fiyatlandırma'yı kullanırken varsayılan konaklama süresi 30 gündür.

İpucu Yanıtı mesajının kök öğesi <Hint> şeklindedir. Bir otelin veya seyahat planının güncellenmesini, bir veya daha fazla <Item> öğesi kullanarak istersiniz. Tek bir İpucu Yanıtı mesajı, herhangi bir sayıda <Item> öğesi tanımlayabilir.

Her İpucu Yanıtı mesajında her <Item> için en az bir <Property> öğesi belirtilmelidir. <Property>, Otel Listesi ile aynı kimlikleri kullanarak bir oteli tanımlar. Varsayılan olarak, her bir <Item> bloğu için tek bir otel kimliği belirtirsiniz. Ancak, yeniden fiyatlandırma için check-in tarih aralıkları veya aralıklı konaklamalar kullanıyorsanız Google'dan bir öğe bloğunda birden fazla otele izin vermesini isteyebilirsiniz.

Tam seyahat planı istek ve yanıt akışı

İpucu mesajları, giriş tarihi ve konaklama süresinin kombinasyonu gibi ayrı seyahat planlarına dayalı olabilir. Bu durumda, otelleriniz için check-in tarihi ve konaklama süresi belirtirsiniz. Google, söz konusu seyahat planı için yeni fiyatlandırma verilerini getirir.

İş ortağının yanıtı

Aşağıdaki İpucu Yanıtı mesajı tek bir tesis ve tek bir seyahat planı tanımlar:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Google'ın yanıtı

Google, İpucu Yanıtı mesajınıza aşağıdakine benzer bir <Query> ile yanıt verir:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

<Transaction> oluştur

Daha sonra aşağıdaki konaklama için otelin fiyat güncellemeleriyle birlikte bir <Transaction> oluşturmanız gerekir:

5/20/23 - 5/23/23

Giriş tarihi aralıkları istek ve yanıt akışı

İpucu Yanıtı mesajı, ilk giriş tarihiyle başlayıp son giriş tarihiyle biten bir giriş tarihleri aralığı belirtebilir. Google yeni fiyatlandırma verilerini getirdiğinde, otel için bu tarihlerle başlayan ve belirttiğiniz konaklama süresine kadar uzanan her giriş tarihi için seyahat planlarını çeker.

İş ortağının belirli tarih aralığı

Aşağıdaki örnek İpucu Yanıtı mesajı, check-in için bir tarih aralığı ile tek bir tesis tanımlar:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Google'ın yanıtı

Google, bu İpucu Yanıtı mesajına aşağıdakine benzer <Query> ile yanıt verir:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

<Transaction> oluştur

Daha sonra bu otel için aşağıdaki konaklamalara yönelik fiyat güncellemeleriyle birlikte bir <Transaction> oluşturmanız gerekir:

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

Bu örnekte 5 gecelik konaklama süresi kullanılmıştır. Varsayılan konaklama süresi 30 gündür.

Aralıklı konaklamalar istek ve yanıt akışı

İpucu Yanıtı mesajı, değişen tarih aralığını içerebilir. Bu şekilde Google, bu tarihlerden herhangi birinden etkilenen seyahat planını getirmesi gerektiği konusunda bilgilendirilir. Getirilen gerçek seyahat planları grubu, hem değişiklik yapılan tarihler kümesi hem de maksimum konaklama süresinden oluşan bir fonksiyondur.

İş ortağının aralıklı konaklamaları

Aşağıdaki örnek İpucu Yanıtı mesajında aralıklı konaklamalar kullanılır:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Google'ın yanıtı

Google, İpucu Yanıtı mesajınıza aşağıdakine benzer bir <Query> ile yanıt verir:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

<Transaction> oluştur

Daha sonra aşağıdaki konaklamalar için otelin fiyat güncellemeleriyle birlikte bir <Transaction> oluşturmanız gerekir:

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23

Not: Aralıklı konaklamalarda, ilk tarihten önce başlayıp onunla çakışanlar da dahil olmak üzere tüm seyahat planlarının yeniden fiyatlandırılması gerekir.

Aralıklı konaklamalar: Toplu işleme sınırları ve sorgu bölme

Google, her çekme sorgusunu en fazla 10.000 otel-seyahat planı çifti (otel, giriş tarihi ve konaklama süresi) kombinasyonuyla sınırlar. Aralıklı Konaklama ipucu için kombinasyon sayısı, Aralıklı Konaklama Sorguları'ndaki otel-seyahat planı çifti kombinasyonlarının sayısını hesaplamak üzere yamuk formülü kullanılarak hesaplanır:

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

Burada:

• Date Span: <FirstDate> ile <LastDate> arasındaki günler dahil olmak üzere gün sayısıdır (Tarih aralığı = SonTarih - İlkTarih + 1).
• LOS: İpucunda istenen maksimum konaklama süresi (örneğin, <AffectedNights>14</AffectedNights>).
• \(N_{\text{hotel_batch_size}}\): Sorgu grubuna dahil edilen mülk sayısıdır (hotel_batch_size aracılığıyla yapılandırılır).

Bir ipucu 10.000 öğeyi aşarsa ne olur?

Hesaplanmış öğelerin sayısı 10.000'i aşarsa Google, sorgu iş yükünü otomatik olarak böler:

1. İlk deneme (aralıklı kalış): <AffectedNights> kullanılarak aralığınızın başlangıcını kapsayan daha küçük bir tarih penceresi gönderilir.
2. İlk yedek (destekleniyorsa - Check-in Range): <Nights> (aşağıdaki sorgu) kullanılarak tarih aralığınızın daha küçük kısımları giriş tarihi Aralığı sorguları olarak gönderilmeye çalışılır.
3. Son Yedek (Tam Seyahat Planları): Sorgu kümesini tam seyahat planlarına genişletmeye geri döneriz.

<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

İstenmeyen sorgu düşürmelerini önlemeye yönelik önerilen uygulamalar

• Mülk toplu işlem boyutlarını dengede tutun: 14'ten fazla gece konaklama süresiyle büyük tarih aralıklarını (ör. 180 ila 365 gün) güncellerseniz ipuçlarının bölünmeyi tetiklemesini önlemek için Google Teknik Hesap Yöneticinizden hotel_batch_size değerini daha düşük bir değere ayarlamasını isteyin.
• Kapsam ipuçlarını daraltın: Google'ı fiyat değişiklikleri konusunda bilgilendirirken <FirstDate> ve <LastDate> aralıklarını, tam bir takvim yılı göndermek yerine ücretlerin gerçekten değiştiği belirli tarih aralıklarıyla sınırlayın.
• İpuçlarınız geniş tarih aralıklarını kapsıyorsa: Çekme isteklerini karşılamak için birden fazla aralıklı sorgu türü kullanılabilmesi amacıyla ayrıştırıcınızın, <FirstDate> ve <LastDate> içeren bloklarında veya karakterlerini kabul ettiğinden emin olun.