ランディング ページのファイルの構文

ランディング ページ ファイルのルート要素は <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: 2 文字の言語コードで、広告または無料の予約リンクの表示言語を指定します。この属性の値は、 <Match> で指定されたサポート対象言語 要素です。

次の例は、フランスの OTA の表示名を示しています。

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

Central の <DisplayNames> 要素を除外する 予約システム（CRS）サプライヤー（「統合」とも呼ばれる） 直接契約のサプライヤー（ホテルのオーナーやチェーンなど）にリーチできます。対象 広告や無料の予約リンクのテキストは ホテルリストのホテルの <Name> 要素。

注: OTA では、デフォルトの表示名を設定している場合に 追加している場合、このフィールドは省略可能です。それ以外の場合、OTA は <DisplayNames> を指定します。
<Match> Required

広告と無料の予約リンクを表示するかどうかのフィルタを定義します ユーザーやホテルのさまざまな特性に基づいて表示されます。対象 たとえば、広告や無料の予約リンクを表示することを 特定の国のユーザーにのみ 広告を表示することができます

この要素には次の属性があります。

  • status: 一致に含めるか除外するかを決定します。 表示されます。有効な値は yes です（ never（一致しないもの）のいずれかです。
  • country: ユーザーとホテルの 2 つですこの属性では 2 文字の国コードを使用します。たとえば、US や FR です。
  • language: ユーザーおよびホテルの言語と照合します。この属性には、2 文字の言語コードを指定します。たとえば、en や fr です。
  • brand: hotel_brand の値と一致します。 属性で指定する必要があります。このフィルタは 予約エンジンやブランドごとに URL が異なることがあります。
  • currency: ユーザーまたはホテルの国の通貨と一致します。 この属性では 3 文字の通貨コードを使用します。たとえば USD または EUR。
  • sitetype: ユーザーがホテル料金のデータを表示した Google プロパティに一致します。この属性には、 values:
    • localuniversal: ユーザーが広告または無料の予約を見つけた 検索でのリンク（通常は google.com での検索）
    • mapresults: ユーザーがホテル予約リンクを maps.google.com。
  • device: ユーザーが使用するデバイスの種類と一致します。 できます。この属性は mobile、desktop、または tablet。

    注: status を device が tablet に設定されている場合は 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 変数: 
http://partner.com/landing?hid=(PARTNER-HOTEL-ID)

このリンクが作成され、ユーザーに表示されると、PARTNER-HOTEL-ID 変数は適切なホテル ID に置き換えられます。ユーザーがサイトにアクセスすると、サイトは すべてのクエリ文字列パラメータの値を抽出して処理し、 スムーズなユーザーエクスペリエンスを実現します使用できる変数の完全なリストについては、 含まれている場合は、 変数と条件を使用するをご覧ください。

トラッキングを使用する場合は、これらの要素を含む完全な URL を指定してください。 必要があります。例:

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

ValueTrack パラメータは <URL> では使用できません。

各要素に定義できる <URL> 要素は 1 つのみです。 表示されます
<LPURL> Optional

ランディング ページ URL での動的トラッキングをサポートするために使用します。指定する <URL> で定義された URL のトラッキングなしセグメント要素です。 ランディング ページ URL のトラッキング セグメントは、Google のタグを使用して指定する必要があります Google 広告アカウントで利用可能な広告トラッキング テンプレート 最終ページ URL のサフィックスですGoogle 検索にトラッキング URL が存在しない場合 広告の場合、<LPURL> 要素は無視されます。

<LPURL> 値をエスケープする必要はありません。 Google 広告で正しい ValueTrack 設定を使用すると、 自動的に適用されます。例:

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

ValueTrack パラメータは <LPURL> では使用できません。 詳細については、<ph type="x-smartling-placeholder"></ph>をご覧ください。 ホテル キャンペーンに動的トラッキングを設定します。

ランディング ページ ファイルのスキーマは、ランディング ページの構造と制約を ランディングページファイルを指定します詳しくは、 ホテル広告のスキーマ