Sorgu mesajları, Google'ın fiyatlandırma veya meta veri güncellemeleri için yaptığı isteklerdir. Bunlar hem Çekme hem de Değiştirilen Fiyatlandırma iletim modlarıyla kullanılır.
<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, belirtilen otellerdeki oda ve paket bilgileri hakkında veri isteyen bir Sorgu mesajı gönderir.
Google'ın Sorgu mesajları ve Gerçek Zamanlı Fiyatlandırma Sorguları için kullandığı uç noktayı ilk yapılandırmanız sırasında tanımlarsınız. Daha fazla bilgi için Teknik Hesap Yöneticinizle (THY) iletişime geçin.
Google, Sorgu mesajını Content-Type
üstbilgisinin "uygulama/xml" ve User-Agent
üstbilgisinin Google-HotelAdsPrices
olarak ayarlandığı bir HTTP POST
isteği olarak gönderir. Bu kuralın istisnası,
Google-TravelAds-Live
üzerinden fiyat uç noktası entegrasyonu. Bu örnek sorgular User-Agent
üstbilgisini içerebilir veya içermeyebilir.
Sorgu mesajlarının ayrıntılı biçimlendirmesi Sorgu XML Referansı konusunda bulunabilir.
Fiyatlandırma sorgusu mesajları
Fiyatlandırma Sorgusu mesajları, fiyatlarını sağladığınız tesis ve seyahat planı kombinasyonlarını belirtir.
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:
Gerçek zamanlı fiyatlandırma: Etkinleştirilirse kullanıcı belirtilen tesis veya seyahat planı kombinasyonunun fiyatlarına aktif olarak göz atarken sorgular gönderilir ve yanıt vermeniz için belirli bir zaman aralığı vardır.
Bağlamla: Bu seçenek etkinleştirildiğinde, Google'ın size gönderdiği her sorguya kullanıcı bağlamı önerileri eklenir. Bu öneriler, belirli tesis veya seyahat planı kombinasyonlarını arayan en yaygın kullanıcı türlerini yansıtır. Bu önerileri uygulamak, yanıtlarınızın verimliliğini artırabilir.
Meta veri: Bu, belirtir.
Gerçek zamanlı fiyatlandırma sorguları
Gerçek zamanlı fiyatlandırma sorguları, kullanıcı aramalarına yanıt olarak gerçek zamanlı fiyat güncellemeleri için Google'ın yaptığı isteklerdir. Google, bir kullanıcıdan otel veya seyahat planı kombinasyonu için arama isteği alır ve fiyatlandırma verisi mevcut veya güncel olmadığından arama sırasında sizden 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 Sorgusu isteklerinin bir yanıt süresi sınırı vardır. Bu genellikle 4.000 milisaniyedir. Bu sınır, gerçek zamanlı fiyatlandırma sorgusu isteğinde belirtilir. Süre sınırı dahilinde yanıt verilemezse ilgili fırsat için katılımın kaçırılmasıyla sonuçlanır. Ancak önbelleğe alınıp gelecekteki fırsatlarda kullanılabilmesi için gene de bir fiyat sağlamanızı öneririz. 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 bağlamsaldır ve şu parametreler için fiyat alabilir: kullanıcı ülkesi, cihaz türü, doluluk (konuk sayısı) ve bu konukların yetişkin veya çocuk olup olmadığı. Gerçek zamanlı fiyatlandırma sorguları sayesinde müşterinin aramasıyla eşleşen daha güncel fiyatlar gösterebilirsiniz.
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ı, otel veya seyahat planı kombinasyonu fiyatlarının Google'da olmadığı durumlarda boşlukları doldurmaya yardımcı olur.
Gerçek zamanlı fiyatlandırma sorgularını kullanma kuralları
İstenen seyahat planının alışılmadık olması (ör. çok uzak bir gelecekteki tarihler) veya otelin çok nadir aranması sebebiyle söz konusu seyahat planı için önbelleğe alınmış veri olmadığında.
İ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, aynı otel veya seyahat planı için bir daha sorgu yapılmasına gerek olmaması için Gerçek Zamanlı Fiyatlandırma sonuçlarını genellikle önbelleğe alır. Hem tek otel veya seyahat planı kombinasyonlarını hem de birden fazla otel veya tek seyahat planı kombinasyonlarını isteyebilir.
Bağlam içeren gerçek zamanlı fiyatlandırma özelliği; kullanıcının cihaz türüne, arama yaptığı ülkeye ve çocuklar dahil kişi sayısına göre Google'ın belirli gerçek zamanlı fiyatlandırma istekleri göndermesini sağlar. 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. Bu kombinasyonlar için popüler olan kullanıcı bağlamlarının listesini içerir. Koşullu Fiyatlar kullanılıyorsa tüm olası kullanıcı bağlamları için fiyatlar göndermek pahalı olabilir. Bu nedenle, yanıtınızı sınırlamak için bu kullanıcı bağlamları listesini kullanabilirsiniz. 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.
Bağlam ile ilgili sorgular almak istiyorsanız Teknik Hesap Yöneticisi (THY) Bu tür mesajları almaya hazır olduğunuzu onaylayabilir ve ardından sorgulardaki kullanıcı bağlamlarını size göndermeye başlamak için yapılandırma ayarı yapabilir.
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, Google'dan gelen sorgu mesajlarının konusu olabilecek tesisler ve seyahat planlarını nasıl kontrol edebileceğiniz açıklanmaktadır.
Seyahat planı sınırları
Fiyatlandırma sorgularının olası sınırlarını belirlemek için
<ItineraryCapabilities>
. Desteklediğiniz tarih aralığını ve maksimum konaklama süresini belirleyen kuralları tanımlarsınız.
Tüm otel veya seyahat planı kombinasyonları için geçerli olacak varsayılan <MaxAdvancePurchase>
ve <MaxLengthOfStay>
değerleri ayarlayabilirsiniz. Ayrıca bu ayarları otel grupları için de tanımlayabilirsiniz.
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 Sorgu XML Referansı konusunda bulunabilir.
Örnek seyahat planı
Aşağıdaki örnekte 4 otel için 23 Mayıs 2023'ten itibaren 3 gecelik fiyat güncellemeleri isteyen bir fiyatlandırma <Query>
gösterilmektedir:
<?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ı 500 milisaniye olan bir Gerçek Zamanlı Fiyatlandırma Sorgusu gösterilmektedir:
<?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 bu tür 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ı, check-in tarih aralıkları, tam seyahat planları veya aralıklı seyahat planları için kullandığınız ipucu türüne bağlıdır. Bu ipucu türlerinin her biri hakkında daha fazla bilgi için İpucu Yanıt Mesajları konusuna bakın.
Aşağıdaki örnekte, check-in tarih aralıkları için fiyatlandırma <Query>
mesajı gösterilmektedir:
<?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ı konaklamalar için fiyatlandırma <Query>
mesajı gösterilmektedir:
<?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 tesislere ilişkin 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ımlayan bir Transaction mesajıyla yanıt verirsiniz. Daha fazla bilgi için Oda ve paket meta verilerini tanımlama konusuna bakın.