Değişkenler ve koşullar

Otel reklamları ve ücretsiz rezervasyon bağlantıları, kullanıcıların oda rezervasyonu yapabileceği açılış sayfalarının bağlantılarını içerir. Bağlantının kullanıcı ve seyahat planı hakkında tüm ek bilgileri içermesi için Google'ın bağlantıyı nasıl oluşturacağını tanımlayabilirsiniz. Örneğin, otel kimliği, dil, para birimi kodları ve giriş tarihleri gibi bilgileri URL'ye ekleyebilirsiniz.

Genel Bakış

Açılış sayfası URL'sini açılış sayfaları dosyasında tanımlarsınız. Reklam veya ücretsiz rezervasyon bağlantısı gösterildiğinde URL'deki dinamik bilgiler gerçek değerlerle değiştirilir. Açılış sayfası URL'lerinize dinamik değerler eklemek için aşağıdaki söz dizimini kullanın:

<URL>https://partner_url?param_id=(variable_name)</URL>

Aşağıdaki örneklerde, gerçek otel kimliği ve seyahat planı yerine Google'ın değişken adlarını kullanan bir URL gösterilmektedir:

1. Örnek

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

2. Örnek

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Arama sonuçları sayfası için açılış sayfası bağlantısı oluşturulduğunda Google, URL'nin dinamik bilgileri içerdiğinden emin olmak için değişkenleri gerçek değerlerle değiştirir. Örneğin, kullanıcı 42 numaralı otelde 23.05.2023'ten itibaren 6 gece için oda rezervasyonu yaparsa Google, önceki bağlantıyı aşağıdaki gibi oluşturur:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Google'ın sorgu dizesindeki değişkenlere atadığı değerler, Otel Fiyat Feed'iniz, Otel Listesi Feed'iniz ve kullanıcı ayarlarınızdaki ilgili verilere bağlıdır.

Örneğin, LENGTH değişkeninin değeri, ilgili seyahat planının fiyat feed'indeki <Nights> öğesine atanır. Benzer şekilde, PARTNER-HOTEL-ID değişkeninin değeri, kullanıcının arama ölçütleriyle eşleşen Otel Listesi Feed'indeki <id> öğesinde tanımlanır.

Bazı değişkenler, fiyat feed'i öğelerinin alt kümeleridir. Örneğin, CHECKINDAY, CHECKINMONTH ve CHECKINYEAR değişkenleri, fiyat feed'indeki tek bir <Checkin> öğesinden ayıklanır. Diğer değişkenler, kullanıcının yerel ayarına ve diğer istemci ayarlarına göre hesaplanır.

Değişken değerlerinin kaynakları hakkında daha fazla bilgi için fiyatlandırmaya genel bakış ve Otel Listesi bölümlerini inceleyin.

URL değişkenleri

Aşağıdaki tabloda, açılış sayfası URL'nizi oluşturmak için kullanabileceğiniz değişkenler açıklanmaktadır:

URL'lerde koşullu mantık

Uç noktaları koşullu olarak oluşturmak için açılış sayfası dosyasının <URL> öğesinde özel yönergeler kullanabilirsiniz.

Koşullu mantık aşağıdaki ifadeleri destekler:

• if_statement: true ise bu koşulu izleyen değerler URL'ye eklenir. Aksi takdirde, ELSE yönergesini izleyen değerler eklenir.

• for_statement: Sağlanan değerlerin sayısı üzerinde yinelenen bir FOR döngüsü koşulu oluşturur.

IF ve FOR ifadeleri şunları içerir:

IF-AD-CLICK örneği

Kullanıcının açılış sayfanıza yönlendirilmek için bir reklamı mı yoksa ücretsiz rezervasyon bağlantısını mı tıkladığını kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfası dosyasında bu yönergeyi kullanır:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Bu örnekte, kullanıcı bir reklamı tıklamadıysa sonuç şu URL olur:

https://www.partner.com?hid=123&adType=0

Kullanıcı reklamı tıkladıysa sonuç şu URL olur:

https://www.partner.com?hid=123&adType=1

IF-CLICK-TYPE-HOTEL örneği

Kullanıcının açık bir oda paketi olmadan otel seçip seçmediğini kontrol eden koşullu bir blok oluşturabilirsiniz. Bir işlem mesajının <Room Bundle> bloğundaki <RatePlanID> öğesinin değeri, kullanıcının seçtiği dolaylı olarak ilişkili oda paketi fiyatına ayarlanır.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Bu örnekte, kullanıcı bir oda paketi seçmediyse sonuç şu URL olur:

https://partner.com/landing?hid=123

Kullanıcı bir Oda Paketi seçtiyse sonuç şu URL olur:

https://partner.com/landing_room?hid=123

IF-CLICK-TYPE-ROOM örneği

Kullanıcının bir RoomBundle seçip seçmediğini kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Bu örnekte, kullanıcı bir oda paketi seçmediyse sonuç şu URL olur:

https://partner.com/landing?hid=123

Kullanıcı bir Oda Paketi seçtiyse sonuç şu URL olur:

https://partner.com/landing_room?hid=123

IF-CLOSE-RATE-RULE-IDS örneği

Kullanıcının bağlılık programı üyeleri için özel indirimli fiyatlara veya özel indirimlere erişimi olup olmadığını kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Bu örnekte, kullanıcı özel fiyattan yararlanamıyorsa sonuç şu URL olur:

https://partner.com?hid=123

Kullanıcı bir bağlılık programının üyesiyse ve özel indirimden yararlanabiliyorsa sonuç aşağıdaki URL olur:

https://partner.com?hid=123&rate_rule=sample_qr

Aşağıdaki örnekte, kullanıcının özel fiyat, koşullu özel fiyat veya herkese açık fiyat için uygun olup olmadığını kontrol etmek amacıyla iç içe yerleştirilmiş IF koşullarıyla giriş tarihi, çıkış tarihi ve doluluk ayrıntılarını içeren bir koşullu fiyat mantığı gösterilmektedir:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

Kullanıcı özel fiyattan yararlanmaya uygunsa sonuç şu URL olur:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr

Kullanıcı koşullu özel fiyata uygunsa sonuç şu URL olur:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users

Kullanıcı herkese açık bir fiyattan yararlanmaya uygunsa sonuç şu URL olur:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

IF-DEFAULT-DATE örneği

Kullanıcı bir tarih seçmediyse web sitenizin özel davranışı tetiklemek için kullanabileceği tarih dışı bir parametre ayarlamak üzere IF-DEFAULT-DATE koşullu ifadesini kullanın.

Aşağıdaki örnekte, varsayılan tarihin kullanılıp kullanılmadığı kontrol edilmektedir:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Bu örnekte, kullanıcı bir tarih seçmediyse sonuç, varsayılan tarih seçimlerini gösteren aşağıdaki URL'ye benzer olabilir:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Kullanıcı bir tarih seçtiyse sonuç, seçtiği seyahat planına bağlı olarak aşağıdaki URL'ye benzer olabilir:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN örneği (Otel reklamları ve ücretsiz rezervasyon bağlantısı tıklamaları)

Kullanıcının tıkladığı reklamın bir otel kampanyasından gelip gelmediğini kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfası dosyasında bu yönergeyi kullanır:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Bu örnekte, tıklama bir otel kampanyası URL'sinde değilse (ör. normal Arama Ağı kampanyası) sonuç şu URL olur:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Kullanıcı bir otel kampanyası URL'sini tıklarsa sonuç şu URL olur:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Bu, otel kampanyası tıklamalarının trafiğini diğer tıklamalardan ayırt etmek istediğinizde kullanışlıdır.

FBL tıklamaları içeren boş CAMPAIGN-ID'ler

Tıklama bir ücretsiz rezervasyon bağlantısından geliyorsa IF-HOTEL-CAMPAIGN, TRUE değerini döndürür ve CAMPAIGN-ID değeri aşağıdaki URL'de gösterildiği gibi boş olarak ayarlanır:

https://www.partner.com?hotelID=123&hotel_campaign=

Aşağıdaki örnekte gösterildiği gibi, kampanya kimliğinin boş olmasını önlemek için IF-AD-CLICK koşullu ifadesini kullanabilirsiniz:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-MODIFICATIONS-IDS

Kullanıcının ARI fiyat değişiklikleri mesajını güncelleyip güncellemediğini kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfası dosyasında bu yönergeyi kullanır:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

Bu örnekte, kullanıcı ARI fiyat değişiklikleri mesajını değiştirmediyse sonuç şu URL olur:

https://partner.com?hid=123

Kullanıcı, ARI fiyat değişiklikleri mesajını güncellediyse sonuç aşağıdaki URL olur:

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

İndirim için promosyon kodunun, ARI Promosyonları veya ücret kuralı mesajları aracılığıyla yapılandırılan, belirtilen kullanıcıya ait ücretle bağlantılı olup olmadığını kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

Bu örnekte, promosyon kodu geçersizse sonuç şu URL olur:

https://partner.com?hid=123

Kullanıcının geçerli bir promosyon kodu varsa ve indirimden yararlanabiliyorsa sonuç aşağıdaki URL olur:

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

IF-PROMOTED örneği (yalnızca Otel Reklamları)

Kullanıcının bir tesis tanıtım reklamını tıklayıp tıklamadığını kontrol eden koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Bu örnekte, kullanıcı bir tesis tanıtım reklamı seçmediyse sonuç şu URL olur:

https://partner.com/0?hid=123

Kullanıcı bir tesis tanıtım reklamı seçtiyse sonuç şu URL olur:

https://partner.com/1?hid=123

IF-RATE-RULE-ID örneği

Kullanıcının koşullu fiyat seçip seçmediğini kontrol eden koşullu bir blok oluşturabilirsiniz. Kullanıcı koşullu fiyat seçtiyse işlem mesajının <Rate> bloğundaki <RateRuleID> öğesinin değeri kullanılır. Daha fazla bilgi edinin.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Bu örnekte, kullanıcı koşullu fiyat seçmediyse sonuç şu URL olur:

https://www.partner.com?hid=123

Kullanıcı koşullu fiyat seçtiyse sonuç şu URL olur:

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

IF-USER-LIST-ID örneği (Google Ads'de tanımlanır)

Google Ads'deki bir otel kampanyasında kitle listeleri için teklif çarpanları ayarlarsanız belirli bir Google Ads kitle listesine ait olan müşteriler için web sitenizde parametre ayarlamak üzere IF-USER-LIST-ID ile USER-LIST-ID parametrelerini birlikte kullanabilirsiniz. Bunu izleme amacıyla veya web sitenizi kitle listelerinin üyeleri için özelleştirmek amacıyla yapmak isteyebilirsiniz.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

Bu örnekte, kullanıcı bir kitle listesinin üyesi değilse sonuç şu URL olur:

https://www.partner.com?hid=123

Kullanıcı 12345678 kitle listesinin üyesiyse sonuç şu URL olur:

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION örneği

Google'ın URL'yi test veya doğrulama amacıyla oluşturup oluşturmadığını kontrol etmeniz gerekiyorsa IF-VERIFICATION aracını kullanabilirsiniz.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Bu örnekte, Google test veya doğrulama için URL oluşturmadıysa sonuç aşağıdaki URL olur:

https://www.partner.com?hid=123

Google, URL'yi test veya doğrulama için oluşturduysa sonuç aşağıdaki URL olur:

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE örneği

Otel fiyat feed'inde belirtilen şekilde, her çocuk konuğun maksimum yaşını dolduran koşullu bir blok oluşturabilirsiniz.

Aşağıdaki örnek, açılış sayfaları dosyasında bu yönergeyi kullanır:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

Bu örnekte, seyahat planında 2 yetişkin ve sırasıyla 0 ve 17 yaşlarında 2 çocuk varsa sonuç aşağıdaki URL olur:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Seyahat planında 2 yetişkin ve 0 çocuk varsa sonuç aşağıdaki URL olur:

https://www.partner.com?adults=2&children=0&hid=123

URL oluştururken uyulması gereken genel kurallar

Tüm değişkenler isteğe bağlıdır. Açılış sayfası URL'nize herhangi bir değişken eklemeniz gerekmez. Ancak seyahat planı ve kullanıcı bilgilerini iletmek için değişkenleri kullanmak genellikle kullanıcı için daha iyi bir deneyim oluşturur ve Google'ın politikalarına uymanıza yardımcı olur.

Açılış sayfaları dosyasında oluşturulmuş URL'ler tanımlanırken aşağıdaki genel kurallar geçerlidir:

• Tüm değişkenler açık ve kapalı parantezlerle çevrilidir.

• Sorgu dizesi parametreleri, nihai çıktıda ve işareti ("&") ile ayrılmalıdır. Çünkü ve işareti XML'de özel bir karakterdir ve açılış sayfaları dosya biçimi XML'dir. Bu nedenle, bunun yerine kodlanmış öğe olan "&" ifadesini kullanmanız gerekir. Nihai çıktıda gerçek bir "&" karakteri oluşturulur. Örneğin:

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  Ayrıca, açılış sayfası URL'sine ekleyebileceğiniz özel karakterleri URL olarak kodlamanız gerekir. Örneğin:

  • boşluk (" "): <URL> öğesindeki boşluk karakterlerini "%20;" ile değiştirin.
  • Eğik çizgi ("/"): <URL> öğesindeki eğik çizgileri "%2F;" ile değiştirin.

  Alfabetik olmayan tüm karakterlerin URL kodlamalı olması gerekmez. Örneğin, kısa çizgilerin ("-") URL kodlamalı olması gerekmez. URL kodlamalı olması gereken yaygın karakterlerin listesi için URL Kodlaması bölümüne bakın.

• Tek bir parametrenin değerleri birden fazla değişkenden oluşturulabilir. Aşağıdaki örnekte, CHECKINDAY, CHECKINMONTH ve CHECKINYEAR değişkenlerinden tek bir parametre (checkinDate) oluşturulmaktadır:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  Bu örnek, aşağıdaki gibi bir URL ile sonuçlanır:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• Sorgu dizesi parametrelerinin adı için herhangi bir kimlik kullanabilirsiniz. Sunucunuz bu değerleri işler. Ancak ilettiğiniz değerler, kullanılabilir değişkenler listesi ile sınırlıdır.

• Mevcut değişkenler listesine ek olarak en fazla beş özelleştirilebilen değişken kullanabilirsiniz.