İletim modu, otel ve seyahat planı kombinasyonları için fiyatlandırma güncellemelerini Google'a nasıl göndereceğinizi belirler. İletim modunuzu ayarlamak için ilk yapılandırmanız sırasında Teknik Hesap Yöneticiniz (THY) ile birlikte çalışırsınız.
İletim modlarına genel bakış
Varsayılan olarak oteller, odanın müsait olduğu tarihten maksimum 330 gün önce ve maksimum 30 gece konaklama için sorgulanabilir ancak maksimum seyahat planı sayısını (check-in tarihi ve konaklama süresi kombinasyonu) siz belirleyebilirsiniz.
Ne kadar çok seyahat planı desteklerseniz o kadar çok açık artırmaya katılırsınız. Bununla birlikte, ne kadar çok seyahat planı desteklerseniz fiyatlandırma verilerinizin doğru kalması için Google'a o kadar fazla veri göndermeniz gerekir.
Fiyatları güncellemenin tipik yöntemleri, Transaction mesajlarını aşağıdaki yollardan biriyle kullanır:
ARI (Push): Tesisleriniz için önceden tanımlanmış fiyatlandırma stratejileri ayarlamak üzere ücret planları, müsaitlik durumu ve otel meta verilerini kullanan bir fiyatlandırma iletim feed'idir. Çekme ve Değiştirilen Fiyatlandırma modlarından farklı olarak, ARI feed'leri belirli fiyatları veya seyahat planlarını sorgulamaz. Bunun yerine, tesisleriniz için çeşitli ücret ayrıntılarına, kısıtlamalara ve müsaitlik durumuna dayalı olarak bir fiyatlandırma modelini temsil eden bir bilgi alt kümesi içeren mesajlar iletirsiniz. ARI feed'leri, müsaitlik durumunu ve fiyatlandırmayı tanımlamak için OTA XML spesifikasyonunu (
OTA_HotelRateAmountNotifRQ
veOTA_HotelAvailNotifRQ
) kullanır. ARI iletim modu hakkında daha fazla bilgi edinmek ve bu feed türünün hesabınız için uygun olup olmadığını belirlemek için hesap yöneticinizle iletişime geçin. Daha fazla bilgi için ARI'yi kullanma bölümüne bakın.Çekme: Google, fiyatlandırma ve müsaitlik durumu verileri önbelleğini tazelemek için hizmetinizi düzenli olarak sorgular. Bu modelde Google sunucunuza bir istek gönderir ve sunucunuz güncellenmiş verilerle yanıt verir. Bu model, fiyatlandırma bilgilerinin ne zaman değiştiğini bilmeyen veya fiyatlandırma bilgilerinin gün içinde düzensiz bir şekilde değiştiği durumlar için idealdir. Fiyatlar, Google'ın algoritmaları iş ortağına özgü önceki fiyat değişiklikleri geçmişine göre fiyatların eskidiğini belirleyene kadar önbellekte kalır. Daha fazla bilgi için Çekme iletim modunu kullanma bölümüne bakın.
Değiştirilen Fiyatlandırma (eski adıyla İpuçlarıyla Çekme): Çekme moduna benzer ancak Google, tüm tesisler için değil, yalnızca bir tesis alt kümesi için veri ister. Bu mod, tesisleriniz için fiyatları ve müsaitlik durumunu güncellerken ağ trafiği miktarını önemli ölçüde azaltabilir. Fiyatlar güncellenene kadar süresiz olarak önbellekte kalır. Daha fazla bilgi için Değiştirilen Fiyatlandırmayı Kullanma bölümüne bakın.
Transaction mesajlarını, fiyatları güncellemenin yanı sıra envanterinizden tesis kaldırmak için de kullanabilirsiniz. Daha fazla bilgi için Envanter Kaldırma bölümüne bakın.
Transaction mesajı örnekleri de dahil olmak üzere fiyatlandırma güncellemeleri sağlama hakkında daha fazla bilgi için Fiyatları Güncelleme konusuna bakın.
Gerçek Zamanlı Fiyatlandırma Sorguları
Google ayrıca Gerçek Zamanlı Fiyatlandırma Sorguları kullanarak açık artırma zamanında bazı fiyat güncellemeleri isteyebilir. Gerçek Zamanlı Fiyatlandırma Sorguları, mevcut bir açık artırma için Google'dan gelen fiyatlandırma istekleridir. Belirtilen zaman aralığı içinde yanıt verirseniz reklamınız açık artırmada görünür.
Google, Gerçek Zamanlı Fiyatlandırma Sorgusu yanıtını diğer Transaction mesajlarında olduğu gibi depolar. Sonuç olarak Google, gelecekte başka bir Gerçek Zamanlı Fiyatlandırma Sorgusu göndermek yerine fiyatı önbellekten sunabilir.
Daha fazla bilgi için Gerçek Zamanlı Fiyatlandırma Sorguları bölümüne bakın.
Bağlam
Google, yanıtlarınızı çeşitli farklı kullanıcılara reklam yayınlamak için kullanılabilecek bir önbelleği doldurmak amacıyla kullandığından, çekme ve değişen fiyat sorguları genellikle kullanıcıyla ilgili bilgileri belirtmez.
Olası kullanıcı bağlamlarının tam kümesine karşılık gelen fiyatları döndürmeniz maliyetli olabileceğinden, popüler kullanıcı bağlamlarının sorgu kapsamında belirtildiği bir özellik test edilmektedir. Kullanıcı bağlamları, fiyat gösterme fırsatı bulduğunuz kullanıcı isteklerine dayanır ve kullanıcı isteklerinin büyük çoğunluğunu kapsayacak şekilde hesaplanır. Çok popüler tesisler veya seyahat planları için çok sayıda kullanıcı bağlamı görebilirsiniz ancak ortalama kullanıcı bağlamı sayısı 10'dan az olmalıdır. Ek fiyatlar döndürebilir veya belirtilen kullanıcı bağlamlarını yoksayabilirsiniz. Belirli bir sorgu için hangi fiyatları döndüreceğinize siz karar verirsiniz. Ancak önerilen kullanıcı bağlamını yoksaymak trafiğin azalmasına neden olabilir.
ARI Push yayın modu
ARI Push iletim moduyla; gecelik fiyat, müsaitlik durumu, envanter sayısı veya diğer kısıtlamalar her değiştiğinde Google'a artımlı güncellemeler gönderirsiniz. Çekme veya Değiştirilen Fiyatlandırma modlarından farklı olarak ARI Push, fiyatlandırma bilgilerinin çeşitli bileşenlerindeki güncellemeleri Google'a etkili bir şekilde iletmek için farklı bir fiyatlandırma modeli kullanmanıza olanak tanır.
Aşağıdaki şemada ARI Push iletim modu için istek ve yanıt akışı gösterilmektedir:
1. Adım: ARI Push mesajlarını Google'a gönderin
Verilerinizi ARI Push ile güncellemek için verileriniz her değiştiğinde bir ARI istek mesajı gönderin. ARI Push iletim modu, çeşitli mesaj türlerini ve fiyatlandırma stratejilerini destekler. Mesaj aktarmayla ilgili ayrıntılı bilgi için ARI'yi kullanma bölümüne bakın.
Fiyatlarınız Google tarafından sunulmalı ve bir mesaj alındıktan sonra 15-20 dakika içinde kullanıcılara gösterilmelidir.
2. Adım: Verilerin Google tarafından başarıyla önbelleğe alındığını doğrulayın
Alınan her ARI Push mesajı için Google, HTTP bağlantı durumu ve ARI işleme sonuçlarıyla yanıt verir. Sunucu ile bağlantı başarılı olursa Google bir HTTP 200 OK
ile yanıt verir. Mesajda, güncellemelerin başarıyla uygulandığını veya yayınlama modu uyarıları/hatalarıyla karşılaşıldığını belirten yanıt mesajı içeren bir gövde metni bulunur.
IP Adreslerini İzin Verilenler Listesine Ekleme
ARI mesajlarını Google'a aktarmak için kullandığınız IP adreslerini izin verilenler listesine eklemek için Hotel Center ARI fiyat ayarları sayfasına bakın. Hotel Center'da fiyat ayarlarınızı nasıl güncelleyeceğinizi öğrenin.
ARI Push ile oda ve paket meta verilerini güncelleme
Her tesiste etkin oda türlerini ve ücret planlarını (paketler) tanımlamak için Transaction (Tesis Verileri) mesaj türünü kullanın.
Oda türleri veya ücret planları eklendiğinde, kaldırıldığında veya değiştirildiğinde güncellemeler aktarmanız gerekir. Bu durumda, <RoomData>
ve <PackageData>
öğelerinde yeni bilgiler içeren bir XML mesajı gönderirsiniz. Bu öğeler, <PropertyDataSet>
öğesinin alt öğeleridir.
Bağlantı veya içerik hataları
XML'nin bozuk biçimli veya hatalı olması nedeniyle iletim modu hatası alırsanız Feed Durumu Hata Mesajları'nda önerilen çözümü bulun.
Google'a ARI mesajı gönderirken HTTP bağlantı hatası alırsanız isteği 1, 5 ve 20 dakikalık aralıklarla tekrar deneyin. 3 denemeden sonra sorun devam ederse mesaj göndermeyi durdurun ve Google Destek Ekibi ile iletişime geçin.
Pull yayın modu
Çekme iletim modunda Google, fiyat güncellemeleri istemek için sunucunuza düzenli olarak sorgu mesajları gönderir. Sunucunuz bu mesajlara, güncellenmiş fiyatlandırma ve müsaitlik durumu verilerini içeren Transaction mesajları ile yanıt verir.
Aşağıdaki şemada Çekme modu için istek/yanıt akışı gösterilmektedir:
Google, fiyat güncellemelerini aldıktan sonra genellikle yaklaşık 5 dakika içinde yeni fiyatlandırma ve müsaitlik durumu verilerini işler.
Aşağıdaki bölümlerde bu adımların her biri ayrıntılı olarak açıklanmıştır.
1. adım: Sorgu mesajı
Varsayılan olarak Google, Otel Listenizde tanımlanan tüm tesisler için Sorgu mesajları gönderir. Bu, yeniden fiyatlandırma sürecinde birden fazla Sorgu mesajı alacağınız anlamına gelebilir.
Google'ın sunucunuza gönderdiği fiyatlandırma Sorgu mesajları aşağıdaki özelliklere sahiptir:
- Kök öğe
<Query>
öğesidir. - İlk yapılandırmanız sırasında tanımlanan uç noktaya gönderilir. Daha fazla bilgi için Teknik Hesap Yöneticinizle (THY) iletişime geçin.
- HTTP
POST
yöntemini kullanır. (HTTPS kullanıyorsanız alanın resmi bir sertifika yetkilisi tarafından imzalanması gerekir.) Content-Type
üstbilgisiapplication/xml
olarak ayarlanır.- Her mesajda Google'ın fiyatlandırma ve müsaitlik durumu verilerini isteyeceği en fazla 100 tesis bulunabilir.
User-Agent
üstbilgisiGoogle-HotelAdsPrices
olarak ayarlanır.
2. Adım: İşlem mesajı
Sunucunuz bir Sorgu mesajı aldığında, istenen seyahat planları için fiyat bilgilerini içeren bir Transaction mesajıyla yanıt vermelidir.
Bir Transaction mesajının kök öğesi <Transaction>
şeklindedir. Daha fazla bilgi için Transaction Mesajları ve Fiyatları Güncelleme konularına bakın.
Oda ve paket meta verilerini güncelleme
Fiyatlandırma verilerini Çekme ile güncellemenin yanı sıra Transaction mesajlarını oda ve paket meta verilerinizi güncellemek için de kullanabilirsiniz. Daha fazla bilgi için Oda ve paket meta verilerini tanımlama bölümüne bakın.
Değiştirilen fiyatlandırma yayınlama modu
Değiştirilen Fiyatlandırma, fiyatlandırma güncellemeleri için Sorgu ve Transaction mesajlarının boyutunu ve miktarını azaltmaya yardımcı olur. Değiştirilen Fiyatlandırma'yı kullandığınızda, Google'a fiyatları güncellenen tesislerin listesini gönderirsiniz. Google, yalnızca bu tesislerin fiyatlarını isteyen bir Sorgu mesajıyla yanıt verir.
Google'ın İpucu İsteği mesajlarını gönderdiği uç noktayı yapılandırmak için Teknik Hesap Yöneticinizle (THY) görüşün. Bunu ilk yapılandırma sırasında ayarlamış olabilirsiniz.
Aşağıdaki şemada, Değiştirilen Fiyatlandırma için istek ve yanıt akışı gösterilmektedir:
Aşağıdaki bölümlerde bu akıştaki adımların her biri açıklanmaktadır.
1. Adım: İpucu İsteği mesajı
Google'ın sunucunuza gönderdiği İpucu İsteği mesajları aşağıdaki özelliklere sahiptir:
- Kök öğe
<HintRequest>
öğesidir. - İlk yapılandırmanız sırasında tanımlanan uç noktaya gönderilir. Daha fazla bilgi için Teknik Hesap Yöneticinizle (THY) iletişime geçin.
- HTTP
POST
yöntemini kullanın. (HTTPS kullanıyorsanız alanın resmi bir sertifika yetkilisi tarafından imzalanması gerekir.) Content-Type
üstbilgisiapplication/xml
olarak ayarlanır.- Google belirli bir sıklıkta, sunucunuza bir İpucu İsteği mesajına son yanıt verdiğiniz zamanı tanımlayan bir zaman damgası gönderir.
User-Agent
üstbilgisiGoogle-HotelAdsPrices
olarak ayarlanır.
Sıklığı 5 dakika olarak ayarlamanızı öneririz. İpucu İsteği mesajlarının sıklığını ayarlamak veya değiştirmek için bize ulaşın.
Google'dan bir İpucu İsteği mesajı aldığınızda, bu zaman damgasından bu yana güncellenen tüm fiyatlarla yanıt verirsiniz. Daha fazla bilgi için İpucu İsteği mesajları bölümüne bakın.
2. Adım: İpucu Yanıtı mesajı
Sunucunuz, bir İpucu İsteği mesajına bir İpucu Yanıtı mesajıyla yanıt verir. Bu mesaj, bir İpucu İsteği mesajını aldığınız ve yanıtladığınız son tarihten sonra fiyatları değişen tesisler için otel kimliklerini ve seyahat planlarını içerir.
İpucu Yanıtı mesajının kök öğesi <Hint>
şeklindedir. Daha fazla bilgi için İpucu Yanıtı Mesajları bölümüne bakın.
3. Adım: Sorgu mesajı
Google, İpucu Yanıt mesajını alır ve tıpkı standart Çekme modunda olduğu gibi bir Sorgu mesajıyla yanıt verir. Aradaki fark, Sorgu mesajının artık yalnızca İpucu Yanıtı mesajında belirttiğiniz tesislere ilişkin otel kimliklerini ve seyahat planlarını içermesidir. Bir Sorgu mesajının kök öğesi <Query>
şeklindedir.
Google, Değiştirilen Fiyatlandırma ile hangi otel kimliklerinin fiyatlarının isteneceğini belirlerken Otel Listesi Feed'inizin içeriğini yoksayar. Bu, Google'dan aldığınız Sorgu mesajının boyutunu ve yanıtınızın Transaction mesajının boyutunu önemli ölçüde azaltır.
4. Adım: İşlem mesajı
Google'ın Sorgu mesajlarına yanıt olarak, fiyatlandırma güncellemesi içeren bir Transaction mesajı gönderirsiniz. Bir Transaction mesajının kök öğesi <Transaction>
şeklindedir. Daha fazla bilgi için Çekme iletim modu konusuna bakın.