Cú pháp tệp trang đích

Phần tử gốc của tệp trang đích là <PointsOfSale>. Phần tử này có một phần tử con <PointOfSale> và không có thuộc tính nào. Một tệp trang đích có thể có nhiều phần tử con <PointOfSale>.

Mỗi trang đích mà bạn xác định trong tệp trang đích sẽ được đưa vào phần tử <PointOfSale>. Phần tử này có một thuộc tính duy nhất là id xác định giá trị nhận dạng duy nhất cho trang đích. Bạn có thể sử dụng giá trị của id để lọc các trang đích đủ điều kiện của một khách sạn phù hợp. Bạn có thể thực hiện việc này bằng cách sử dụng phần tử <AllowablePointsOfSale> trong <Transaction>.

Cú pháp

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

Bảng sau đây mô tả các phần tử con của phần tử <PointOfSale>:

Phần tử Bắt buộc Nội dung mô tả
<DisplayNames> Optional

Chứa văn bản hiển thị dành cho các Đại lý du lịch trực tuyến (OTA). Phần tử này có các thuộc tính sau:

  • display_text: Chứa văn bản sẽ xuất hiện trong quảng cáo hoặc đường liên kết miễn phí để đặt phòng. Đó phải là tên của đối tác.
  • display_language: Mã ngôn ngữ gồm hai chữ cái chỉ định ngôn ngữ hiển thị của quảng cáo hoặc đường liên kết miễn phí để đặt phòng. Giá trị của thuộc tính này phải khớp với một ngôn ngữ được hỗ trợ do phần tử <Match> chỉ định.

Ví dụ sau đây cho thấy tên hiển thị của một OTA ở Pháp:

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

Loại trừ phần tử <DisplayNames> cho nhà cung cấp Hệ thống đặt trước trung tâm (CRS), còn gọi là "đối tác tích hợp" và Nhà cung cấp trực tiếp như chủ khách sạn hoặc chuỗi cửa hàng. Đối với các loại đối tác này, văn bản của quảng cáo và đường liên kết miễn phí để đặt phòng được lấy từ phần tử <Name> của khách sạn trong Danh sách khách sạn.

Lưu ý: Đối với OTA, nếu bạn đã định cấu hình tên hiển thị mặc định với Nhóm hỗ trợ Google, thì trường này là không bắt buộc. Nếu không, OTA phải cung cấp <DisplayNames>.

<Match> Required

Xác định bộ lọc để xác định xem quảng cáo và đường liên kết miễn phí để đặt phòng của bạn có xuất hiện dựa trên nhiều đặc điểm của người dùng hoặc khách sạn hay không. Ví dụ: bạn có thể chỉ định rằng quảng cáo hoặc đường liên kết miễn phí để đặt phòng chỉ xuất hiện cho người dùng ở một quốc gia nhất định.

Phần tử này có các thuộc tính sau:

  • status: Xác định xem kết quả trùng khớp bao gồm hay loại trừ kết quả theo tiêu chí đã chỉ định. Các giá trị hợp lệ là yes (phải khớp) hoặc never (không được khớp).
  • country: Trùng khớp với miền mua qua Google được liên kết với người dùng và khách sạn. Thuộc tính này sẽ nhận một mã quốc gia gồm hai chữ cái. Ví dụ: US hoặc FR.
  • language: Trùng khớp theo ngôn ngữ của người dùng và khách sạn. Thuộc tính này sẽ nhận một mã ngôn ngữ gồm hai chữ cái. Ví dụ: en hoặc fr.
  • brand: So khớp với giá trị của thuộc tính hotel_brand được chỉ định trong danh sách khách sạn của bạn. Bộ lọc này có thể hữu ích nếu bạn có nhiều URL cho công cụ đặt phòng hoặc nhiều thương hiệu.
  • currency: Trùng khớp với đơn vị tiền tệ của người dùng hoặc quốc gia của khách sạn. Thuộc tính này sẽ nhận một mã đơn vị tiền tệ gồm ba chữ cái. Ví dụ: USD hoặc EUR.
  • sitetype: So khớp với sản phẩm của Google mà người dùng đã xem dữ liệu giá khách sạn của bạn. Thuộc tính này sẽ nhận các giá trị sau:
    • localuniversal: Người dùng tìm thấy quảng cáo hoặc đường liên kết miễn phí để đặt phòng thông qua một lượt tìm kiếm, thường là bằng cách tìm kiếm trên google.com.
    • mapresults: Người dùng tìm thấy đường liên kết đặt phòng khách sạn thông qua maps.google.com.
  • device: So khớp với loại thiết bị mà người dùng sử dụng để tìm kiếm. Thuộc tính này sẽ sử dụng mobile, desktop hoặc tablet.

    LƯU Ý: Bạn không thể đặt status thành never nếu device được đặt thành tablet.

Ví dụ:

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

Bạn có thể kết hợp các thuộc tính của phần tử <Match> để đơn giản hoá các quy tắc so khớp, như trong ví dụ sau:

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

Để biết thêm thông tin, hãy tham khảo bài viết Trang đích phù hợp với các quy tắc.

<URL> Required Xác định đường liên kết đến trang web của bạn nơi người dùng có thể đặt phòng. Bạn có thể chèn thông tin động về người dùng và hành trình của họ dưới dạng tham số chuỗi truy vấn. Ví dụ: bạn có thể thêm mã khách sạn bằng cách sử dụng biến PARTNER-HOTEL-ID trong URL:
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

Khi đường liên kết này được tạo và hiển thị cho người dùng, Google sẽ thay thế biến PARTNER-HOTEL-ID bằng mã khách sạn thích hợp. Khi người dùng nhấp vào trang web, trang web của bạn có thể trích xuất và xử lý các giá trị của tất cả tham số chuỗi truy vấn để mang lại trải nghiệm mượt mà cho người dùng. Để xem danh sách đầy đủ các biến được phép sử dụng trong URL trang đích, hãy xem bài viết Sử dụng biến và điều kiện.

Khi sử dụng tính năng theo dõi, hãy chỉ định URL hoàn chỉnh, bao gồm cả các thành phần cần thiết cho hoạt động theo dõi. Ví dụ:

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

Không thể sử dụng tham số ValueTrack trong <URL>.

Bạn chỉ có thể xác định một phần tử <URL> cho mỗi trang đích.

<LPURL> Optional

Dùng để hỗ trợ tính năng theo dõi linh động trong URL trang đích. Chỉ định phân đoạn không theo dõi của URL được xác định trong phần tử <URL>. Bạn phải chỉ định các phân đoạn theo dõi của URL trang đích bằng mẫu theo dõi của Google Ads có sẵn trong tài khoản Google Ads của bạn và hậu tố URL cuối cùng. Nếu không có URL theo dõi trong Google Ads, thì phần tử <LPURL> sẽ bị bỏ qua.

Giá trị <LPURL> không cần phải dùng ký tự thoát. Cấu hình ValueTrack chính xác trong Google Ads sẽ tự động thoát cấu hình đó. Ví dụ:

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

Không thể sử dụng tham số ValueTrack trong <LPURL>. Để biết thêm thông tin, hãy xem bài viết Thiết lập tính năng theo dõi động cho Chiến dịch khách sạn.

Giản đồ tệp trang đích xác định cấu trúc và giới hạn của tệp trang đích. Để biết thêm thông tin, hãy đọc lược đồ Quảng cáo khách sạn