방문 페이지 파일 구문

방문 페이지 파일의 루트 요소는 하나의 하위 요소 <PointOfSale>를 취하고 속성이 없는 <PointsOfSale>입니다. 방문 페이지 파일에는 여러 <PointOfSale> 하위 요소가 있을 수 있습니다.

방문 페이지 파일에 정의한 각 방문 페이지는 <PointOfSale> 요소에 포함됩니다. 이 요소는 방문 페이지의 고유 식별자를 정의하는 단일 속성인 id를 사용합니다. id의 값을 사용하여 일치하는 호텔의 요건을 충족하는 방문 페이지를 필터링할 수 있습니다. <Transaction>에서 <AllowablePointsOfSale> 요소를 사용하면 됩니다.

문법

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

다음 표에서는 <PointOfSale> 요소의 하위 요소를 설명합니다.

요소 필수 설명
<DisplayNames> Optional

온라인 여행사 (OTA)의 디스플레이 텍스트가 포함됩니다. 이 요소는 다음 속성을 사용합니다.

  • display_text: 광고 또는 무료 예약 링크에 표시되는 텍스트가 포함됩니다. 파트너의 이름이어야 합니다.
  • display_language: 2자리 언어 코드로 광고 또는 무료 예약 링크의 표시 언어를 지정합니다. 이 속성 값은 <Match> 요소에서 지정한 지원 언어와 일치해야 합니다.

다음 예는 프랑스어 OTA의 표시 이름을 보여줍니다.

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

중앙 예약 시스템(CRS) 공급업체('통합 파트너'라고도 함) 및 직접 공급업체(예: 호텔 소유자 또는 체인)에 대해서는 <DisplayNames> 요소를 제외합니다. 이러한 유형의 파트너의 경우 광고 및 무료 예약 링크 텍스트는 호텔 목록에 있는 호텔의 <Name> 요소에서 가져옵니다.

참고: OTA의 경우, Google 지원을 통해 기본 표시 이름을 구성한 경우 이 필드는 선택사항입니다. 그렇지 않으면 OTA가 <DisplayNames>를 제공해야 합니다.
<Match> Required

사용자 또는 호텔의 다양한 특성에 따라 광고 및 무료 예약 링크를 표시할지 여부를 정의하는 필터를 정의합니다. 예를 들어 광고 또는 무료 예약 링크가 특정 국가의 사용자에게만 표시되도록 지정할 수 있습니다.

이 요소는 다음 속성을 사용합니다.

  • status: 지정된 기준에 대한 결과가 일치에 포함되는지 또는 제외할지를 결정합니다. 유효한 값은 yes (일치해야 함) 또는 never (일치하지 않아야 함)입니다.
  • country: 사용자 및 호텔과 연결된 Google 도메인에서 일치합니다. 이 속성은 2자리 국가 코드를 사용합니다. 예를 들면 US 또는 FR가 있습니다.
  • language: 사용자 및 호텔의 언어와 일치합니다. 이 속성은 2자리 언어 코드를 사용합니다. 예를 들어 en 또는 fr입니다.
  • brand: 호텔 목록에 지정된 hotel_brand 속성 값과 일치합니다. 이 필터는 예약 엔진 또는 여러 브랜드에 서로 다른 URL이 있는 경우 유용할 수 있습니다.
  • currency: 사용자 또는 호텔 국가의 통화와 일치합니다. 이 속성은 3자리 통화 코드를 사용합니다. 예를 들면 USD 또는 EUR입니다.
  • sitetype: 사용자가 호텔 가격 데이터를 본 Google 서비스와 일치합니다. 이 속성은 다음 값을 사용합니다.
    • localuniversal: 사용자가 주로 google.com에서 검색하는 방법으로 검색을 통해 광고 또는 무료 예약 링크를 찾았습니다.
    • mapresults: 사용자가 maps.google.com를 통해 호텔 예약 링크를 찾았습니다.
  • device: 사용자가 검색에 사용하는 기기 유형과 일치합니다. 이 속성은 mobile, desktop 또는 tablet를 사용합니다.

    참고: device가 tablet로 설정된 경우 status를 never로 설정할 수 없습니다.

예를 들면 다음과 같습니다.

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

다음 예에 표시된 것처럼 <Match> 요소의 속성을 조합하여 일치 규칙을 단순화할 수 있습니다.

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

자세한 내용은 규칙이 일치하는 방문 페이지를 참고하세요.
<URL> Required 사용자가 객실을 예약할 수 있는 사이트 링크를 정의합니다. 사용자 및 여행 일정에 대한 동적 정보를 쿼리 문자열 매개변수로 삽입할 수 있습니다. 예를 들어 URL에 PARTNER-HOTEL-ID 변수를 사용하여 호텔 ID를 포함할 수 있습니다. 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

이 링크가 생성되어 사용자에게 표시되면 Google은 PARTNER-HOTEL-ID 변수를 적절한 호텔 ID로 바꿉니다. 사용자가 클릭하여 사이트로 연결되면 사이트에서 모든 쿼리 문자열 매개변수의 값을 추출하고 처리하여 원활한 사용자 환경을 만들 수 있습니다. 방문 페이지 URL에 허용되는 변수의 전체 목록은 변수 및 조건 사용을 참조하세요.

추적을 사용할 때는 추적에 필요한 구성요소를 비롯한 전체 URL을 지정합니다. 예를 들면 다음과 같습니다.

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

ValueTrack 매개변수는 <URL>에서 사용할 수 없습니다.

방문 페이지마다 <URL> 요소를 하나만 정의할 수 있습니다.
<LPURL> Optional

방문 페이지 URL에서 동적 추적을 지원하는 데 사용됩니다. <URL> 요소에 정의된 URL의 비추적 세그먼트를 지정합니다. 방문 페이지 URL의 추적 세그먼트는 Google Ads 계정과 최종 URL 접미사에서 사용할 수 있는 Google Ads 추적 템플릿을 사용하여 지정해야 합니다. 추적 URL이 Google Ads에 없으면 <LPURL> 요소는 무시됩니다.

<LPURL> 값은 이스케이프할 필요가 없습니다. Google Ads의 ValueTrack 구성이 올바르면 이를 자동으로 이스케이프 처리합니다. 예를 들면 다음과 같습니다.

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

ValueTrack 매개변수는 <LPURL>에서 사용할 수 없습니다. 자세한 내용은 호텔 캠페인에 동적 추적 설정하기를 참고하세요.

방문 페이지 파일 스키마는 방문 페이지 파일의 구조와 제약조건을 정의합니다. 자세한 내용은 호텔 광고 스키마를 참고하세요.