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. Google'ın bağlantıyı nasıl oluşturacağını tanımlayabilir, böylece bağlantının kullanıcı ve seyahat planı hakkında tüm ek bilgileri içermesini sağlayabilirsiniz. Ö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 ö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ç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ınızdaki ilgili verilere bağlıdır.

Örneğin, LENGTH değişkeninin değeri, ilgili seyahat planının fiyat feed'inden <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 bir reklamı veya ücretsiz rezervasyon bağlantısını 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?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ıklarsa 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ı bir 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 için 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ısı tıklamaları)

Kullanıcının tıkladığı reklamın bir otel kampanyasından mı geldiğ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, kullanıcı bir otel kampanyası URL'sini tıklarsa sonuç şu URL olur:

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

Otel kampanyası URL'si tıklanmazsa sonuç şu URL olur:

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

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ıyla boş CAMPAIGN-ID'ler

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 ifadeyi 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-PAYMENT-ID örneği (yalnızca Otel Reklamları)

Tıklamanın PPS komisyon programının sonucu olup olmadığına bağlı olarak URL'yi değiştirmek için IF-PAYMENT-ID koşullu ifadesini kullanın. Aşağıdaki örnekte, tıklamanın PPS komisyon programından gelip gelmediği kontrol edilmekte ve sonuca göre booking_source parametresine bir değer atanmaktadır:

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

Otel, Komisyonlar programının bir parçasıysa sonuç aşağıdaki URL'lerden biri olur:

• Google'a atanmış IATA numarası yoksa:

  https://partner.com?hid=123&booking_source=commissions

• Google'a atanmış IATA numarası varsa:

  https://partner.com?hid=123&booking_source=01234567

Aksi takdirde sonuç şu URL olur:

https://partner.com?hid=123&booking_source=cpc

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ı bir 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 ve bu durumda işlem mesajının <Rate> bloğundaki <RateRuleID> öğesinin değerinin kullanılıp kullanılmadığı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?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ındaki 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ı 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

URL'nin test veya otomatik doğrulama amacıyla Google tarafından oluşturulup oluşturulmadığı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

URL, test veya doğrulama amacıyla Google tarafından oluşturulmuşsa 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>
  

  Ayrıca 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.

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