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)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&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:
|
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:
|
GOOGLE-SITE | Optional | Kullanıcının otel fiyatlandırma verilerinizi görüntülediği Google mülkü.
Olası değerler:
|
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
Ücret kuralları kullanıyorsanız ilgili ücret kuralının uygulanması durumunda bu değişkenin değeri |
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:
|
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 takdirdeELSE
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)&adType=1(ELSE)&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)&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)&nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&popup_datepicker=true(ELSE)&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)&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)&hotel_campaign=(CAMPAIGN-ID)(ELSE)&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)&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)&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)&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)&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)&children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&hid=(PARTNER-HOTEL-ID)&</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ış "&" varlığını kullanmanız gerekir. Son çıkış, gerçek bir "&" karakteri oluşturur. Örneğin:
<!-- Do this: --> <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&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 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.
- boşluk (" "): Boşluk karakterlerini
Tek bir parametreye ilişkin değerler birden çok değişkenden oluşturulabilir. Aşağıdaki örnekte
CHECKINDAY
,CHECKINMONTH
veCHECKINYEAR
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.