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 dalam file halaman landing 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 Agensi Perjalanan Online (OTA). Elemen ini menggunakan atribut berikut:

  • display_text: Berisi teks yang ditampilkan dalam iklan atau link pemesanan gratis. Kolom ini harus berupa 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 OTA Prancis:

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

Kecualikan elemen <DisplayNames> untuk pemasok Central Reservation 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 menyediakan <DisplayNames>.
<Match> Required

Menentukan filter untuk menentukan apakah iklan dan link pemesanan gratis akan 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 kecocokan menyertakan atau mengecualikan 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 sistem pemesanan atau berbagai brand.
  • currency: Mencocokkan mata uang negara hotel atau pengguna. 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 dalam 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 itinerarinya sebagai parameter string kueri. Misalnya, Anda dapat menyertakan ID hotel 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 untuk menciptakan pengalaman pengguna yang lancar. Untuk daftar lengkap variabel yang diizinkan di URL halaman landing, lihat Menggunakan variabel dan kondisi.

Saat menggunakan pelacakan, tentukan URL lengkap termasuk 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 dalam elemen <URL>. Segmen pelacakan URL halaman landing harus ditentukan menggunakan template pelacakan Google Ads yang tersedia di akun Google Ads Anda dan akhiran URL final. Jika URL pelacakan tidak ada di Google Ads, elemen <LPURL> akan diabaikan.

Nilai <LPURL> tidak perlu di-escape. Konfigurasi ValueTrack yang benar di Google Ads akan meng-escape konfigurasi ini 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