Değişkenler ve koşullar

Otel Reklamları ve ücretsiz rezervasyon bağlantıları, kullanıcıların oda rezervasyonu yapabilir. 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 tarihlerini girin.

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ülenir, URL'deki dinamik bilgi gerçek değerler. Açılış sayfası URL'lerinize dinamik değerler eklemek için şu söz dizimi:

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

Aşağıdaki örneklerde gerçek otel kimliği ve seyahat planı:

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ı şu etkinlik için bir oda ayırttıysa: 42 numaralı otel için 23.05.2023'ten itibaren 6 gece, Google önceki bağlantıyı oluşturur şu şekildedir:

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şkeni Otel Listesi'ndeki <id> öğesinde tanımlanıyor Kullanıcının arama ölçütleriyle eşleşen özet akışı.

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.

URL değişkenleri

Aşağıdaki tabloda, sonuçları düzenlemek için kullanabileceğiniz oluşturun:

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 bunu izleyen değerler koşulu URL'ye eklenir, aksi takdirde ELSE yönergesi eklendi.

• 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 bir reklamı tıklayıp tıklamadığını kontrol eden bir koşullu blok oluşturabilirsiniz: açılış sayfanıza yönlendiren ücretsiz rezervasyon bağlantısıdır.

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 olur: URL:

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

Kullanıcı reklamı tıkladıysa sonuç aşağıdaki URL olur:

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

IF-CLICK-TYPE-HOTEL örneği

Kullanıcının otel seçip seçmediğini kontrol eden bir koşullu blok oluşturabilirsiniz. oda paketi eksik. <RatePlanID> öğesinin Bir Transaction mesajının <Room Bundle> bloğu dolaylı olarak ayarlanır kullanıcının seçtiği ilişkilendirilmiş oda paketi fiyatı.

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 olur: URL:

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

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

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

IF-TIKLAYIN-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

Aşağıdaki gibi bir tarih olmayan parametre ayarlamak için IF-DEFAULT-DATE koşullu ifadesini kullanın: kullanıcı eğer seçim yapmazsa web siteniz özel davranışı tetiklemek için kullanabilir bir tarihtir.

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ı bir tarih seçmediyse sonuç benzer olabilir değerini gösteren aşağıdaki URL'yi eklemeniz gerekir:

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

Kullanıcı bir tarih seçtiyse sonuç şu URL'ye benzer olabilir: seçtikleri seyahat planına bağlı olarak:

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 reklamınızı tıklamasını önleyen bir reklamı tıklayıp tıklamadığını kontrol eden bir koşullu blok oluşturabilirsiniz: kaynağı bir otel kampanyasıdır.

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ç aşağıdaki URL:

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ı içeren boş CAMPAIGN-ID'ler

Tıklama ücretsiz rezervasyon bağlantısından gelirse IF-HOTEL-CAMPAIGN geri gelir. TRUE ve CAMPAIGN-ID değeri, aşağıdaki URL'de gösterildiği gibi boş olarak ayarlanmış:

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 Komisyon programının parçasıysa sonuç şu 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 bir öğeyi tıklayıp tıklamadığını kontrol eden bir koşullu blok oluşturabilirsiniz: Tesis tanıtım reklamı.

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çta aşağıdaki URL'dir:

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 reklam öğesi seçip seçmediğini kontrol eden bir koşullu blok koşullu fiyat ve bu durumda <RateRuleID> değeri öğesi, işlem mesajının <Rate> bloğunda 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'de bir otel kampanyasında kitle listeleri için teklif çarpanları ayarlarsanız ayarlamak için IF-USER-LIST-ID öğesini USER-LIST-ID ile birlikte kullanabilirsiniz. Google Ads hesabı için belirli bir Google Ads hesabına ait kitle listesi. Bunu, izleme amacıyla veya verilerinizi Kitle listelerinin üyeleri için bir web sitesidir.

<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

Google'ın URL'yi test amacıyla mı yoksa otomatikleştirilmiş mi yoksa 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

Her öğe için maksimum yaşı dolduran bir koşullu blok oluşturabilirsiniz: çocuk odası (Otel Fiyatı Feed'inde belirtildiği gibi).

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 0 ile 17 yaşlarında 2 çocuk varsa sonuç şöyle 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 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. Nihai çıkış, gerçek bir "&" oluşturur karakteriyle ayrılır. Ö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. Ortak çalışanların URL kodlamalı olması gereken karakterler, danışma URL Kodlaması.

• 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 sonucunda, aşağıdaki gibi bir URL elde edilir:

  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.