Sorgu Mesajları

Sorgu mesajları, Google'ın fiyatlandırma veya meta veri güncellemeleri için yaptığı isteklerdir. Onlar hem Alınan hem de Değiştirilen Fiyatlandırma ile kullanılır iletim modları hakkında daha fazla bilgi edinin.

<Query>, sorgu mesajlarının kök öğesidir.

Sorgu mesajının yapısı, mesajın türüne bağlıdır:

• Fiyatlandırma: Google, belirtilen otellerin sayısı.

• Meta veri: Google, odayla ilgili verileri isteyen bir Sorgu mesajı gönderir. ve paket bilgilerine yer verin.

Google'ın Sorgu mesajları ve Canlı Yayın için kullandığı uç noktayı tanımlarsınız İlk yapılandırmanız sırasında Fiyatlandırma Sorguları. Daha fazla bilgi için Teknik Hesap Yöneticinizle (THY) iletişime geçin.

Google, Content-Type ile HTTP POST isteği olarak bir Sorgu mesajı gönderir. başlığı "application/xml" olarak ayarlandı Ayrıca User-Agent başlığı Google-HotelAdsPrices. Bu kuralın istisnası, Google-TravelAds-Live aracılığıyla fiyat uç noktası entegrasyonu. Bu örnek sorgular User-Agent başlığını içerebilir veya içermeyebilir.

Sorgu mesajları için ayrıntılı biçimlendirme şurada bulunabilir: Sorgu XML Referansı.

Fiyatlandırma sorgusu mesajları

Fiyatlandırma Sorgusu mesajları, hangi tesisin veya seyahat planı kombinasyonlarının kullanılacağını belirtir. fiyatları siz sağlarsınız.

Sunucunuz bir fiyatlandırma Sorgusu mesajı aldığında İstenen fiyatlandırma bilgilerini içeren <Transaction> mesajı.

Daha fazla bilgi için Fiyatlandırmaya Genel Bakış konusuna bakın.

Üç özel sorgu mesajı türü vardır:

1. Gerçek zamanlı fiyatlandırma: Etkinleştirilirse sorgular, kullanıcı etkin bir şekilde belirtilen tesis veya seyahat planı kombinasyonuna göz atmak ve belirli bir zaman aralığına sahip olmalıdır.

2. Bağlam ile: Bu ayar etkinleştirilirse kullanıcı bağlamı önerileri, Google'ın size gönderdiği her bir sorgu ve öneriler, Belirli bir tesis veya seyahat planını arayan yaygın kullanıcı türleri emin olun. Bu önerilere uymak, projenizin size yardımcı olabilir.

3. Meta veri: belirtir.

Gerçek zamanlı fiyatlandırma sorguları

Gerçek zamanlı fiyatlandırma sorguları, Google'ın anlık fiyat güncellemeleri için yaptığı isteklerdir. en iyi performansı gösterir. Google, kullanıcıdan (örneğin, fiyatlandırma verileri mevcut ya da mevcut olmaması nedeniyle) otel veya seyahat planı kombinasyonu Google, arama sırasında sizden bir fiyat güncellemesi ister. Entegre Gerçek zamanlı fiyatlandırma sorgulamasında, Google bir fiyat alıp bunu arama anında gösterilir.

Tüm gerçek zamanlı fiyatlandırma sorgu isteklerinin bir yanıt süresi sınırı vardır. en fazla 4.000 milisaniye. Bu sınır, Gerçek zamanlı fiyatlandırma sorgusunda belirtilir isteğinde bulunabilirsiniz. Bir yanıt, süre sınırı içinde sağlanamazsa Fırsat için kaçırılan katılım olabilir. Ancak şunu öneririz: Önbelleğe alınabilmesi ve gelecekteki fırsatlar için kullanılabilmesi için yine de bir fiyat sağlamalıdır. Yanıtın bağlantısı on dakika boyunca veya İş ortağının yapılandırmasında belirtilir.

Gerçek zamanlı fiyatlandırma sorguları da içeriğe dayalıdır ve Kullanıcının ülkesi, cihaz türü, doluluk (misafir sayısı), ve bu konukların yetişkin mi yoksa çocuk mu olduğu. Gerçek zamanlı fiyatlandırma sorgularıyla müşterinin aramasıyla eşleşen daha güncel fiyatlar gösterebilir.

Gerçek zamanlı fiyatlandırma sorguları, fiyatlandırma için ikincil mekanizma olarak tasarlanmıştır. güncellemelerine göz atın. Yeniden fiyatlandırma için birincil mekanizma hâlâ Alınan veya Değiştirilen şeklindedir fiyatlandırma. Gerçek zamanlı fiyatlandırma sorguları, Google'ın gerçek zamanlı olarak otel veya seyahat planı kombinasyonları için fiyatlar.

Önemli Nokta: Yeni Arama deneyimi nedeniyle, Kullanıcı bir AEA ülkesindeyse ve ilgili sorunlar söz konusu olduğunda Canlı Sorgu artık kullanılamaz aramada tarihler veya değişiklik tarihleri içeren gezinme amaçlı (otele özgü) bir sorgu sonuç sayfası.

Gerçek zamanlı fiyatlandırma sorgularını kullanma kuralları

• İstenen seyahat planı nedeniyle belirtilen seyahat planı için önbelleğe alınmış veri yok. olması, örneğin tarihler çok ileride olması veya otelin seyrek olarak arandı.

• İstenen tarih, varsayılan olmayan bir tarih.

: Not: Varsayılan tarihler, Gerçek zamanlı fiyatlandırma sorguları için uygun değildir. Mevcut Fiyatlandırma sorguları yalnızca varsayılan olmayan tarihler için istenir.

Google genellikle Gerçek zamanlı fiyatlandırma sonuçlarını önbelleğe alır. Böylece, aynı otel veya seyahat planı tekrar sorgulanmaz. Hem tek otel hem seyahat planı için istekte bulunabilir kombinasyonları ve birden fazla otel veya tek seyahat planı kombinasyonları oluşturabilirsiniz.

Bağlam içeren gerçek zamanlı fiyatlandırma özelliği, Google'ın belirli bir Kullanıcının cihaz türüne (kullanıcının kullandığı ülke) göre belirlenen gerçek zamanlı fiyatlandırma istekleri ve çocuklar dahil kişi sayısını görebilirsiniz. Hem Sorgu mesajı ve İşlem mesajı, Sorgu parametrelerini tanımlayan <Context> öğesi. Alınan fiyatlar: Bağlam içeren gerçek zamanlı fiyatlandırma sorguları Oda Paketi olarak önbelleğe alınabilir. Belirli bir kişi için geçerli olan bir fiyatsa ve Koşullu Fiyat olarak kullanıcının ülkesi veya cihazı için geçerliyse.

Bağlam sorgularıyla

Bağlam sorguları ise veritabanımızı güncelleyen belirtilen tesis veya seyahat planı kombinasyonlarını sağlar. Kullanıcı listesi içeren farklı bağlamları vardır. Eğer Koşullu Fiyatlar kullanılırsa olası tüm kullanıcı bağlamları için gönderme ücretleri pahalı olabilir, bu nedenle Bu kullanıcı bağlamı listesini, yanıtınızı sınırlandırmak için kullanın. Yalnızca şu tarih için iade fiyatları: Belirtilen kullanıcı bağlamları, alakalı kullanıcı sorgularının büyük çoğunluğunu kapsamaktadır.

Önemli Bilgi: Bağlam ile ilgili sorguları almak istiyorsanız lütfen Teknik Hesap Yöneticinizle (THY) iletişime geçin. Sizin durumunuz hakkında bu tür mesajları almaya hazır olmak ve ardından başlamak için kullanıcı bağlamlarını size sorgularda göndererek.

Meta veri sorgusu mesajları

Meta veri sorgu mesajları, oda ve paket bilgileriyle ilgili ayrıntıları içerir belirtilen özellikler için.

Bir meta veri Sorgu mesajı aldığınızda İstenen tesisler için fiyatlandırmayı belirten bir <Transaction> mesajı <Result> öğelerinde.

Daha fazla bilgi için Oda ve paket meta verilerini tanımlama bölümüne bakın.

Kontrol sorguları

Bu bölümde, hangi tesisleri ve seyahat planlarını nasıl kontrol edebileceğiniz açıklanmaktadır. Google'dan gelen Sorgu mesajlarının konusu olabilir.

Seyahat planı sınırları

Fiyatlandırma sorgularının olası sınırlarını belirlemek için <ItineraryCapabilities>. Tarih aralığını belirleyen kurallar tanımlarsınız ve desteklediğiniz maksimum konaklama süreleri.

<MaxAdvancePurchase> ve <MaxLengthOfStay> için varsayılan değerler ayarlayabilirsiniz Tüm otel veya seyahat planı kombinasyonları için geçerli olan Bu iki rolü de otel grupları için ayarlar.

Sorgu mesajı örnekleri

Bu bölümde, fiyatlandırma Sorgusu mesajları ve meta verilerle ilgili çeşitli örnekler gösterilmektedir Sorgu mesajı. Daha fazla örnek için Sorgu XML Referansı.

Örnek seyahat planı

Aşağıdaki örnekte fiyat güncellemeleri isteyen bir fiyatlandırma <Query> gösterilmektedir 4 otel için, 3 gecelik ve 23 Mayıs 2023'ten itibaren:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

Bu örnekte her otel için fiyatlandırma güncellemeleri istenmiştir:

5/23/18 - 6/26/18

Gerçek zamanlı fiyatlandırma sorgusu örneği

Aşağıdaki örnekte yanıt süresi sınırı olan bir gerçek zamanlı fiyatlandırma sorgusu gösterilmektedir (500 milisaniye):

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

Şu örnekte tek bir otel için fiyat istenmiştir:

6/23/23 - 6/25/23

Bu sorguya verilen örnek işlem mesajı yanıtını Fiyatlandırma ve Oda Envanteri (İşlemler) XML Referansı

Bağlam sorgu örneğiyle

Aşağıdaki örnekte Bağlam İçeren bir sorgu örneği gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

Bağlam ile birlikte sorgular yalnızca kullanıcının ülke bağlamını belirtir. Gelecekte, sorguları kullanıcının cihazını ve doluluk oranını da belirtebilir.

Check-in tarih aralıkları

Değiştirilen Fiyatlandırma kullanıyorsanız Sorgu mesajının yapısı giriş tarih aralıkları için kullandığınız ipucu türü üzerinde, tam veya aralıklı seyahat planları. Bunların her biri hakkında daha fazla ipucu türleri için İpucu Yanıtı Mesajları bölümüne bakın.

Aşağıdaki örnekte, check-in tarihi için fiyatlandırma <Query> mesajı gösterilmektedir aralıklar:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

Bu örnekte, aşağıdaki konaklamalar için fiyatlandırma güncellemeleri istenmiştir (her otel):

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

Aralıklı Konaklamalar

Aşağıdaki örnekte, aralıklı reklam grubu için fiyatlandırma <Query> mesajı gösterilmektedir konaklama yeri:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

Bu örnekte her otel için fiyatlandırma güncellemeleri istenmiştir:

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

Ayrıca belirtilen geceden önce başlayan (ancak içeren) konaklamalar:

5/20/23 - 5/23/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

Meta veri sorgusu mesajı

Aşağıdaki örnekte, meta veri isteğinde bulunan bir <Query> mesajı gösterilmektedir Çeşitli tesisler için oda ve paket bilgilerinde güncellemeler yapıldı:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

Bu tür Sorgu mesajlarına oda ve paket meta verilerini tanımlar. Daha fazla bilgi için bkz. Oda ve paket meta verilerini tanımlama.