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

ランディング ページ ファイルのルート要素は <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"
  />

Central Reservations System（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> 要素は 1 つのみです。
<LPURL> Optional

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

<LPURL> 値をエスケープする必要はありません。Google 広告で ValueTrack を正しく設定すれば、自動的にエスケープされます。次に例を示します。

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

ValueTrack パラメータは <LPURL> では使用できません。 詳細については、 ホテル キャンペーンの動的トラッキングを設定するをご覧ください。

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