変数と条件

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

概要

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

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

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

<URL>https://www.partnerdomain.com?hotelID=(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 の例

ユーザーがホテルを選択したかどうかを確認する条件付きブロックを作成できます。 条件の組み合わせを明示する必要はありません。次の <RatePlanID> 要素の値: Transaction メッセージの <Room Bundle> ブロックは、暗黙的に ユーザーが選択した条件の組み合わせ料金です。

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

<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

ユーザーが施設プロモーション広告を選択しなかった場合は、 できます。

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 を生成した場合、結果は できます。

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>
  

  また、 指定します。例:

  • スペース (" "): スペース文字を「%20;」に置き換えます。<URL> 要素内
  • スラッシュ ("/"): スラッシュは「%2F」に置き換えます。<URL>内 要素

  アルファベット以外のすべての文字を 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 つのカスタム変数を使用できます。 使用します。