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ına bağlantılar içerir. Bağlantının kullanıcı ve seyahat planı hakkında ek bilgiler 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 check-in 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örüntülendiğ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 örnekte, 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çermesi için değişkenleri gerçek değerlerle değiştirir. Örneğin, kullanıcı 42 numaralı otel için 23.05.2023 tarihinden itibaren 6 gecelik oda rezervasyonu yaptığında, 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'inizdeki, Otel Listesi Feed'inizdeki ve kullanıcı ayarlarındaki 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 <Checkin> öğesinden çıkarılı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ğerlerin kaynakları hakkında daha fazla bilgi için Fiyatlandırmaya genel bakış ve Otel Listesi konularına bakın.

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

Koşullu olarak uç nokta oluşturmak için açılış sayfaları dosyasının <URL> öğesinde özel yönergeler kullanabilirsiniz.

Koşullu mantık şu 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ına göre iterasyon yapan bir FOR döngü 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 reklam mı, ücretsiz rezervasyon bağlantısı mı tıkladığını kontrol eden bir koşullu 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ı 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 belirli bir oda paketi olmadan otel seçip seçmediğini kontrol eden bir koşullu blok oluşturabilirsiniz. Transaction mesajının <Room Bundle> bloğundaki <RatePlanID> öğesinin değeri, kullanıcının seçtiği örtük olarak ilişkilendirilmiş 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ı Oda Paketi seçtiyse sonuç şu URL olur:

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

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

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

IF-CLICK-TYPE-ROOM örneği

Kullanıcının Oda Paketi seçip seçmediğini kontrol eden bir koşullu 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ı Oda Paketi seçmediyse sonuç şu URL olur:

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

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

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

IF-DEFAULT-DATE örneği

Kullanıcı bir tarih seçmediyse web sitenizin özel davranışı tetiklemek için kullanabileceği, tarih olmayan 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 edilir:

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

Bu örnekte, kullanıcı tarih seçmediyse sonuç, varsayılan tarih seçimlerini gösteren şu URL'ye benzeyebilir:

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

Kullanıcı tarih seçtiyse sonuç, seçtiği seyahat planına bağlı olarak şu URL'ye benzeyebilir:

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ıları tıklamaları)

Kullanıcının otel kampanyası kaynaklı bir reklamı tıklayıp tıklamadığını kontrol eden bir koşullu 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, kullanıcı otel kampanyası URL'sini tıklarsa sonuç şu URL olur:

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

Otel kampanyası URL'si (ör. normal Arama Ağı kampanyası) tıklanmazsa sonuç şu URL olur:

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

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

Ücretsiz rezervasyon bağlantısı tıklamaları içeren boş KAMPANYA KİMLİKLERİ

Tıklama ü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 boş kampanya kimliğini ö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-PROMOTED örneği (yalnızca Otel Reklamları)

Kullanıcının Tesis Tanıtım Reklamı tıklayıp tıklamadığını kontrol eden bir koşullu 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ı Tesis Tanıtım Reklamı seçtiyse sonuç şu URL olur:

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

Kullanıcı Tesis Tanıtım Reklamı seçmediyse sonuç şu URL olur:

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

IF-RATE-RULE-ID örneği

Kullanıcının koşullu fiyat seçip seçmediğini kontrol eden bir koşullu 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.

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;customerType=42(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&customerType=42

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

Google Ads'deki bir otel kampanyasında kitle listeleri için teklif çarpanları belirlerseniz IF-USER-LIST-ID ile USER-LIST-ID öğesini birlikte kullanarak web sitenizde belirli bir Google Ads kitle listesine dahil bir müşteri için parametre ayarlayabilirsiniz. Bunu, izleme amacıyla veya web sitenizi kitle listelerinin üyelerine özelleştirmek için 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 otomatik doğrulama amacıyla oluşturup oluşturmadığını kontrol etmeniz gerekiyorsa IF-VERIFICATION kullanabilirsiniz.

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

Bu örnekte, URL test veya doğrulama amacıyla Google tarafından oluşturulmamışsa sonuç şu URL olur:

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

Google, URL'yi test veya doğrulama amacıyla oluşturduysa sonuç şu URL olur:

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

FOR-EACH-CHILD-AGE örneği

Otel Fiyatı Feed'inde belirtildiği gibi, her çocuk için maksimum yaşı dolduran bir koşullu 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ç şu 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ç şu 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 değişken eklemeniz gerekmez. Ancak seyahat planı ve kullanıcı bilgilerini iletmek için değişkenler kullanmak, genellikle kullanıcı için daha iyi bir deneyim oluşturur ve Google'ın politikalarına uymanıza yardımcı olur.

Oluşturulan URL'leri açılış sayfaları dosyasında tanımlarken aşağıdaki genel kurallar geçerli olur:

• Tüm değişkenler parantez içine alınır.

• Sorgu dizesi parametreleri son çıktıda "ve" işaretiyle ("&") ayrılmalıdır. Ve işareti XML'de özel bir karakter olduğundan ve açılış sayfaları dosya biçimi XML olduğundan. Bu nedenle, onun yerine kodlanmış "&" varlığını kullanmanız gerekir. Son çıktı gerçek bir "&" karakteri oluşturur. Ö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>
  

  Açılış sayfası URL'sine ekleyebileceğiniz özel karakterlere de URL kodlama uygulamanız gerekir. Örneğin:

  • boşluk (" "): Boşluk karakterlerini <URL> öğesinde "%20;" ile değiştirin
  • düz eğik çizgi ("/"): Düz eğik çizgileri <URL> öğesinde "%2F;" ile değiştirin

  Alfabetik olmayan tüm karakterlere URL kodlama uygulanmalıdır. Örneğin, kısa çizgi işaretine ("-") URL kodlama uygulanması gerekmez. URL kodlama uygulanması gereken genel karakterlerin listesi için URL Kodlama konusuna bakın.

• Tek bir parametreye ilişkin değerler birden çok değişkenden oluşturulabilir. Aşağıdaki örnekte CHECKINDAY, CHECKINMONTH ve CHECKINYEAR değişkenlerinden tek checkinDate parametresi oluşturulur:

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

  Bu örneğin sonucu şuna benzer bir URL olur:

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

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

• Kullanılabilir değişkenlerin listesine ek olarak en fazla beş adet özelleştirilebilen değişken kullanabilirsiniz.