방문 페이지 파일 구문

방문 페이지 파일의 루트 요소는 <PointsOfSale>이며,이 요소는 하나의 하위 요소인 <PointOfSale>를 사용하고 속성이 없습니다. 방문 페이지 파일에는 여러 개의 <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: 두 글자로 된 언어 코드는 광고 또는 무료 예약 링크의 표시 언어를 지정합니다. 이 속성의 값은 <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: 사용자 및 호텔의 언어와 일치합니다. 이 속성은 두 글자 언어 코드를 사용합니다. 예를 들어 en 또는 fr입니다.
  • brand: 호텔 목록에 지정된 hotel_brand 속성 값과 일치합니다. 이 필터는 예약 엔진 또는 다양한 브랜드의 URL이 다른 경우에 유용할 수 있습니다.
  • currency: 사용자 또는 호텔 국가의 통화와 일치합니다. 이 속성은 3자리 통화 코드를 사용합니다. 예를 들면 USD 또는 EUR입니다.
  • sitetype: 사용자가 호텔 가격 데이터를 조회한 Google 서비스에 대한 일치입니다. 이 속성은 다음 값을 사용합니다.
    • localuniversal: 사용자가 검색을 통해 광고 또는 무료 예약 링크를 찾았습니다(일반적으로 google.com에서 검색).
    • mapresults: 사용자가 maps.google.com을 통해 호텔 예약 링크를 찾았습니다.

      • 참고: 모든 sitetype을 never로 설정하는 것은 허용되지 않습니다. 이렇게 하면 sitetype가 무시됩니다.

  • 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 계정에서 사용할 수 있는 Google Ads 추적 템플릿과 최종 URL 접미사를 사용하여 지정해야 합니다. Google Ads에 추적 URL이 없으면 <LPURL> 요소가 무시됩니다.

<LPURL> 값은 이스케이프 처리할 필요가 없습니다. Google Ads의 ValueTrack 구성이 제대로 되어 있다면 자동으로 이스케이프 처리됩니다. 예를 들면 다음과 같습니다.

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

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

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