変数と条件

ホテル広告と無料の予約リンクには、ユーザーが客室を予約できるランディング ページへのリンクが含まれています。ユーザーと宿泊プランに関する追加情報をすべて含めるようにリンクを構成する方法を定義して 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> 要素で定義されます。

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

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

URL の変数

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

変数 推奨 / オプション 説明
ADVANCE-BOOKING-WINDOW Optional 予約時のホテルのタイムゾーンで指定される、チェックイン日の前日までの予約可能日数。たとえば、36 です。
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) 宿泊施設の代替 ID。この属性名 はホテルリスト フィードで指定されています。個別の ID を使用すると、 フィード情報用に 1 つのプロパティ ID と、もう 1 つのプロパティ ID が必要です。 予約エンジン用のプロパティ ID です
CAMPAIGN-ID Recommended 関連付ける Google 広告キャンペーンの ID URL。クリックが Google 広告に関連付けられていない場合は、空白になります。 あります
CHECKINDAY Recommended 宿泊料金フィードの <Checkin> 要素で定義された 2 桁で表した日付。例: 20
CHECKINDAY-OF-WEEK Optional ホテルのタイムゾーンで指定されるチェックインの曜日(MondaySunday)。例: Tuesday
CHECKINMONTH Recommended <Checkin> で定義された 2 桁の月 要素を使用して識別されます例: 05
CHECKINYEAR Recommended 宿泊料金フィードの <Checkin> 要素で定義された 4 桁で表した年。例: 2023
CHECKOUTDAY Recommended <Nights> から計算した日と、 宿泊料金フィードの <Checkin> 要素。例: 26
CHECKOUTMONTH Recommended 宿泊料金フィードの <Nights> 要素と <Checkin> 要素から算出された 2 桁で表した月。たとえば、05 です。
CHECKOUTYEAR Recommended <Nights> から計算された年(4 桁) および <Checkin> 要素です。たとえば、2023 です。
CHILD-AGE Recommended (must be provided for child occupancy pricing) 料金フィードの <Child "age"> 要素。 この変数は、terraform.tfvars、 FOR-EACH-CHILD-AGE 条件ブロック。
CHILD-INDEX Optional 各子のカウンタを表す 0 から始まるループ変数 旅行プランで指定された客室乗員と子供の年齢。この変数は必須ではなく、FOR-EACH-CHILD-AGE 条件付きブロックとの組み合わせでのみ使用できます。
CLICK-TYPE Optional ユーザーが標準ホテルのリスティングをクリックしたかどうかを示します または条件の組み合わせを指定できます有効な値は次のとおりです。
  • hotel: ユーザーが標準の客室料金のリスティングをクリックしました。
  • room: ユーザーが客室のリスティングをクリックしました 一括販売。
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) 適用された料金ルール ID のカンマ区切りのリスト 利用できませんでしたが、ユーザーが 簡単な操作です。料金ルール ID は 非公開レート 対応する UI 処理が表示されると、常にここに入力されます。 提供します。
CUSTOM[1-5] Optional <Result> 要素で定義されたカスタム フィールドの値。カスタム フィールドごとに 200 文字の制限があります。詳細情報 詳しくは、 概要 トランザクション メッセージの構成要素です。使用中はカスタム フィールドを使用できません ARI
DATE-TYPE Optional ユーザーが検索時にデフォルトの日付を使用したか、検索で指定した特定の日付を使用したかを示します。有効な値は次のとおりです。
  • default: ユーザーがホテル広告または無料をクリックしました 予約リンクが表示されます。
  • selected: ユーザーは日付を設定してホテル広告または無料予約リンクをクリックしました。
GOOGLE-ADS-CLICK-SOURCE Optional クリックの発生元が Google 広告であることを示します。有効な値は次のとおりです。
  • bl: 有料予約リンク
  • tpa: 旅行プロモーション広告
  • tfsa: 検索広告の旅行フィード
  • pm: P-MAX または旅行関連の目標達成のための P-MAX 目標のキャンペーン。
  • 注: クリックが Google 広告ではなく Google 検索から発生した場合、このパラメータは空になります。

GOOGLE-SITE Optional ユーザーがホテルの料金データを閲覧した Google プロパティ。 有効な値は次のとおりです。
  • localuniversal: ユーザーがホテルの予約リンクを見つけました google.com 検索で。
  • mapresults: ユーザーがホテルの予約リンクを見つけました maps.google.com 経由。
  • verification: Google は次の処理を実行するときにこの値を使用します。 サイトの自動データ品質テストを 行うことができます請求は行われません 作成できますGoogle アナリティクスでは、このパラメータとその値を使用できます。 ホテル広告の自動検証トラフィックの識別に役立ちます
  • unknown: ユーザーが広告または無料の予約リンクを見つけた アクセスします
LENGTH Recommended 宿泊料金フィードの <Nights> 要素で定義された宿泊数に基づく滞在日数。例: 3
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) ユーザーが旅行プランで指定した大人の宿泊人数。 この変数は、NUM-CHILDRENFOR-EACH-CHILD-AGE、またはその両方と組み合わせて使用する必要があります。
NUM-CHILDREN Recommended ユーザーが旅行プランで指定した子どもの人数(0~17 歳)。子どもの定員のある旅行プランを入札できるためには、NUM-CHILDRENFOR-EACH-CHILD-AGE、または両方が必要です。
NUM-GUESTS Recommended (if you don't send child occupancy pricing) サービスに指定された、大人と子供の両方の宿泊人数の合計 表示することもできます。これは NUM-ADULTS の値と NUM-CHILDREN の値の合計です。宛先 できるだけ多くのチャネルにリーチするため、 代わりに NUM-ADULTSNUM-CHILDREN を使用してください。
PACKAGE-ID Recommended (applies if you use Room Bundles) 宿泊料金フィードの一意のパッケージ ID。標準パッケージの場合、パッケージ ID は <Result> ブロック内の <PackageID> 要素の値になります。条件の組み合わせの場合、パッケージ ID は、トランザクション メッセージの <RoomBundle> ブロックまたは <PackageData> ブロック内の <PackageID> 要素の値になります。
PARTNER-CURRENCY Optional 宿泊料金フィードの <Baserate> 要素の currency 属性で定義された 3 文字の通貨コード。たとえば、USDCAD です。
PARTNER-HOTEL-ID Recommended ホテルリスト フィードの <id> 要素で定義された一意のホテル ID。
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 宿泊料金フィードに含まれる客室の一意の識別子。標準の客室の場合、客室 ID は <Result> ブロック内の <RoomID> 要素の値になります。条件の組み合わせの場合、客室 ID は条件 次の「<RoomID>」要素: <RoomBundle> ブロックまたは <RoomData> ブロック を Transaction メッセージに含めます。
PAYMENT-ID Optional (only applies to Ads) あらかじめ定義された文字列 commission、または手数料徴収代行業者を利用する場合は、Google が割り当てる IATA 番号(「01234567」など)に解決されます。IATA 番号の形式を変更するには、 使用できない場合は、テクニカル アカウント マネージャー(TAM)にお問い合わせください。
PRICE-DISPLAYED-TAX (Optional) ユーザーの地域の通貨で表示される税額。PRICE-DISPLAYED-TAX の値は、 宿泊料金フィードの <Tax> 要素。例: 「3.14」
PRICE-DISPLAYED-TOTAL (Optional) ユーザーに表示された部屋の合計費用です。 使用します。PRICE-DISPLAYED-TOTAL の値は、宿泊料金フィードの <Baserate> 要素、<Tax> 要素、<OtherFees> 要素の合計です。例: 「152.13」
PROMO-CODE (Optional)

以下をご使用の場合: ARI promotion の場合、この変数の値は適用された <Promotion>id 属性に割り当てられます。複数のプロモーションが適用されている場合は、任意の順序でのプロモーション ID のカンマ区切りのリストです。

料金ルールを使用する場合、この変数の値は、対応する料金ルールが適用されている場合に PromoCode 要素に割り当てられます。

RATE-PLAN-ID Recommended (only applies if you use RoomBundles) 料金フィードの <RoomBundle> ブロック内の <RatePlanID> 要素で定義された ID。「 <RatePlanID> は一意の識別子を表します。 会議室とパッケージ データの組み合わせの条件を満たしています。詳しくは、条件の組み合わせをご覧ください。
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) rate_rule_id 属性で定義された ID 料金フィードの <Rate> ブロック。詳しくは、限定価格をご覧ください。

注: 非公開ではない限定価格または非公開レートのみが表示されます。

USER-COUNTRY Recommended ユーザーの位置情報を示す2 文字の国コード。この情報はユーザーのクライアント設定から抽出されます。たとえば、USFR です。
USER-CURRENCY Recommended ユーザーの所在国を示す 3 文字の通貨コード 使用します。USER-CURRENCY 変数の値は、ユーザーのクライアント設定から推測されます。たとえば、USDCAD などです。
USER-DEVICE Recommended お客様のデバイスの種類。USER-DEVICE の値は、次のいずれかです。
  • mobile
  • tablet
  • desktop
  • unknown

USER-DEVICE 変数の値は、ユーザーのクライアント設定から推測されます。

USER-LANGUAGE Recommended 2 文字の 広告の表示言語を指定する ISO 639-1 言語コード 広告または無料の予約リンクですUSER-LANGUAGE の値 変数はユーザーのクライアント設定から推定されます。たとえば en または fr
USER-LIST-ID(Google 広告で定義) Optional (only applies if you use Audience Lists in Google Ads) オーディエンス リストまたはユーザーを含む Google 広告のユーザーリスト ID 情報です。オーディエンスリストは 入札単価の設定 調整します。ユーザーが複数のオーディエンス リストに含まれている場合、入札単価調整が最も大きいオーディエンス リストが選択されます。同じセグメント 入札単価調整が最も大きいオーディエンスはランダムに決定されます。
VERIFICATION Optional Google がテストまたは自動検証のために生成したリンクかどうかを確認するブール値。リンクが生成された場合は true です。 それ以外の場合は false になります。

URL の条件付きロジック

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

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

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

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

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

条件 推奨 / オプション 説明
IF-AD-CLICK(ホテル広告のみ) Optional ユーザーが広告をクリックした場合、true になります。 ユーザーが無料ページで発生した場合は false になります。 予約リンクが表示されます。
IF-CLICK-TYPE-HOTEL Optional ユーザーがリスティングをクリックすると、true になります。 Hotel の場合、それ以外の場合は false に解決されます。
IF-CLICK-TYPE-ROOM Optional 次の場合は true に解決されます。 ユーザーが のリスティングをクリックしました 条件の組み合わせです。それ以外の場合は false に解決されます。
IF-CLOSE-RATE-RULE-IDS Optional ユーザーが対象外であったため 1 つ以上の限定価格を選択できなかった場合は、true になります。それ以外の場合は false になります。デフォルトでは、true 非公開レート UI 処理がユーザーに表示された。
IF-DEFAULT-RATE Optional デフォルトの日付でユーザーがホテル リスティングをクリックした場合は true になります。それ以外の場合は false になります。
IF-HOTEL-CAMPAIGN Optional ユーザーがホテル キャンペーンをクリックした場合は true、それ以外の場合は false になります。この区別は、Google 広告に複数のキャンペーン タイプがあるパートナーがアトリビューションを割り当てる場合に役立ちます。
IF-PAYMENT-ID(ホテル広告のみ) Recommended (if you use pay-per-stay Google Ads campaigns) 宿泊課金型コミッション プログラムを利用するホテルの場合は true、それ以外の場合は false になります。
IF-PROMO-CODE Optional ユーザーがレートをクリックした場合、true になります。 ARI プロモーションまたは特定の PromoCode の料金ルールに基づく。 それ以外の場合は false に解決されます。
IF-PROMOTED(ホテル広告のみ) Recommended (if you use Promoted hotels) ユーザーがプロパティをクリックした場合は true になります。 プロモーション広告。それ以外の場合は false に解決されます。
IF-RATE-RULE-ID Optional ユーザーが限定価格を選択した場合は true、それ以外の場合は false になります。
IF-USER-LIST-ID(Google 広告で定義) Optional ユーザーが、オーディエンス リストの入札単価調整比を設定する際に指定した Google 広告の顧客リスト ID のメンバーである場合は true、それ以外の場合は false になります。
IF-VERIFICATION Optional Google がテストまたは自動検証のために生成したリンクの場合は true になります。それ以外の場合は false になります。
ELSE Recommended (if you use any conditional IF statements) 前の条件を満たしていない場合、この後に続く値は URL に挿入されます
END-IF Optional (required if you have any IF conditional statements) IF ステートメントの条件付きブロックを終了します。
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) 料金フィードの <Child "age"> 要素ごとに 1 回実行されます。たとえば、<OccupancyDetails><Child age="17"><Child age= "17"> の 2 つの要素が含まれている場合、このディレクティブは 2 回実行されます。
END-FOR-EACH Optional (required if using FOR-EACH block) FOR-EACH ステートメントの条件付きブロックを終了します。

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 に示すように、TRUECAMPAIGN-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&amp;booking_source=commissions
  • IATA 番号が Google に割り当てられている場合:
    https://partner.com?hid=123&amp;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-IDUSER-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 である。そのため、エンコードされたエンティティを使用して 「&amp;」使用できます。最終出力では、実際の「&」がレンダリングされます。あります。 例:

    <!-- 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 つのパラメータの値は複数の変数から構成できます。「 次のサンプルでは、単一のパラメータ checkinDateCHECKINDAYCHECKINMONTHCHECKINYEAR 変数:

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

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

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

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