Bu sayfa, Cloud Translation API ile çevrilmiştir.

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, kullanıcı ve seyahat planı hakkındaki tüm ek bilgileri içerecek şekilde 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 örnekte gerçek otel kimliği ve seyahat planı yerine Google'ın değişken adlarını kullanan bir URL gösterilmektedir:

<URL>https://www.partnerdomain.com?hotelID=(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ı otel için 23.05.2023'ten itibaren 6 gecelik 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'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 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:

Değişken	Önerilen/isteğe bağlı	Açıklama
ADVANCE-BOOKING-WINDOW	Optional	Rezervasyon sırasında otelin saat diliminde, giriş tarihinden önceki rezervasyon günlerinin sayısı. Örneğin, `36`.
ALTERNATE-HOTEL-ID	Recommended (if you have separate IDs to identify properties versus booking engines)	Tesisiniz için alternatif bir tanımlayıcı. Bu özellik adı, Otel Listesi Feed'inizde belirtilir. Feed bilgileriniz için bir tesis tanımlayıcısına ve rezervasyon motorunuz için başka bir tesis tanımlayıcısına ihtiyacınız varsa ayrı kimliklere sahip olmak yararlıdır.
CAMPAIGN-ID	Recommended	URL ile ilişkilendirmek istediğiniz Google Ads kampanyasının kimliği. Tıklama bir Google Ads kampanyasıyla ilişkilendirilmemişse bu alan boş bırakılır.
CHECKINDAY	Recommended	Otel Fiyatı Feed'inin `<Checkin>` öğesinde tanımlanan iki basamaklı gün. Örneğin, `20`.
CHECKINDAY-OF-WEEK	Optional	Otelin saat diliminde, girişin yapıldığı saat (`Monday` ile `Sunday` arasında). Örneğin, `Tuesday`.
CHECKINMONTH	Recommended	Otel Fiyatı Feed'inin `<Checkin>` öğesinde tanımlanan iki basamaklı ay. Örneğin, `05`.
CHECKINYEAR	Recommended	Otel Fiyatı Feed'inin `<Checkin>` öğesinde tanımlanan dört basamaklı yıl. Örneğin, `2023`.
CHECKOUTDAY	Recommended	Otel Fiyatı Feed'inin `<Nights>` ve `<Checkin>` öğelerinden hesaplanan iki basamaklı gün. Örneğin, `26`.
CHECKOUTMONTH	Recommended	Otel Fiyatı Feed'inin `<Nights>` ve `<Checkin>` öğelerinden hesaplanan iki basamaklı ay. Örneğin, `05`.
CHECKOUTYEAR	Recommended	Otel Fiyatı Feed'inin `<Nights>` ve `<Checkin>` öğelerinden hesaplanan dört basamaklı yıl. Örneğin, `2023`.
CHILD-AGE	Recommended (must be provided for child occupancy pricing)	Fiyat feed'inin `<Child "age">` öğelerinde belirtilen şekilde her çocuğun maksimum yaşı. Bu değişken `FOR-EACH-CHILD-AGE` koşullu bloğuyla birlikte kullanılmalıdır.
CHILD-INDEX	Optional	Seyahat planında belirtilen her çocuk ve çocuk yaşı için bir sayacı temsil eden 0 dizinli döngü değişkeni. Zorunlu olmasa da bu değişken yalnızca `FOR-EACH-CHILD-AGE` koşullu bloğuyla birlikte kullanılabilir.
CLICK-TYPE	Optional	Kullanıcının listelemeyi standart otel ücreti için mi yoksa Oda Paketi için mi tıkladığını belirtir. Olası değerler: `hotel`: Kullanıcı, listelemeyi standart oda fiyatı için tıklamıştır. `room`: Kullanıcı, listelemeyi Oda Paketi için tıklamıştır.
CLOSE-RATE-RULE-IDS	Optional (only applies if you are using conditional or private rates)	Kullanılamayan ücretler için ücret kuralı kimliklerinin virgülle ayrılmış listesi. Ancak kullanıcı küçük bir işlem yapmışsa bu liste kullanılabilir olabilirdi. Özel indirimler için ücret kuralı kimliklerinin, kullanıcıya ilgili bir kullanıcı arayüzü işlemi gösterildiğinde her zaman burada doldurulacağını unutmayın.
CUSTOM[1-5]	Optional	Özel alan başına 200 karakter sınırıyla `<Result>` öğesinde tanımlanan özel alanların değerleri. Daha fazla bilgi için Transaction Mesajlarına Genel Bakış konusuna bakın. ARI kullanılırken özel alanlar kullanılamaz.
DATE-TYPE	Optional	Kullanıcının varsayılan tarihi mi yoksa aramada sağlanan belirli bir tarihi mi seçtiğini belirtir. Olası değerler: `default`: Kullanıcı, varsayılan tarihlerin kullanıldığı bir otel reklamını veya ücretsiz rezervasyon bağlantısını tıklamıştır. `selected`: Kullanıcı, ayarlanmış bir otel reklamını veya ücretsiz rezervasyon bağlantısını tıklamıştır.
GOOGLE-SITE	Optional	Kullanıcının otel fiyatlandırma verilerinizi görüntülediği Google mülkü. Olası değerler: `localuniversal`: Kullanıcı, otel rezervasyon bağlantısını `google.com` araması yoluyla bulmuştur. `mapresults`: Kullanıcı, otel rezervasyon bağlantısını `maps.google.com` üzerinden bulmuştur. `verification`: Google, bu değeri sitenizde otomatik veri kalitesi testleri gerçekleştirirken kullanır. Bu sorgular için faturalandırılmazsınız. Google Analytics, Otel Reklamları otomatik doğrulama trafiğini tanımlamak için bu parametreyi ve değerini kullanabilir. `unknown`: Kullanıcı, reklamı veya ücretsiz rezervasyon bağlantısını belirsiz bir kaynak üzerinden bulmuştur.
LENGTH	Recommended	Otel Fiyatı Feed'indeki `<Nights>` öğesi tarafından tanımlanan gece sayısı cinsinden konaklama süresi. Örneğin, `3`.
NUM-ADULTS	Recommended (must be used with the `NUM-CHILDREN` or `FOR-EACH-CHILD-AGE` condition)	Kullanıcı tarafından seyahat planı için belirtilen, yetişkin kişi sayısı. Bu değişken `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` veya her ikisi ile birlikte kullanılmalıdır.
NUM-CHILDREN	Recommended	Kullanıcı tarafından seyahat planında belirtilen çocuk (0-17 yaş) sayısı. Çocuklu seyahat planlarına başarıyla katılmak için `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE` veya her ikisi gerekir.
NUM-GUESTS	Recommended (if you don't send child occupancy pricing)	Kullanıcı tarafından seyahat planı için belirtilen, yetişkinler ve çocuklar dahil toplam kişi sayısı. Bu değer, `NUM-ADULTS` ve `NUM-CHILDREN` değerlerinin toplamıdır. Katılımı en üst düzeye çıkarmak için bunun yerine hem `NUM-ADULTS` hem de `NUM-CHILDREN` kullanılması önemle tavsiye edilir.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	Otel Fiyatı Feed'indeki paketin benzersiz tanımlayıcısı. Standart paket için paket kimliği, bir `<Result>` bloğu içindeki `<PackageID>` öğesinin değeridir. Oda Paketi için paket kimliği, Transaction mesajının `<RoomBundle>` veya `<PackageData>` bloğu içindeki `<PackageID>` öğesinin değeridir.
PARTNER-CURRENCY	Optional	Otel Fiyatı Feed'indeki `<Baserate>` öğesinin `currency` özelliği tarafından tanımlanan üç harfli para birimi kodu. Örneğin, `USD` veya `CAD`.
PARTNER-HOTEL-ID	Recommended	Otel Listesi Feed'indeki `<id>` öğesi tarafından tanımlanan benzersiz otel tanımlayıcısı.
PARTNER-ROOM-ID	Recommended (applies if you use Room Bundles)	Otel Fiyatı Feed'indeki benzersiz oda tanımlayıcısı. Standart oda için oda kimliği, `<Result>` bloğu içindeki `<RoomID>` öğesinin bir değeridir. Oda Paketi için oda kimliği, Transaction mesajındaki `<RoomBundle>` veya `<RoomData>` bloklarında `<RoomID>` öğesine atanan değerdir.
PAYMENT-ID	Optional (only applies to Ads)	Önceden tanımlanmış bir dizeye (`commission`) veya komisyon tahsilat acentesi kullanıyorsanız Google'ın atanmış IATA numarasına (örneğin, "01234567") çözümlenir. IATA numaranızın veya önceden tanımlanmış dizenin biçimlendirmesini değiştirmek için Teknik Hesap Yöneticinizle (THY) iletişime geçin.
PRICE-DISPLAYED-TAX	(Optional)	Kullanıcıya kullanıcının yerel para biriminde gösterilen vergi tutarı. `PRICE-DISPLAYED-TAX` değeri, Otel Fiyatı Feed'indeki `<Tax>` öğesinin değeridir. Örneğin, "3,14".
PRICE-DISPLAYED-TOTAL	(Optional)	Kullanıcıya kullanıcının yerel para biriminde gösterilen toplam oda maliyeti. `PRICE-DISPLAYED-TOTAL` değeri, Otel Fiyatı Feed'indeki `<Baserate>`, `<Tax>` ve `<OtherFees>` öğelerinin toplamıdır. Örneğin, "152.13".
PROMO-CODE	(Optional)	ARI promosyonlarını kullanıyorsanız bu değişkenin değeri, uygulanan `<Promotion>` öğesinin `id` özelliğine atanır. Birden fazla promosyon uygulanırsa rastgele sıralanan promosyon kimliklerinin virgülle ayrılmış listesi olur. Ücret kuralları kullanıyorsanız ilgili ücret kuralının uygulanması durumunda bu değişkenin değeri `PromoCode` öğesine atanır.
RATE-PLAN-ID	Recommended (only applies if you use RoomBundles)	Fiyat feed'inin `<RoomBundle>` bloğunda `<RatePlanID>` öğesi tarafından tanımlanan kimlik. `<RatePlanID>`, oda ve paket verisi kombinasyonunun benzersiz tanımlayıcısını temsil eder. Daha fazla bilgi için Oda Paketleri bölümüne bakın.
RATE-RULE-ID	Recommended (only applies if you use conditional rates or private rates)	Fiyat feed'inin `<Rate>` bloğunda `rate_rule_id` özelliği tarafından tanımlanan kimlik. Daha fazla bilgi için Koşullu Fiyatlar bölümüne bakın. Not: Yalnızca gizlenmemiş koşullu fiyatlar veya özel indirimler gösterilir.
USER-COUNTRY	Recommended	Kullanıcının konumunu belirten iki harfli ülke kodu. Bu bilgi, kullanıcının istemci ayarlarından çıkarılır. Örneğin, `US` veya `FR`.
USER-CURRENCY	Recommended	Kullanıcının yerel para birimini belirten üç harfli para birimi kodu. `USER-CURRENCY` değişkeninin değeri, kullanıcının istemci ayarlarından tahmin edilir. Örneğin, `USD` veya `CAD` .
USER-DEVICE	Recommended	Kullanıcının cihaz türü. `USER-DEVICE` değeri şunlardan biri olabilir: `mobile` `tablet` `desktop` `unknown` `USER-DEVICE` değişkeninin değeri, kullanıcının istemci ayarlarından tahmin edilir.
USER-LANGUAGE	Recommended	Reklamın veya ücretsiz rezervasyon bağlantısının görüntüleme dilini belirten iki harfli ISO 639-1 dil kodu. `USER-LANGUAGE` değişkeninin değeri, kullanıcının istemci ayarlarından tahmin edilir. Örneğin, `en` veya `fr`.
USER-LIST-ID (Google Ads'de tanımlı)	Optional (only applies if you use Audience Lists in Google Ads)	Kitle listesini veya kullanıcı bilgilerini içeren Google Ads kullanıcı listesi kimliği. Kitle listeleri, teklif ayarlamalarının belirlenmesi için temel olarak kullanılır. Kullanıcı birden fazla kitle listesinin parçasıysa en büyük teklif ayarlamasına sahip kitle listesi seçilir. En büyük teklif ayarlamasına sahip kitleler arasındaki bağlar rastgele belirlenir.
VERIFICATION	Optional	Bağlantının test veya otomatik doğrulama amacıyla Google tarafından oluşturulup oluşturulmadığını doğrulayan boole değeri. Bağlantı, test veya otomatik doğrulama amacıyla Google tarafından oluşturulduysa `true`, aksi takdirde `false` değeridir.

URL'lerde koşullu mantık

Koşullu olarak uç noktalar 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ı üzerinde yinelenen bir FOR döngü koşulu oluşturur.

IF ve FOR ifadeleri şunları içerir:

Koşul	Önerilen/isteğe bağlı	Açıklama
IF-AD-CLICK (yalnızca Otel Reklamları)	Optional	Kullanıcı tıklamasının kaynağı reklamsa `true` olarak çözümlenir. Kullanıcı tıklamasının kaynağı ücretsiz rezervasyon bağlantısıysa `false` olarak çözümlenir.
IF-CLICK-TYPE-HOTEL	Optional	Kullanıcı bir girişi otelle ilgili olarak tıkladıysa `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-CLICK-TYPE-ROOM	Optional	Kullanıcı bir listelemeyi Oda Paketi için tıkladıysa `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-CLOSE-RATE-RULE-IDS	Optional	Kullanıcı uygun olmadığı için bir veya daha fazla koşullu kullanılamıyorsa `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir. Kullanıcıya özel indirim kullanıcı arayüzü işlemi gösterildiyse varsayılan olarak `true` kullanılır.
IF-DEFAULT-RATE	Optional	Kullanıcı, varsayılan tarihlerin kullanıldığı bir otel girişini tıkladıysa `true` olarak çözümlenir. Aksi takdirde `false` olarak çözümlenir.
IF-HOTEL-CAMPAIGN	Optional	Kullanıcı tıklamasının kaynağı otel kampanyasıysa `true` olarak çözümlenir, aksi takdirde `false` olarak çözümlenir. Bu ayrım, Google Ads'de birden fazla kampanya türü bulunan iş ortaklarının ilişkilendirmeyi ayırmasına yardımcı olur.
IF-PAYMENT-ID (yalnızca Otel Reklamları)	Recommended (if you use pay-per-stay Google Ads campaigns)	Konaklama Başına Ödeme (PPS) komisyon programındaki oteller için `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-PROMO-CODE	Optional	Kullanıcı, belirli bir `PromoCode` içeren ARI promosyonuna veya ücret kuralına dayalı bir fiyatı tıkladıysa `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-PROMOTED (yalnızca Otel Reklamları)	Recommended (if you use Promoted hotels)	Kullanıcı bir Tesis Tanıtım Reklamını tıkladıysa `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-RATE-RULE-ID	Optional	Kullanıcı koşullu fiyat seçtiyse `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-USER-LIST-ID (Google Ads'de tanımlı)	Optional	Kullanıcı, kitle listeleri için teklif çarpanlarını ayarlarken belirttiğiniz bir Google Ads müşteri listesi kimliğinin üyesiyse `true` olarak çözümlenir; aksi takdirde `false` olarak çözümlenir.
IF-VERIFICATION	Optional	Bağlantı, test veya otomatik doğrulama amacıyla Google tarafından oluşturulduysa `true` olarak çözümlenir. Aksi takdirde `false` olarak çözümlenir.
ELSE	Recommended (if you use any conditional IF statements)	Önceki koşul karşılanmazsa bu koşulu izleyen değerler URL'ye eklenir.
END-IF	Optional (required if you have any IF conditional statements)	`IF` ifadesi koşullu bloğunu sonlandırır.
FOR-EACH-CHILD-AGE	Optional (required for child occupancy pricing)	Fiyat feed'indeki her `<Child "age">` öğesi için bir kez yürütülür. Örneğin, `<OccupancyDetails>`, `<Child age="17">` ve `<Child age= "17">` iki öğesini içeriyorsa yönerge iki kez yürütülür.
END-FOR-EACH	Optional (required if using FOR-EACH block)	`FOR-EACH` ifadesi koşullu bloğunu sonlandırır.

IF-AD-TIKLAMA örneği

Kullanıcının açılış sayfanıza yönlendirmek için reklam mı yoksa ü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ı bir reklamı tıklamadıysa sonuç şu URL olur:

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 açık Oda Paketi olmayan bir otel seçip seçmediğini kontrol eden bir koşullu blok oluşturabilirsiniz. Bir Transaction mesajının <Room Bundle> bloğundaki <RatePlanID> öğesinin değeri, kullanıcının seçtiği dolaylı olarak ilişkilendirilen 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-TIKLAYIN-TYPE-ROOM örneği

Kullanıcının bir 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 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ı 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 şu 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ıları tıklamaları)

Kullanıcının otel kampanyasından gelen 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ı bir otel kampanyası URL'sini tıklarsa sonuç şu URL olur:

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

Tıklama otel kampanyası URL'sinde (ör. normal arama ağı kampanyası) değilse 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.

FBL tıklamaları içeren 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 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-PAYMENT-ID örneği (yalnızca Otel Reklamları)

Tıklamanın PPS komisyon programının sonucu olup olmadığına göre URL'yi değiştirmek için IF-PAYMENT-ID koşullu ifadesini kullanın. Aşağıdaki örnekte, bir tıklamanın PPS komisyon programından gelip gelmediği kontrol edilir ve sonuca göre booking_source parametresine bir değer atanı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ç 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ı 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. Bu durumda, 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ımlanmış)

Google Ads'deki bir otel kampanyasında kitle listeleri için teklif çarpanları ayarlarsanız web sitenizde belirli bir Google Ads kitle listesine ait müşteri için parametre ayarlamak üzere IF-USER-LIST-ID ile USER-LIST-ID birlikte kullanabilirsiniz. Bunu, izleme amacıyla veya web sitenizi kitle listelerinin üyeleri için özelleştirmek 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 için mi yoksa otomatik doğrulama için mi oluşturduğunu kontrol etmeniz gerekirse IF-VERIFICATION 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ç şu URL olur:

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

Google, test veya doğrulama için URL'yi 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 sırasıyla 0 ve 17 yaşlarında 2 yetişkin ve 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 genel kurallar

Tüm değişkenler isteğe bağlıdır. Açılış sayfası URL'nize değişken eklemeniz gerekmez. Bununla birlikte, seyahat planını ve kullanıcı bilgilerini iletmek için değişkenlerin kullanılması 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 bir açılış sayfaları dosyasında tanımlarken aşağıdaki genel kurallar geçerlidir:

Tüm değişkenler parantez içine alınır.
Sorgu dizesi parametreleri yalnızca URL'deki soru işaretinden ("?") sonra aktarılabilir.
Sorgu dizesi parametreleri, nihai çıkışta "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ış "&amp" varlığını kullanmanız gerekir. Son çıkış, gerçek bir "&" karakteri oluşturur. Örneğin:
```

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>


<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
```
Ayrıca, açılış sayfası URL'sine ekleyebileceğiniz özel karakterleri de URL olarak kodlamanı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 çizgilerin ("-") URL kodlamalı olması gerekmez. URL kodlamalı olması gereken yaygın karakterlerin listesi için URL Kodlama Tablosu'na 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 bir parametre (checkinDate) 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şkenlerin listesiyle sınırlıdır.
Mevcut değişkenler listesine ek olarak en fazla beş özelleştirilebilen değişken kullanabilirsiniz.