変数と条件

ホテル広告と無料の予約リンクには、ユーザーがアクセスするランディング ページへのリンクが含まれます。 会議室を予約できます。すべての 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> 要素で定義されています。 ユーザーの検索条件に一致するフィード。

一部の変数は料金フィード要素のサブセットです。たとえば、 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 桁の日 ホテル料金フィードの 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> から計算された月(2 桁) および <Checkin> 要素です。たとえば、05 です。
CHECKOUTYEAR Recommended <Nights> から計算された年(4 桁) および <Checkin> 要素です。たとえば、2023 です。
CHILD-AGE Recommended (must be provided for child occupancy pricing) <ph type="x-smartling-placeholder"></ph> 料金フィードの <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-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) ユーザーが旅行プランに指定した大人の宿泊人数。 この変数は、terraform.tfvars、 NUM-CHILDRENFOR-EACH-CHILD-AGE、またはその両方。
NUM-CHILDREN Recommended 子供の宿泊人数(0 ~ 17 歳)の 旅行プランが表示されますNUM-CHILDREN, 正常に機能させるには、FOR-EACH-CHILD-AGE、または両方が必要です 子供の宿泊人数を含む旅行プランへの参加
NUM-GUESTS Recommended (if you don't send child occupancy pricing) サービスに指定された、大人と子供の両方の宿泊人数の合計 表示することもできます。この値は、 NUM-ADULTSNUM-CHILDREN の値。宛先 できるだけ多くのチャネルにリーチするため、 代わりに NUM-ADULTSNUM-CHILDREN を使用してください。
PACKAGE-ID Recommended (applies if you use Room Bundles) 宿泊料金フィードに含まれるパッケージの一意の識別子。1 つの 標準パッケージの場合、パッケージ ID は <Result> 内の <PackageID> 要素 ブロックします。条件の組み合わせの場合、パッケージ ID は 次の「<PackageID>」要素: <RoomBundle> ブロックまたは <PackageData> ブロック 必要があります。
PARTNER-CURRENCY Optional AdSense で定義される 3 文字の通貨コード <Baserate> 要素の currency 属性 ホテル料金フィードで確認できますたとえば、USDCAD です。
PARTNER-HOTEL-ID Recommended ホテルリスト フィードの <id> 要素。
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) 宿泊料金フィードに含まれる客室の一意の識別子。1 つの 場合、客室 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 を任意の順序で指定できます。

<ph type="x-smartling-placeholder"></ph>を使用している場合 レートルールを適用している場合は、対応する料金ルールが適用されると、この変数の値が PromoCode 要素に割り当てられます。

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

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

USER-COUNTRY Recommended 2 文字の 国コード。この ユーザーのクライアント設定から抽出される情報です。対象 たとえば、USFR です。
USER-CURRENCY Recommended ユーザーの所在国を示す 3 文字の通貨コード 使用します。USER-CURRENCY 変数の値は次のとおりです。 ユーザーのクライアント設定から推測されます。例: USD または CAD
USER-DEVICE Recommended ユーザーのデバイスタイプ。USER-DEVICE の値は、 次のいずれかになります。 <ph type="x-smartling-placeholder">
    </ph>
  • 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 になります。この 複数のキャンペーン タイプがあるパートナーに有効です アトリビューションが割り当てられます。
IF-PAYMENT-ID(ホテル広告のみ) Recommended (if you use pay-per-stay Google Ads campaigns) 宿泊課金型(PPS)のホテルの場合は 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 広告のメンバーの場合は、true になります。 オーディエンスの入札単価調整比を設定する際に指定した顧客リスト ID それ以外の場合は 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) それぞれに対して 1 回実行します。 <ph type="x-smartling-placeholder"></ph> 料金フィードの <Child "age"> 要素。対象 例: <OccupancyDetails> に 2 つ <Child age="17"> 要素と <Child age= "17"> 要素がある場合、このディレクティブは 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 の例

ユーザーがホテルを選択したかどうかを確認する条件付きブロックを作成できます。 条件の組み合わせを明示する必要はありません。次の <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 に示すように、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

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

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

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>
    

    また、 指定します。例:

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

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