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

ランディング ページ ファイルのルート要素は <PointsOfSale> です。この要素は 1 つの子要素 <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"
  />

集中予約システム（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)

このリンクが作成され、ユーザーに表示されると、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> 要素は 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> では使用できません。 詳しくは、 ホテル キャンペーンの動的トラッキングを設定するをご覧ください。

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