変数と条件

ホテル広告と無料の予約リンクには、ユーザーが客室を予約できるランディング ページへのリンクが含まれています。ユーザーと宿泊プランに関する追加情報をすべて含めるようにリンクを構成する方法を定義して Google に提供できます。たとえば、ホテル ID、言語、通貨コード、チェックイン日などの情報を URL に含めることができます。

概要

ランディング ページ URL はランディング ページ ファイルで定義します。広告または無料予約リンクが表示されると、URL の動的情報が実際の値に置き換えられます。ランディング ページ URL に動的な値を追加するには、次の構文を使用します。

<URL>https://partner_url?param_id=(variable_name)</URL>

実際のホテル ID と旅行プランの代わりに Google の変数名を使用した URL の例を次に示します。

例 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

例 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

検索結果ページに表示するランディング ページへのリンクが構築されると、Google は URL に動的な情報が含まれるように変数を実際の値で置き換えます。たとえば、ユーザーがホテル #42 の客室を 2023 年 5 月 23 日から 6 泊分予約した場合、上記のリンクは次のように表示されます。

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

クエリ文字列の変数に割り当てられる値は、宿泊料金フィード、ホテルリスト フィード、ユーザー設定の対応するデータによって変わります。

たとえば、LENGTH 変数の値は、関連する旅行プランの料金フィードの <Nights> 要素に割り当てられます。同様に、PARTNER-HOTEL-ID 変数の値は、ユーザーの検索条件と一致するホテルリスト フィードの <id> 要素で定義されます。

一部の変数は、料金フィード要素のサブセットになっています。たとえば、CHECKINDAY、CHECKINMONTH、CHECKINYEAR の各変数は料金フィードの単一の <Checkin> 要素から抽出されます。その他の変数は、ユーザーの住所やその他のクライアント設定により算出されます。

変数値のソースについて詳しくは、料金の概要とホテルリストをご覧ください。

URL の変数

ランディング ページ URL の構築に利用できる変数を次の表に示します。

URL での条件付きロジック

ランディング ページ ファイルの <URL> 要素で特別なディレクティブを使用して、エンドポイントを条件付きで構築できます。

条件付きロジックでは、次のステートメントを使用できます。

• if_statement: true の場合、この条件に続く値が URL に挿入されます。false の場合は ELSE ディレクティブに続く値が挿入されます。

• for_statement: 指定された値の数に基づいて反復する FOR ループ条件を作成します。

IF ステートメントと FOR ステートメントには、次のようなものがあります。

IF-AD-CLICK の例

ユーザーが広告または無料の予約リンクをクリックしたかどうかを確認して、ランディング ページにリダイレクトする条件付きブロックを構築できます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

この例でユーザーが広告をクリックしなかった場合、結果は次の URL になります。

https://www.partner.com?hid=123&adType=0

ユーザーが広告をクリックした場合、URL は次のようになります。

https://www.partner.com?hid=123&adType=1

IF-CLICK-TYPE-HOTEL の例

ユーザーが条件の組み合わせを明示的に指定せずにホテルを選択したかどうかを確認する条件付きブロックを作成できます。トランザクション メッセージの <Room Bundle> ブロック内の <RatePlanID> 要素の値は、ユーザーが選択した条件の組み合わせの料金に暗黙的に関連付けられます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

この例でユーザーが条件の組み合わせを選択した場合は、次の URL が返されます。

https://partner.com/landing_room?hid=123

ユーザーが条件の組み合わせを選択しなかった場合は、次の URL が返されます。

https://partner.com/landing?hid=123

IF-CLICK-TYPE-ROOM の例

ユーザーが条件の組み合わせを選択したかどうか確認する条件付きブロックを作成できます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

この例でユーザーが条件の組み合わせを選択しなかった場合は、次の URL が返されます。

https://partner.com/landing?hid=123

ユーザーが条件の組み合わせを選択した場合、結果の URL は次のようになります。

https://partner.com/landing_room?hid=123

IF-DEFAULT-DATE の例

IF-DEFAULT-DATE 条件文を使用して、日付以外のパラメータを設定します。このパラメータは、ユーザーが日付を選択しなかった場合に、ウェブサイトでカスタム動作をトリガーするために使用できます。

次の例では、デフォルトの日付が使用されたかどうかを確認します。

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

この例でユーザーが日付を選択しなかった場合は、次のような URL が返されます（デフォルトの日付選択が表示される）。

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

ユーザーが日付を選択した場合は、選択された旅行プランに応じて次のような URL が返されます。

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN の例（ホテル広告と無料の予約リンクのクリック）

ユーザーがホテル キャンペーンの広告をクリックしたかどうかを確認する条件付きブロックを作成できます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

この例でユーザーがホテル キャンペーンの URL をクリックすると、URL は次のようになります。

https://www.partner.com?hotelID=123&hotel_campaign=12345678

クリックしたのがホテル キャンペーンの URL ではない場合は（標準の検索キャンペーンなど）、URL は次のようになります。

https://www.partner.com?hotelID=123&utm_campaign=87654321

これは、ホテル キャンペーンのクリックのトラフィックと他のクリックのトラフィックを見分けたい場合に便利です。

FBL クリックで CAMPAIGN-ID が空白

クリックが無料予約リンクからのものである場合、IF-HOTEL-CAMPAIGN は TRUE を返します。CAMPAIGN-ID の値は、次の URL に示すように空白に設定されます。

https://www.partner.com?hotelID=123&hotel_campaign=

次の例に示すように、IF-AD-CLICK 条件ステートメントを使用すると、キャンペーン ID が空白になるのを防ぐことができます。

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-PAYMENT-ID の例（ホテル広告のみ）

IF-PAYMENT-ID 条件ステートメントを使用し、クリックが PPS コミッション プログラムの結果であるか否かに基づいて URL を変更します。以下の例では、クリックが PPS コミッション プログラムの結果であるかどうかを確認し、その結果に基づいて booking_source パラメータに値を割り当てます。

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

ホテルがコミッション プログラムに参加している場合、次のいずれかの URL が返されます。

• Google に IATA 番号が割り当てられていない場合:

  https://partner.com?hid=123&booking_source=commissions

• IATA 番号が Google に割り当てられている場合:

  https://partner.com?hid=123&booking_source=01234567

プログラムに参加していない場合は、次の URL が返されます。

https://partner.com?hid=123&booking_source=cpc

IF-PROMOTED の例（ホテル広告のみ）

ユーザーが施設プロモーション広告をクリックしたかどうかを確認する条件付きブロックを作成できます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

この例でユーザーが施設プロモーション広告を選択した場合は、次の URL が返されます。

https://partner.com/1?hid=123

ユーザーが施設プロモーション広告を選択しなかった場合は、次の URL が返されます。

https://partner.com/0?hid=123

IF-RATE-RULE-ID の例

ユーザーが限定価格を選択したかどうかを確認する条件付きブロックを作成できます。その場合、トランザクション メッセージの <Rate> ブロック内の <RateRuleID> 要素の値が使用されます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

この例でユーザーが限定価格を選択しなかった場合は、次の URL が返されます。

https://www.partner.com?hid=123

ユーザーが限定価格を選択した場合は、次の URL が返されます。

https://www.partner.com?hid=123&customerType=42

IF-USER-LIST-ID の例（Google 広告で定義）

Google 広告のホテル キャンペーンでオーディエンス リストの入札単価調整比を設定する場合は、IF-USER-LIST-ID と USER-LIST-ID を使用して、特定の Google 広告オーディエンス リストに含まれている顧客用にウェブサイトにパラメータを設定できます。トラッキングを行いたい場合や、オーディエンス リストのメンバー向けにウェブサイトをカスタマイズしたい場合には、このようにします。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

この例でユーザーがオーディエンス リストのメンバーでない場合は、次の URL が返されます。

https://www.partner.com?hid=123

ユーザーがオーディエンス リスト 12345678 のメンバーの場合は、次の URL が返されます。

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION の例

Google がテストまたは自動検証用に URL を生成したかどうかを確認する必要がある場合は、IF-VERIFICATION を使用します。

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

この例では、Google がテストや検証のために URL を生成していない場合、次の URL が返されます。

https://www.partner.com?hid=123

Google がテストや検証のために URL を生成した場合、結果は次の URL になります。

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE の例

宿泊料金フィードで指定されている、子どもの年齢の上限を入力する条件付きブロックを作成できます。

次の例では、ランディング ページ ファイルでこのディレクティブを使用しています。

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

この例では、旅行プランの定員が大人 2 人、子ども 2 人（それぞれ 0 歳と 17 歳）の場合は、次の URL が返されます。

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

旅行プランの定員が大人が 2 人、子ども 0 人の場合は、次の URL が返されます。

https://www.partner.com?adults=2&children=0&hid=123

URL 作成時の一般的なルール

変数はすべて省略可能です。ランディング ページ URL に変数を挿入する必要はありません。ただし、一般的には、変数を使って旅行プランとユーザー情報を渡すとユーザーの利便性が向上し、Google のポリシーを遵守するうえでも役立ちます。

構築された URL をランディング ページ ファイルで定義する場合は、次の一般的なルールが適用されます。

• すべての変数は開きかっこと閉じかっこで囲まれます。

• クエリ文字列のパラメータは最終的な出力ではアンパサンド（&）で区切る必要があります。アンパサンドは XML 内では特殊文字となるため（ランディング ページ ファイルの形式は XML です）。そのため、エンコードしたエンティティ「&」を代わりに使用する必要があります。最終的な出力では実際の「&」という文字が表示されます。次に例を示します。

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  また、ランディング ページ URL に含める特殊文字も、URL 向けにエンコードする必要があります。次に例を示します。

  • スペース（「 」）: スペースは <URL> 要素内では「%20」という文字に置き換えます。
  • フォワード スラッシュ（「/」）: フォワード スラッシュは <URL> 要素内では「%2F」という文字に置き換えます。

  すべてのアルファベット以外の文字を URL 向けにエンコードしなければならないわけではありません。たとえば、ハイフン（「-」）は URL 向けにエンコードする必要がありません。URL 向けにエンコードする必要がある、よく使われる文字の一覧は、URL エンコードをご覧ください。

• 単一のパラメータの値を複数の変数で構成することができます。次の例では、CHECKINDAY、CHECKINMONTH、CHECKINYEAR の変数から単一のパラメータ checkinDate を構成します。

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  上記の例の結果として、以下のような URL が表示されます。

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• クエリ文字列のパラメータの名前には、任意の ID を使用できます。お客様のサーバーは、これらの値を処理します。ただし、渡される値は利用可能な変数のリストにある値に限られます。

• 利用可能な変数のリストにある値の他に、カスタマイズした値も 5 つまで使用できます。