変数と条件

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

概要

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

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

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

例 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

Google がクエリ文字列の変数に割り当てる値は、 対応するデータを宿泊料金フィード、ホテルリスト フィード、ユーザー設定で収集できます。

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

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

変数値のソースについて詳しくは、このモジュールの 料金の概要 ホテルリスト。

URL の変数

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

URL の条件付きロジック

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

条件付きロジックでは、次のステートメントがサポートされています。

• if_statement: true の場合、これに続く値は URL に挿入されます。それ以外の場合は、URL の後に続く値が 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 の例

ユーザーが 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 のようになります。 次の 3 つです

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 をクリックすると、 できます。

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

クリックがホテル キャンペーンの URL（通常の検索キャンペーンなど）以外の場合は、 結果は次のようになります。

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

これは、ホテル キャンペーンのクリックのトラフィックと他のクリックを区別する場合に便利です。

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

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

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 条件文を使用して、次の条件に基づいて URL を変更します。 クリックが PPS コミッション プログラムの結果であるかどうか。以下の例では、クリックが 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 の例

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

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

<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 の例

テスト用の URL が Google によって生成されたものか、自動生成されたものかを確認する必要がある場合 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 人と 0 歳と 17 歳の子供 2 人が含まれているとします。 結果は次の 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 構築時の一般的なルール

すべての変数は省略可能です。モジュールに変数を挿入する必要はありません。 指定します。ただし、変数を使用して旅行プランとユーザー ユーザー エクスペリエンスの向上につながり Google のポリシーに準拠しています

ランディングで構成された URL を定義する際は、次の一般的なルールが適用されます。 pages ファイル:

• すべての変数は開き括弧と閉じ括弧で囲みます。

• クエリ文字列パラメータは、 生成します。アンパサンドは 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 エンコードする必要はありません。一般的な Pod の URL エンコードが必要な文字がある場合は、 URL エンコード。

• 1 つのパラメータの値は複数の変数から構成できます。「 次のサンプルでは、単一のパラメータ checkinDate を CHECKINDAY、CHECKINMONTH、CHECKINYEAR 変数:

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

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

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

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

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