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

Anda menentukan URL halaman landing di file halaman landing. Saat iklan atau waktu kerja link pemesanan ditampilkan, informasi dinamis di URL diganti dengan nilai aktual. Untuk menambahkan nilai dinamis ke URL halaman landing, gunakan sintaksis berikut:

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

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

<URL>https://www.partnerdomain.com?hotelID=(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 ruangan untuk 6 malam mulai 23/5/2023 untuk hotel #42, Google 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.

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

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

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

Variabel URL

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

Logika bersyarat di URL

Anda dapat menggunakan perintah khusus di elemen <URL> pada file halaman landing untuk endpoint build kondisional.

Logika bersyarat mendukung pernyataan berikut:

• if_statement: Jika true, nilai yang mengikuti kueri ini kondisi dimasukkan ke dalam URL, jika tidak nilai yang mengikuti Perintah ELSE disisipkan.

• for_statement: Membuat kondisi loop FOR yang melakukan iterasi jumlah nilai yang diberikan.

Pernyataan IF dan FOR meliputi:

Contoh IF-AD-KLIK

Anda dapat membuat pemblokiran 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 sebagai berikut URL:

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 kolom Blok <Room Bundle> pesan Transaksi akan disetel ke metode harga paket kamar terkait 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 sebagai berikut URL:

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 Room Paket.

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 dapat digunakan 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 ke 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 mereka pilih:

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

Contoh IF-HOTEL-CAMPAIGN (klik iklan Hotel dan link pemesanan gratis)

Anda dapat membuat pemblokiran 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 bukan berada di URL kampanye Hotel (mis. kampanye penelusuran reguler), hasilnya adalah URL berikut:

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

Metrik ini berguna saat Anda ingin membedakan traffic klik kampanye Hotel dari klik lainnya.

ID CAMPAIGN-ID dengan klik FBL kosong

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

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

Anda dapat menggunakan pernyataan bersyarat IF-AD-CLICK untuk mencegah ID kampanye kosong sebagai yang ditunjukkan dalam 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 bukan. Contoh di bawah ini memeriksa apakah klik berasal dari program komisi PPS dan menetapkan nilai ke parameter booking_source berdasarkan hasil:

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

Jika hotel tersebut merupakan bagian dari program Komisi, hasilnya adalah salah satu 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, hasil 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 ID ATURAN-IF-RATE

Anda dapat membuat blok bersyarat yang memeriksa apakah pengguna telah memilih tarif bersyarat dan jika demikian, nilai <RateRuleID> di blok <Rate> pesan transaksi 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 di situs Anda untuk pelanggan yang merupakan bagian dari akun Google Ads tertentu daftar audiens. Anda mungkin ingin melakukannya untuk tujuan pelacakan atau untuk 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 Anda perlu memeriksa apakah Google membuat URL untuk pengujian atau otomatisasi validasi, 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 masing-masing tamu anak, seperti yang ditentukan dalam 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 dengan usia 0 dan 17 tahun masing-masing, 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, maka hasilnya adalah sebagai berikut URL:

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

Aturan umum saat membuat URL

Semua variabel bersifat opsional. Anda tidak perlu memasukkan variabel apa pun dalam URL halaman landing Anda. Namun, menggunakan variabel untuk meneruskan itinerari dan informasi umumnya menciptakan pengalaman yang lebih baik bagi pengguna dan membantu Anda dalam sesuai dengan kebijakan Google.

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

• Semua variabel dikelilingi dengan tanda kurung buka dan tutup.

• Parameter string kueri hanya dapat diteruskan setelah tanda tanya ("?") di URL.

• Parameter string kueri harus dipisahkan dengan tanda dan ("&") pada output akhir. Karena ampersand adalah karakter khusus dalam XML dan format file halaman landing adalah XML. Oleh karena itu, Anda harus menggunakan entity yang dienkode "&" penggantinya. Output akhir akan merender "&" yang sebenarnya karakter. Contoh:

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

  Anda juga harus mengenkode karakter khusus ke URL yang mungkin Anda sertakan dalam URL halaman landing Anda. Contoh:

  • spasi (" "): Ganti karakter spasi dengan "%20;" dalam elemen <URL>
  • garis miring ke depan ("/"): Ganti garis miring ke depan dengan "%2F;" dalam <URL> elemen

  Tidak semua karakter non-alfabet harus dienkode ke URL. Misalnya, tanda hubung ("-") tidak perlu dienkode ke URL. Untuk daftar yang harus dienkode ke URL, konsultasikan Tabel Encoding URL.

• Nilai untuk satu parameter dapat dibuat dari beberapa variabel. Tujuan 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-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 variabel.