Sintaksis file halaman landing

Elemen root file halaman landing adalah <PointsOfSale> yang menggunakan satu elemen turunan, <PointOfSale>, dan tidak memiliki atribut. File halaman landing dapat memiliki beberapa elemen turunan <PointOfSale>.

Setiap halaman landing yang Anda tentukan di file halaman landing akan disertakan dalam elemen <PointOfSale>. Elemen ini menggunakan satu atribut, id, yang menentukan ID unik untuk halaman landing. Anda dapat menggunakan nilai id untuk memfilter halaman landing yang memenuhi syarat untuk hotel yang cocok. Anda dapat melakukannya menggunakan elemen <AllowablePointsOfSale> di <Transaction>.

Sintaksis

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale>
  <PointOfSale id="landing_page_id">
    <DisplayNames display_text="landing_page_display_name" display_language="language_code"/>
    <Match status="[yes|never]"
      country="country_code"
      language="language_code"
      brand="booking_engine or brand"
      currency="currency_code"
      sitetype="[localuniversal|mapresults]"
      device="[desktop|mobile|tablet]"/>
    <!-- The dynamic landing page URL -->
    <URL>landing_page_url</URL>
  </PointOfSale>
</PointsOfSale>

Tabel berikut menjelaskan elemen turunan dari elemen <PointOfSale>:

Elemen Wajib Deskripsi
<DisplayNames> Optional

Berisi teks tampilan untuk Agen Perjalanan Online (OTA). Elemen ini menggunakan atribut berikut:

  • display_text: Berisi teks yang ditampilkan di iklan atau link pemesanan gratis. Teks hanya boleh diisi dengan nama partner.
  • display_language: Kode bahasa dua huruf menentukan bahasa tampilan iklan atau link pemesanan gratis. Nilai atribut ini harus cocok dengan bahasa yang didukung yang ditentukan oleh elemen <Match>.

Contoh berikut menunjukkan nama tampilan untuk Agen Perjalanan Online Prancis:

  <DisplayNames
    display_text="TravelAgency.com.fr"
    display_language="fr"
  />

Kecualikan elemen <DisplayNames> untuk pemasok Central Reservations System (CRS), yang juga dikenal sebagai "partner integrasi", dan Pemasok Langsung seperti pemilik atau jaringan hotel. Untuk jenis partner ini, teks iklan dan link pemesanan gratis diambil dari elemen <Name> hotel di Daftar Hotel.

Catatan: Untuk OTA, jika Anda telah mengonfigurasi nama tampilan default dengan Dukungan Google, kolom ini bersifat opsional. Jika tidak, OTA harus memberikan <DisplayNames>.
<Match> Required

Menentukan filter guna menentukan apakah iklan dan link pemesanan gratis ditampilkan berdasarkan berbagai karakteristik pengguna atau hotel. Misalnya, Anda dapat menentukan bahwa iklan atau link pemesanan gratis hanya ditampilkan kepada pengguna di negara tertentu.

Elemen ini menggunakan atribut berikut:

  • status: Menentukan apakah pencocokan menyertakan atau tidak menyertakan hasil untuk kriteria yang ditentukan. Nilai yang valid adalah yes (harus cocok) atau never (tidak boleh cocok).
  • country: Mencocokkan domain Google yang terkait dengan pengguna dan hotel. Atribut ini menggunakan kode negara dua huruf. Misalnya, US atau FR.
  • language: Mencocokkan bahasa pengguna dan hotel. Atribut ini menggunakan kode bahasa dua huruf. Misalnya, en atau fr.
  • brand: Mencocokkan nilai atribut hotel_brand yang ditentukan dalam daftar hotel Anda. Filter ini dapat berguna jika Anda memiliki URL yang berbeda untuk mesin pemesanan atau berbagai brand.
  • currency: Mencocokkan mata uang negara pengguna atau hotel. Atribut ini menggunakan kode mata uang tiga huruf. Misalnya, USD atau EUR.
  • sitetype: Mencocokkan properti Google tempat pengguna melihat data harga hotel Anda. Atribut ini menggunakan nilai berikut:
    • localuniversal: Pengguna menemukan iklan atau link pemesanan gratis melalui penelusuran, biasanya dengan menelusuri di google.com.
    • mapresults: Pengguna menemukan link pemesanan hotel melalui maps.google.com.
  • device: Mencocokkan jenis perangkat yang digunakan pengguna untuk melakukan penelusuran. Atribut ini menggunakan mobile, desktop, atau tablet.

    CATATAN: Anda tidak dapat menetapkan status ke never jika device ditetapkan ke tablet.

Contoh:

<PointOfSale id="test1">
  <Match status="yes" country="US"/>
  <Match status="yes" currency="USD"/>
  <Match status="yes" device="mobile"/>
  <Match status="yes" language="en"/>
  <URL>www.google.com</URL>
</PointOfSale>

Anda dapat menggabungkan atribut elemen <Match> untuk menyederhanakan aturan pencocokan, seperti yang ditunjukkan contoh berikut:

<PointOfSale id="test1">
  <Match
    status="yes"
    country="US"
    language="en"
    currency="USD"
    device="mobile"/>
  <URL>www.google.com</URL>
</PointOfSale>

Untuk informasi selengkapnya, lihat Aturan pencocokan halaman landing.
<URL> Required Menentukan link ke situs Anda, tempat pengguna dapat memesan kamar. Anda dapat menyisipkan informasi dinamis tentang pengguna dan itinerari mereka sebagai parameter string kueri. Misalnya, Anda dapat menyertakan ID hotel dengan menggunakan variabel PARTNER-HOTEL-ID di URL: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Saat link ini dibuat dan ditampilkan kepada pengguna, Google akan mengganti variabel PARTNER-HOTEL-ID dengan ID hotel yang sesuai. Saat pengguna mengklik situs Anda, situs Anda akan mengekstrak dan memproses nilai dari semua parameter string kueri guna menciptakan pengalaman pengguna yang lancar. Untuk daftar lengkap variabel yang diizinkan di URL halaman landing, lihat Menggunakan variabel dan ketentuan.

Saat menggunakan pelacakan, tentukan URL lengkap yang mencakup komponen yang diperlukan untuk pelacakan. Contoh:

https://example.tracker.com?campaign_id=(CAMPAIGN-ID)&amp;t_url=
http://partner.com/landing%3Fhid%3D(PARTNER-HOTEL-ID)

Parameter ValueTrack tidak dapat digunakan di <URL>.

Anda hanya dapat menentukan satu elemen <URL> untuk setiap halaman landing.
<LPURL> Optional

Digunakan untuk mendukung pelacakan dinamis di URL halaman landing. Menentukan segmen non-pelacakan dari URL yang ditentukan di elemen <URL>. Segmen pelacakan URL halaman landing harus ditentukan menggunakan template pelacakan Google Ads yang tersedia di akun Google Ads dan akhiran URL final. Jika URL pelacakan tidak ditemukan di Google Ads, elemen <LPURL> akan diabaikan.

Nilai <LPURL> tidak perlu di-escape. Konfigurasi ValueTrack yang benar di Google Ads akan meng-escape secara otomatis. Contoh:

http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Parameter ValueTrack tidak dapat digunakan di <LPURL>. Untuk informasi selengkapnya, lihat Menyiapkan pelacakan dinamis untuk kampanye Hotel.

Skema file halaman landing menentukan struktur dan batasan file halaman landing. Untuk informasi selengkapnya, baca Skema Iklan Hotel