Halaman ini diterjemahkan oleh Cloud Translation API.

Variabel dan kondisi

Iklan Hotel dan link pemesanan gratis menyertakan link ke halaman landing tempat pengguna dapat memesan kamar. Anda dapat menentukan cara Google membuat link untuk menyertakan semua informasi tambahan tentang pengguna dan itinerarinya. Misalnya, Anda dapat menyertakan informasi seperti ID hotel, bahasa, kode mata uang, dan tanggal check in di URL.

Ringkasan

Tentukan URL halaman landing di file halaman landing. Saat iklan atau link pemesanan gratis ditampilkan, informasi dinamis di URL akan diganti dengan nilai sebenarnya. Untuk menambahkan nilai dinamis ke URL halaman landing Anda, gunakan sintaksis berikut:

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

Contoh berikut menampilkan URL yang menggunakan nama variabel Google, bukan ID hotel dan itinerari sebenarnya:

Contoh 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

Contoh 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

Saat link halaman landing dibuat untuk halaman hasil penelusuran, Google mengganti variabel dengan nilai sebenarnya untuk memastikan URL menyertakan informasi dinamis. Misalnya, jika pengguna memesan kamar untuk 6 malam mulai 23/5/2023 untuk hotel #42, Google akan merender link sebelumnya sebagai berikut:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Nilai yang ditetapkan Google ke variabel dalam string kueri bergantung pada data yang sesuai di Feed Harga Hotel, Feed Daftar Hotel, dan setelan pengguna Anda.

Misalnya,nilai variabel LENGTH ditetapkan ke elemen <Nights> dari feed harga itinerari yang terkait. Demikian pula, nilai variabel PARTNER-HOTEL-ID ditentukan dalam elemen <id> dari Feed Daftar Hotel yang cocok dengan kriteria penelusuran pengguna.

Beberapa variabel adalah subkumpulan dari elemen feed harga. Misalnya, variabel CHECKINDAY, CHECKINMONTH, dan CHECKINYEAR diekstrak dari elemen <Checkin> tunggal di feed harga. Variabel lainnya dihitung berdasarkan setelan lokal pengguna dan setelan klien lainnya.

Untuk mengetahui informasi selengkapnya tentang sumber nilai variabel, lihat Ringkasan harga dan Daftar Hotel.

Variabel URL

Tabel berikut menjelaskan variabel tersedia yang dapat Anda gunakan untuk membuat URL halaman landing:

Variabel	Direkomendasikan/opsional	Deskripsi
ADVANCE-BOOKING-WINDOW	Optional	Jumlah hari pemesanan di awal sebelum tanggal check-in dalam zona waktu hotel pada saat pemesanan. Misalnya, `36`.
ALTERNATE-HOTEL-ID	Recommended (if you have separate IDs to identify properties versus booking engines)	ID alternatif untuk properti Anda. Nama atribut ini ditentukan di Feed Daftar Hotel Anda. Memiliki ID terpisah berguna jika Anda memerlukan satu ID properti untuk informasi feed dan ID properti lainnya untuk mesin pemesanan Anda.
CAMPAIGN-ID	Recommended	ID kampanye Google Ads yang ingin Anda kaitkan dengan URL. Kolom ini kosong jika klik tidak terkait dengan kampanye Google Ads.
CHECKINDAY	Recommended	Dua digit hari yang ditentukan di elemen `<Checkin>` dari Feed Harga Hotel. Misalnya, `20`.
CHECKINDAY-OF-WEEK	Optional	Hari dalam seminggu —`Monday` hingga `Sunday`, saat check-in dilakukan, dalam zona waktu hotel. Misalnya, `Tuesday`.
CHECKINMONTH	Recommended	Dua digit bulan yang ditentukan di elemen `<Checkin>` dari Feed Harga Hotel. Misalnya, `05`.
CHECKINYEAR	Recommended	Empat digit tahun yang ditentukan di elemen `<Checkin>` dari Feed Harga Hotel. Misalnya, `2023`.
CHECKOUTDAY	Recommended	Dua digit hari yang dihitung dari elemen `<Nights>` dan `<Checkin>` dari Feed Harga Hotel. Misalnya, `26`.
CHECKOUTMONTH	Recommended	Dua digit bulan yang dihitung dari elemen `<Nights>` dan `<Checkin>` dari Feed Harga Hotel. Misalnya `05`.
CHECKOUTYEAR	Recommended	Empat digit tahun yang dihitung dari elemen `<Nights>` dan `<Checkin>` dari Feed Harga Hotel. Misalnya `2023`.
CHILD-AGE	Recommended (must be provided for child occupancy pricing)	Usia maksimum setiap anak seperti yang ditentukan di elemen `<Child "age">` dari feed harga. Variabel ini harus digunakan bersama dengan blok bersyarat `FOR-EACH-CHILD-AGE`.
CHILD-INDEX	Optional	Variabel loop terindeks 0 yang merepresentasikan penghitung untuk setiap tamu anak dan usia anak yang ditentukan dalam itinerari. Meskipun tidak wajib, variabel ini hanya dapat digunakan bersama dengan blok bersyarat `FOR-EACH-CHILD-AGE`.
CLICK-TYPE	Optional	Menunjukkan apakah pengguna mengklik listingan untuk tarif hotel standar atau untuk Paket Kamar. Nilai yang mungkin adalah: `hotel`: Pengguna mengklik listingan untuk tarif kamar standar. `room`: Pengguna mengklik listingan untuk Paket Kamar.
CLOSE-RATE-RULE-IDS	Optional (only applies if you are using conditional or private rates)	Daftar ID aturan tarif yang dipisahkan koma untuk tarif yang tidak tersedia, tetapi mungkin tersedia jika pengguna telah melakukan tindakan minor. Perhatikan bahwa ID aturan tarif untuk tarif khusus selalu diisi di sini saat perlakuan UI yang sesuai ditampilkan kepada pengguna.
CUSTOM[1-5]	Optional	Nilai untuk kolom kustom yang ditentukan dalam elemen `<Result>` dengan batas 200 karakter per kolom kustom. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Pesan Transaksi. Kolom kustom tidak tersedia saat menggunakan ARI. Catatan: Variabel `CUSTOM` hanya dicantumkan saat Anda mengirim harga dalam pesan Transaksi.
DATE-TYPE	Optional	Menunjukkan apakah pengguna memilih tanggal default atau tanggal tertentu yang diberikan dalam penelusuran. Nilai yang mungkin adalah: `default`: Pengguna mengklik iklan hotel atau link pemesanan gratis yang menggunakan tanggal default. `selected`: Pengguna mengklik iklan hotel atau link pemesanan gratis dengan tanggal yang ditetapkan.
GOOGLE-ADS-CLICK-SOURCE	Optional	Menunjukkan bahwa Google Ads adalah sumber klik. Nilai yang mungkin adalah: `bl`: Link Pemesanan Berbayar `tpa`: Iklan Promosi Perjalanan `tfsa`: Feed Perjalanan di Iklan Penelusuran `pm`: Kampanye Performa Maksimal atau Performa Maksimal untuk Sasaran Perjalanan. Catatan: Jika klik berasal dari Google Penelusuran, bukan Google Ads, parameter ini akan kosong
GOOGLE-SITE	Optional	Properti Google tempat pengguna melihat data harga hotel Anda. Kemungkinan nilainya adalah: `localuniversal`: Pengguna menemukan link pemesanan hotel melalui penelusuran `google.com`. `mapresults`: Pengguna menemukan link pemesanan hotel melalui `maps.google.com`. `verification`: Google menggunakan nilai ini saat melakukan pengujian kualitas data otomatis di situs Anda. Anda tidak ditagih untuk kueri ini. Google Analytics dapat menggunakan parameter ini dan nilainya untuk mengidentifikasi traffic verifikasi otomatis Iklan Hotel. `unknown`: Pengguna menemukan iklan atau link pemesanan gratis melalui sumber yang tidak ditentukan.
LENGTH	Recommended	Lama menginap dalam hal jumlah malam yang ditentukan oleh elemen `<Nights>` di Feed Harga Hotel. Contoh , `3`.
NUM-ADULTS	Recommended (must be used with the `NUM-CHILDREN` or `FOR-EACH-CHILD-AGE` condition)	Jumlah tamu dewasa yang ditentukan untuk itinerari oleh pengguna. Variabel ini harus digunakan bersama dengan `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE`, atau keduanya.
NUM-CHILDREN	Recommended	Jumlah tamu anak-anak (usia 0-17 tahun) yang ditentukan dalam itinerari oleh pengguna. `NUM-CHILDREN`, `FOR-EACH-CHILD-AGE`, atau keduanya diperlukan agar berhasil berpartisipasi dalam itinerari dengan tamu anak-anak.
NUM-GUESTS	Recommended (if you don't send child occupancy pricing)	Jumlah total tamu, baik dewasa maupun anak-anak, yang ditentukan untuk itinerari oleh pengguna. Nilai ini adalah jumlah nilai `NUM-ADULTS` dan `NUM-CHILDREN`. Untuk memaksimalkan partisipasi, sangat direkomendasikan untuk menggunakan `NUM-ADULTS` dan `NUM-CHILDREN` saja.
PACKAGE-ID	Recommended (applies if you use Room Bundles)	ID unik untuk paket di Feed Harga Hotel. Untuk paket standar, ID paket adalah nilai elemen `<PackageID>` dalam blok `<Result>`. Untuk Paket Kamar, ID paket adalah nilai elemen `<PackageID>` dalam blok `<RoomBundle>` atau `<PackageData>` pesan Transaksi.
PARTNER-CURRENCY	Optional	Kode mata uang tiga huruf yang ditentukan oleh atribut `currency` elemen `<Baserate>` di Feed Harga Hotel. Contohnya, `USD` atau `CAD`.
PARTNER-HOTEL-ID	Recommended	ID unik untuk hotel yang ditentukan oleh elemen `<id>` di Feed Daftar Hotel.
PARTNER-ROOM-ID	Recommended (applies if you use Room Bundles)	ID unik untuk kamar di Feed Harga Hotel. Untuk kamar standar, ID kamar adalah nilai elemen `<RoomID>` dalam blok `<Result>`. Untuk Paket Kamar, ID kamar adalah nilai yang ditetapkan ke elemen `<RoomID>` dalam blok `<RoomBundle>` atau `<RoomData>` dalam pesan Transaksi.
PAYMENT-ID	Optional (only applies to Ads)	Menampilkan string `commission` yang telah ditentukan sebelumnya, atau nomor IATA yang ditetapkan Google (misalnya, "01234567"), jika Anda menggunakan agensi pengumpulan komisi. Untuk mengubah format nomor IATA atau string yang telah ditentukan sebelumnya, hubungi Manajer Akun Teknis (TAM) Anda.
PRICE-DISPLAYED-TAX	(Optional)	Jumlah pajak yang ditampilkan kepada pengguna dalam mata uang lokal pengguna. Nilai `PRICE-DISPLAYED-TAX` adalah nilai elemen `<Tax>` di Feed Harga Hotel. Misalnya, "3.14".
PRICE-DISPLAYED-TOTAL	(Optional)	Total biaya kamar yang ditampilkan kepada pengguna dalam mata uang lokal pengguna. Nilai `PRICE-DISPLAYED-TOTAL` adalah jumlah elemen `<Baserate>`, `<Tax>`, dan `<OtherFees>` dari Feed Harga Hotel. Misalnya, "152.13".
PROMO-CODE	(Optional)	Jika Anda menggunakan promosi ARI, nilai variabel ini akan ditetapkan ke atribut `id` dari `<Promotion>` yang diterapkan. Jika beberapa promosi diterapkan, variabel tersebut adalah daftar ID promosi yang dipisahkan koma dalam urutan arbitrer. Jika Anda menggunakan aturan tarif, nilai variabel ini akan ditetapkan ke elemen `PromoCode` jika aturan tarif yang sesuai diterapkan.
RATE-PLAN-ID	Recommended (only applies if you use RoomBundles)	ID seperti yang ditetapkan oleh elemen `<RatePlanID>` di blok `<RoomBundle>` feed harga. `<RatePlanID>` merepresentasikan ID unik untuk kombinasi data paket dan kamar. Untuk mengetahui informasi selengkapnya, lihat Paket Kamar.
RATE-RULE-ID	Recommended (only applies if you use conditional rates or private rates)	ID seperti yang ditentukan oleh atribut `rate_rule_id` dalam blok `<Rate>` feed harga. Untuk mengetahui informasi selengkapnya, lihat Tarif Bersyarat. Catatan: Hanya tarif bersyarat atau tarif khusus yang tidak disembunyikan yang ditampilkan.
USER-COUNTRY	Recommended	Kode negara dua huruf yang menunjukkan lokasi pengguna. Informasi ini diekstrak dari setelan klien pengguna. Misalnya, `US` atau `FR`.
USER-CURRENCY	Recommended	Kode mata uang tiga huruf yang menunjukkan mata uang lokal pengguna. Nilai variabel `USER-CURRENCY` disimpulkan dari setelan klien pengguna. Misalnya, `USD` atau `CAD` .
USER-DEVICE	Recommended	Jenis perangkat pengguna. Nilai `USER-DEVICE` dapat berupa salah satu dari yang berikut: `mobile` `tablet` `desktop` `unknown` Nilai variabel `USER-DEVICE` disimpulkan dari setelan klien pengguna.
USER-LANGUAGE	Recommended	Kode bahasa ISO 639-1 dua huruf yang menentukan bahasa tampilan iklan atau link pemesanan gratis. Nilai variabel `USER-LANGUAGE` disimpulkan dari setelan klien pengguna. Misalnya, `en` atau `fr`.
USER-LIST-ID (ditentukan di Google Ads)	Optional (only applies if you use Audience Lists in Google Ads)	ID daftar pengguna Google Ads yang berisi daftar audiens atau informasi pengguna. Daftar audiens digunakan sebagai dasar untuk menetapkan penyesuaian bid. Jika pengguna adalah bagian dari beberapa daftar audiens, daftar audiens dengan penyesuaian bid terbesar akan dipilih. Hasil seri di antara audiens dengan penyesuaian bid terbesar ditentukan secara acak.
VERIFICATION	Optional	Boolean yang memverifikasi apakah link dibuat oleh Google untuk pengujian atau validasi otomatis. Nilainya adalah `true` jika link dibuat oleh Google untuk pengujian atau validasi otomatis, jika tidak, nilainya adalah `false`.

Logika bersyarat di URL

Anda dapat menggunakan perintah khusus di elemen <URL> file halaman landing untuk membuat endpoint secara bersyarat.

Logika bersyarat mendukung pernyataan berikut:

if_statement: Jika true, nilai yang mengikuti kondisi ini akan disisipkan ke URL. Jika tidak, nilai yang mengikuti perintah ELSE akan disisipkan.
for_statement: Membuat kondisi loop FOR yang melakukan iterasi pada jumlah nilai yang diberikan.

Pernyataan IF dan FOR mencakup hal berikut:

Kondisi	Direkomendasikan/opsional	Deskripsi
IF-AD-CLICK (khusus Iklan Hotel)	Optional	Ditetapkan ke `true` jika klik pengguna berasal dari iklan. Ditetapkan ke `false` jika klik pengguna berasal dari link pemesanan gratis.
IF-CLICK-TYPE-HOTEL	Optional	Ditetapkan ke `true` jika pengguna mengklik listingan untuk hotel, jika tidak, ditetapkan ke `false`.
IF-CLICK-TYPE-ROOM	Optional	Ditetapkan ke `true` jika pengguna mengklik listingan untuk Paket Kamar, jika tidak, ditetapkan ke `false`.
IF-CLOSE-RATE-RULE-IDS	Optional	Ditetapkan ke `true` jika satu atau beberapa tarif bersyarat tidak tersedia karena pengguna tidak memenuhi syarat. Jika tidak, ditetapkan ke `false`. Secara default, nilainya adalah `true` jika perlakuan UI tarif khusus ditampilkan kepada pengguna.
IF-DEFAULT-RATE	Optional	Ditetapkan ke `true` jika pengguna mengklik listingan hotel tempat tanggal default digunakan; jika tidak, ditetapkan ke `false`.
IF-HOTEL-CAMPAIGN	Optional	Ditetapkan ke `true` jika klik pengguna berasal dari kampanye Hotel, jika tidak, ditetapkan ke `false`. Perbedaan ini berguna bagi partner yang memiliki beberapa jenis kampanye yang ada di Google Ads untuk mengalokasikan atribusi.
IF-PAYMENT-ID (khusus Iklan Hotel)	Recommended (if you use pay-per-stay Google Ads campaigns)	Ditetapkan ke `true` untuk hotel dalam program komisi Bayar Per Kunjungan (PPS); jika tidak, ditetapkan ke `false`.
IF-PROMO-CODE	Optional	Ditetapkan ke `true` jika pengguna mengklik tarif yang didasarkan pada promosi ARI atau aturan tarif dengan `PromoCode` tertentu; jika tidak, ditetapkan ke `false`.
IF-PROMOTED (khusus Iklan Hotel)	Recommended (if you use Promoted hotels)	Ditetapkan ke `true` jika pengguna mengklik Iklan Promosi Properti, jika tidak, ditetapkan ke `false`.
IF-RATE-RULE-ID	Optional	Ditetapkan ke `true` jika pengguna memilih tarif bersyarat , jika tidak, ditetapkan ke `false`.
IF-USER-LIST-ID (ditentukan di Google Ads)	Optional	Ditetapkan ke `true` jika pengguna adalah anggota ID daftar pelanggan Google Ads yang Anda tentukan saat menetapkan pengganda bid untuk daftar audiens. Jika tidak, ditetapkan ke `false`.
IF-VERIFICATION	Optional	Ditetapkan ke `true` jika link dibuat oleh Google untuk pengujian atau validasi otomatis, jika tidak, ditetapkan ke `false`.
ELSE	Recommended (if you use any conditional IF statements)	Jika kondisi sebelumnya tidak terpenuhi, nilai yang mengikuti kondisi ini akan disisipkan ke dalam URL.
END-IF	Optional (required if you have any IF conditional statements)	Mengakhiri blok bersyarat pernyataan `IF`.
FOR-EACH-CHILD-AGE	Optional (required for child occupancy pricing)	Dieksekusi satu kali untuk setiap elemen `<Child "age">` di feed harga. Misalnya, jika `<OccupancyDetails>` menyertakan dua elemen `<Child age="17">` dan `<Child age= "17">`, perintah akan dieksekusi dua kali.
END-FOR-EACH	Optional (required if using FOR-EACH block)	Mengakhiri blok bersyarat pernyataan `FOR-EACH`.

Contoh IF-AD-CLICK

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna mengklik iklan atau link pemesanan gratis untuk mengalihkan ke halaman landing Anda.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Dalam contoh ini, jika pengguna tidak mengklik iklan, hasilnya adalah URL berikut:

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

Jika pengguna mengklik iklan, hasilnya adalah URL berikut:

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

Contoh IF-CLICK-TYPE-HOTEL

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna memilih hotel tanpa Paket Kamar eksplisit. Nilai elemen <RatePlanID> di blok <Room Bundle> pesan Transaksi akan ditetapkan ke harga paket kamar yang dikaitkan secara implisit yang telah dipilih pengguna.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dalam contoh ini, jika pengguna memilih Paket Kamar, hasilnya adalah URL berikut:

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

Jika pengguna tidak memilih Paket Kamar, hasilnya adalah URL berikut:

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

Contoh IF-CLICK-TYPE-ROOM

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna memilih Paket Kamar.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dalam contoh ini, jika pengguna tidak memilih Paket Kamar, hasilnya adalah URL berikut:

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

Jika pengguna memilih Paket Kamar, hasilnya adalah URL berikut:

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

Contoh IF-DEFAULT-DATE

Gunakan pernyataan bersyarat IF-DEFAULT-DATE untuk menetapkan parameter non-tanggal yang kemudian dapat digunakan oleh situs Anda untuk memicu perilaku kustom jika pengguna tidak memilih tanggal.

Contoh berikut memeriksa apakah tanggal default digunakan:

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

Dalam contoh ini, jika pengguna tidak memilih tanggal, hasilnya mungkin mirip dengan URL berikut yang menampilkan pilihan tanggal default:

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

Jika pengguna memilih tanggal, hasilnya mungkin mirip dengan URL berikut, bergantung pada itinerari yang dipilih:

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

Contoh IF-HOTEL-CAMPAIGN (Iklan hotel dan klik link pemesanan gratis)

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna mengklik iklan yang berasal dari kampanye Hotel.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Dalam contoh ini, jika pengguna mengklik URL kampanye Hotel, hasilnya adalah URL berikut:

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

Jika klik tidak berada di URL kampanye Hotel (misalnya, kampanye penelusuran reguler), hasilnya adalah URL berikut:

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

Hal ini berguna saat Anda ingin membedakan traffic klik kampanye hotel dari klik lainnya.

CAMPAIGN-ID kosong dengan klik FBL

Jika klik berasal dari link pemesanan gratis, IF-HOTEL-CAMPAIGN akan menampilkan TRUE dan nilai CAMPAIGN-ID ditetapkan ke kosong seperti yang ditunjukkan dalam URL berikut:

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

Anda dapat menggunakan pernyataan bersyarat IF-AD-CLICK untuk mencegah ID kampanye kosong seperti yang ditunjukkan pada contoh berikut:

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

Contoh IF-PAYMENT-ID (khusus Iklan Hotel)

Gunakan pernyataan bersyarat IF-PAYMENT-ID untuk memvariasikan URL berdasarkan apakah klik merupakan hasil dari program komisi PPS atau tidak. Contoh di bawah ini memeriksa apakah klik berasal dari program komisi PPS dan menetapkan nilai ke parameter booking_source berdasarkan hasilnya:

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

Jika hotel merupakan bagian dari program Komisi, hasilnya adalah salah satu dari URL berikut:

Jika tidak ada nomor IATA yang ditetapkan ke Google:

https://partner.com?hid=123&booking_source=commissions
Jika nomor IATA telah ditetapkan ke Google:

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

Jika tidak, hasilnya adalah URL berikut:

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

Contoh IF-PROMOTED (khusus Iklan Hotel)

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna mengklik Iklan Promosi Properti.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Dalam contoh ini, jika pengguna memilih Iklan Promosi Properti, hasilnya adalah URL berikut:

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

Jika pengguna tidak memilih Iklan Promosi Properti, hasilnya adalah URL berikut:

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

Contoh IF-RATE-RULE-ID

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna memilih tarif bersyarat dan jika demikian, nilai elemen <RateRuleID> dalam blok <Rate> pesan transaksi akan digunakan.

Contoh berikut menggunakan perintah ini di file halaman landing:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

Dalam contoh ini, jika pengguna tidak memilih tarif bersyarat, hasilnya adalah URL berikut:

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

Jika pengguna memilih tarif bersyarat, hasilnya adalah URL berikut:

https://www.partner.com?hid=123&customerType=42

Contoh IF-USER-LIST-ID (ditentukan di Google Ads)

Jika Anda menetapkan pengganda bid untuk daftar audiens di kampanye Hotel di Google Ads, Anda dapat menggunakan IF-USER-LIST-ID bersama dengan USER-LIST-ID untuk menetapkan parameter di situs Anda untuk pelanggan yang termasuk dalam daftar audiens Google Ads tertentu. Anda dapat melakukannya untuk tujuan pelacakan atau menyesuaikan situs untuk anggota daftar audiens.

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

Dalam contoh ini, jika pengguna bukan anggota daftar audiens, hasilnya adalah URL berikut:

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

Jika pengguna adalah anggota daftar audiens 12345678, hasilnya adalah URL berikut:

https://www.partner.com?hid=123&audience_list=12345678

Contoh IF-VERIFICATION

Jika perlu memeriksa apakah Google membuat URL untuk pengujian atau validasi otomatis, Anda dapat menggunakan IF-VERIFICATION.

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

Dalam contoh ini, jika Google tidak membuat URL untuk pengujian atau validasi, hasilnya adalah URL berikut:

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

Jika Google membuat URL untuk pengujian atau validasi, hasilnya adalah URL berikut:

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

Contoh FOR-EACH-CHILD-AGE

Anda dapat membuat blok bersyarat yang mengisi usia maksimum setiap tamu anak-anak, seperti yang ditentukan di Feed Harga Hotel.

Contoh berikut menggunakan perintah ini di file halaman landing:

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

Dalam contoh ini, jika itinerari memiliki 2 orang dewasa dan 2 anak-anak dengan usia 0 dan 17 tahun, hasilnya adalah URL berikut:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Jika itinerari memiliki 2 orang dewasa dan 0 anak-anak, hasilnya adalah URL berikut:

https://www.partner.com?adults=2&children=0&hid=123

Aturan umum saat membuat URL

Semua variabel bersifat opsional. Anda tidak perlu menyisipkan variabel apa pun di URL halaman landing. Namun, menggunakan variabel untuk meneruskan informasi pengguna dan itinerari biasanya akan menciptakan pengalaman yang lebih baik bagi pengguna dan membantu Anda mematuhi kebijakan Google.

Aturan umum berikut berlaku saat menentukan URL yang dibuat di file halaman landing:

Semua variabel diapit oleh tanda kurung buka dan tutup.
Parameter string kueri harus dipisahkan dengan tanda ampersan ("&") di output akhir. Karena ampersan adalah karakter khusus dalam XML dan format file halaman landing adalah XML. Oleh karena itu, Anda harus menggunakan entitas yang dienkode "&" sebagai gantinya. Output akhir merender karakter "&" yang sebenarnya. Contoh:
```

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


<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
```
Anda juga harus mengenkode karakter khusus ke URL yang mungkin Anda sertakan di URL halaman landing. Contoh:
- spasi (" "): Mengganti karakter spasi dengan "%20;" di elemen <URL>
- garis miring ke depan ("/"): Ganti garis miring ke depan dengan "%2F;" di elemen <URL>
Tidak semua karakter non-abjad harus dienkode ke URL. Misalnya, tanda hubung ("-") tidak perlu dienkode ke URL. Untuk mengetahui daftar karakter umum yang harus dienkode URL, lihat Encoding URL.
Nilai untuk parameter tunggal dapat dibuat dari beberapa variabel. Contoh berikut membuat parameter tunggal, checkinDate, dari variabel CHECKINDAY,CHECKINMONTH, dan CHECKINYEAR:
```
<URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
```
Contoh ini menghasilkan URL yang mungkin terlihat seperti berikut:
```
https://www.partnerdomain.com?checkinDate=7/23/1971
```
Anda dapat menggunakan ID apa pun untuk nama parameter string kueri. Server Anda memproses nilai ini. Namun, nilai yang Anda teruskan terbatas pada daftar variabel yang tersedia.
Anda dapat menggunakan hingga lima variabel kustom selain daftar variabel yang tersedia.