ランディング ページ フィードを作成する
ランディング ページ データBing提供するには、サポートする各予約サイトの販売時点管理 (POS) を含む XML ドキュメントを作成します。 POS は、ユーザーを POS に照合するための POS の表示名、URL、および条件を記述します。
ドキュメントでは UTF-8 エンコードを使用する必要があり、 PointsOfSale XSD に準拠している必要があります。
注:
Bingでは、すべての XSD 要素がサポートされているわけではありません。 Bingは、ドキュメント内でサポートされていない要素または属性を無視します。 ランディング ページリファレンスには、Bingがサポートする要素と属性のみが含まれています。
注:
このドキュメントでは、PointsOfSale XSD で定義されている順序で要素を指定する必要があります (または、参照に示すように)。
フィードの最上位要素
ランディング ページ フィードには、最上位レベルの PointsOfSale 要素が 1 つ含まれています。
PointsOfSale要素には、ユーザーが会議室の予約に使用できるサイトごとに PointOfSale 子要素が必要です。
<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<PointOfSale>
. . .
</PointOfSale>
...
</PointsOfSale>
PointOfSale要素は、ユーザーを POS に照合するための POS の表示名、URL、および条件について説明します。 POS の定義については、「 販売時点管理の定義」を参照してください。
販売時点管理の定義
PointsOfSale要素には、ユーザーが会議室の予約に使用できる POS サイトごとに 1 つずつ、PointOfSale 要素の一覧が含まれています。 リストには、1 つのパートナーのランディング ページが含まれている必要があります。
英語を話すユーザーのランディング ページを定義する PointOfSale 要素を次に示します。 最初の PointOfSale 要素は、任意のデバイスで英語を話すエンド ユーザー用の POS を定義し、2 番目の PointOfSale 要素は、モバイル デバイス上の英語を話すエンド ユーザー用の POS を定義します。 POS URL には、チェックとチェックの日付、ホテル ID、ユーザー言語など、トランザクションに関する詳細が含まれています。 Bingは、表示名と POS URL を使用して、広告に追加されるハイパーリンクを作成します。 ユーザーがリンクをクリックすると、予約サイトにアクセスします。 パフォーマンス 追跡に追跡テンプレート を使用している場合、追跡を機能させるには、ランディング ページ URL LPURL 要素を POS フィード ファイルで構成する必要があります。 Bingは、表示名と POS URL または LPURL を使用して、広告に追加されるハイパーリンクを作成します。 ユーザーがリンクをクリックすると、予約サイトにアクセスします。
<PointOfSale id="English">
<DisplayNames display_text="ContosoTravel.com" display_language="en" />
<Match status="yes" language="en" />
<URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</LPURL>
</PointOfSale>
<PointOfSale id="English-Mobile">
<DisplayNames display_text="ContosoTravel.com" display_language="en" />
<Match status="yes" language="en" device="mobile" />
<URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
<LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</LPURL>
</PointOfSale>
DisplayNames要素は、オンライン旅行代理店にのみ含めます。 中央予約システム (CRS) サプライヤー (統合パートナーとも呼ばれます) と直接サプライヤー (ホテルの所有者やチェーンなど) の DisplayNames は含めないでください。 CRSサプライヤーと直接サプライヤーの場合、Bingはプロパティフィードからホテルの名前を使用します。
DisplayNamesを含める場合は、言語条件が同じ言語に設定されているMatch要素を含める必要があります。
Bingは、POS の一致条件に基づいてユーザーに最も一致する POS を使用します。 上記の一致条件に基づいて、モバイル デバイス上のユーザーは English-Mobile POS を使用し、他のすべてのユーザーが英語の POS を使用します。 ユーザー Bing POS と照合する方法の詳細については、「 ランディング ページの照合」を参照してください。 一致できる条件の一覧については、 Match 要素を参照してください。
URL要素は、ユーザーが会議室を予約できるサイトへのリンクを指定します。 この例では、動的クエリ パラメーターの使用を示します。 Bingは、実行時に動的変数の値を置き換えます。 動的クエリ パラメーターの使用については、「動的クエリ パラメーターの 使用」を参照してください。
注:
言語と国の一致条件を指定する場合は、 en と US のみに設定する必要があります。
完全なランディング ページ XML ドキュメントを次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<PointOfSale id="English">
<DisplayNames display_text="ContosoTravel.com" display_language="en" />
<Match status="yes" language="en" />
<URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
</PointOfSale>
<PointOfSale id="English-Mobile">
<DisplayNames display_text="ContosoTravel.com" display_language="en" />
<Match status="yes" language="en" device="mobile" />
<URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&language=(USER-LANGUAGE)</URL>
</PointOfSale>
</PointsOfSale>
ランディング ページの照合
ランディング ページには、ユーザーを POS に一致させるために使用Bing条件を含む Match 要素が含まれます。 ユーザーとランディング ページの照合に使用Bing条件を次に示します。 リストは優先順です。
- country
- 通貨
- language
- デバイス
- sitetype
Bingでは、次の規則を使用して最適な POS 一致を見つけます。
Bingは、国の一致に対する優先順位が最も高く、デバイスの一致に対する優先順位が最も低くなります。
Matchでいずれかの条件が指定されていない場合、Bingは条件のすべての値に暗黙的に一致します。 たとえば、Matchで言語と通貨が指定されている場合、Bingはどの国やデバイスにも暗黙的に一致します。Matchが 1 つ以上の条件を指定Bing場合、最も明示的に一致する POS が使用されます。明示的な規則の一致がない場合、POS の選択は決定的ではありません。 一致条件の明示的な規則を追加することをお勧めします。
Match要素の status 属性は、照合に基づいて POS を含めるか除外するかを決定します。 状態が 決してなく 、すべての条件Bing一致する場合、Bingは POS を使用しません。 POS を除外するには、すべての条件が一致する必要があります。 次の例では、Bingは、ユーザーが米国またはフランスのユーザーである場合は明示的に POS を除外し、ユーザーが他の国のユーザーである場合は暗黙的に含めます。
<PointOfSale id='exclude-example'>
. . .
<Match status='never' country='US' />
<Match status='never' country='FR' />
. . .
</PointOfSale>
状態が [はい] の場合、Bingは、すべての条件に明示的に一致しないランディング ページを考慮から排除しませんが、最も条件に一致する POS に優先設定が付与されます。 次の例では、Bingユーザーの国がフランスの場合、ユーザーを POS に明示的に一致させます。 ユーザーの国がフランスでない場合、より一致するものが見つかるまで POS は引き続き考慮されます。 一致するものが見つからない場合、Bingは POS を使用します。
<PointOfSale id='exclude-example'>
. . .
<Match status='yes' country='FR' />
. . .
</PointOfSale>
Bingでは、POS ごとに同じ一致条件を使用することをお勧めします。 これにより、ある POS が別の POS と一致した理由を判断する際の複雑さが最小限に抑えられます。
動的クエリ パラメーターの使用
販売時点管理 (POS) には、ユーザーが会議室を予約できるサイトを識別する URL 要素が含まれています。 URL には動的クエリ パラメーターが含まれる場合があります。これは、値の定義済みトークンを含むユーザー定義パラメーターです。 Bing広告に URL を追加する前に、トークンを値に置き換えます。 動的クエリ パラメーターを使用すると、ホテルの ID、チェック日付、滞在期間などを URL に含めることができます。
POS URL で動的クエリ パラメーターを指定するために使用する構文を次に示します。 動的クエリ パラメーターはクエリ パラメーターであるため、URL の疑問符記号 (?) に従う必要があります。
http://domain.com/path?param-name=(dynamic-variable-name)
URL で指定できる大文字と小文字を区別する動的変数名を次に示します。
| 名前 | 説明 |
|---|---|
| ADGROUP-ID | 広告をトリガーした広告グループの ID。 たとえば、URL が www.northwindtraders.com/(ADGROUP-ID)であるとします。 広告グループ ID が2410012280であると仮定すると、広告のランディング ページ URL は www.northwindtraders.com/2410012280になります。 |
| 事前予約ウィンドウ | 予約が行われたチェック日の前の日数。 たとえば、36 です。 |
| BING-SITE | 広告要求を開始したBing プロパティ。 使用可能な値は次のとおりです。
|
| CAMPAIGN-ID | 広告をトリガーしたキャンペーンの ID。 たとえば、URL が www.northwindtraders.com/(CAMPAIGN-ID)であるとします。 キャンペーン ID が2410012280であると仮定すると、広告のランディング ページ URL は www.northwindtraders.com/2410012280 になります。 |
| CHECKINDAY |
Price フィードの Checkin 要素で指定された 2 桁の日。 たとえば、20 です。 |
| CHECKINDAY-OF-WEEK | チェックが行われる曜日。 Bingでは、0 から 6 の数字を使用して、月曜日から日曜日を表します。 たとえば、1 は火曜日です。 |
| CHECKINMONTH | Price フィードの Checkin 要素で指定された 2 桁の月。 Bingでは、00 から 11 の数字を使用して、1 月から 12 月を表します。 たとえば、05 は 6 月です。 |
| CHECKINYEAR | Price フィードの Checkin 要素で指定された 4 桁の年。 たとえば、2021 です。 |
| CHECKOUTDAY | ユーザーがチェックアウトする 2 桁の日付。Bingでは、TransactionMessage の Nights 要素と Checkin 要素を使用して日を計算します。 たとえば、23 です。 |
| CHECKOUTMONTH | ユーザーがチェックアウトする 2 桁の月。Bingでは、Price フィードの Nights 要素と Checkin 要素を使用して月を計算します。 たとえば、07 です。 |
| CHECKOUTYEAR | ユーザーがチェックアウトする 4 桁の年。Bingでは、Price フィードの Nights 要素と Checkin 要素を使用して年を計算します。 たとえば、2021 です。 |
| CLICK-TYPE | ユーザーがホテル広告とルーム バンドル広告のどちらをクリックしたかを示します。 使用可能な値は次のとおりです。
|
| CUSTOM[1-5] | Price フィードの Result 要素で指定されたユーザー設定フィールド (Custom1 など) の値。 |
| DATE-TYPE | ユーザーがチェックとチェックアウトの日付を指定したかどうかを示します。 使用可能な値は次のとおりです。
|
| HOTELGROUP_ID |
注: HOTELGROUP_IDは、Hotel Center を参照するレガシ パラメーターです。 代わりに ADGROUP-ID を使用してください。 ホテル広告が属するホテル グループの ID。 |
| LENGTH | Price フィードの Nights 要素で指定された滞在期間。 たとえば、3 です。 |
| NETWORK | 広告が配信された広告ネットワークの種類。
|
| NUM-ADULTS | 客室に宿泊する大人の人数。 既定値は 2 です。 |
| PARTNER-CURRENCY | Price フィードの Baserate 要素の currency 属性で指定された 3 文字の通貨コード。 たとえば、USD です。 |
| PARTNER-HOTEL-ID | Property フィードの id 要素で指定されたホテルの ID。 |
| PARTNER-ROOM-ID | 部屋を一意に識別する ID。 これは、使用状況に応じて、<Result>、<RoomBundle>、または <RoomData> ブロックの <RoomID> 要素で指定された ID です。 |
| PRICE-DISPLAYED-TAX | ユーザーの現地通貨での税金の金額。 税額は、Price フィードで指定された Tax 要素に基づいています。 たとえば、3.14 です。 |
| PRICE-DISPLAYED-TOTAL | ユーザーの現地通貨での会議室の合計コスト。 この金額は、Price フィードで指定された Baserate、 Tax、 OtherFees の要素の合計に基づいています。 たとえば、152.13 です。 |
| SLOT_TYPE | 結果ページでの広告の配置。 パラメーターには、次の可能な値が含まれる場合があります。
|
| SUBACCOUNT_ID |
注: SUBACCOUNT_IDは、Hotel Center を参照する従来のパラメーターです。 代わりに CAMPAIGN-ID を使用してください。 ホテル価格広告キャンペーンが属するサブアカウントの ID。 |
| USER-COUNTRY | ユーザーが配置されている国の 2 文字の国コード。 値は、エンド ユーザーのクライアント設定から抽出されます。 たとえば、米国などです。 |
| ユーザー通貨 | ユーザーが使用する現地通貨の 3 文字の通貨コード。 値は、エンド ユーザーのクライアント設定から推論されます。 たとえば、USD です。 |
| USER-DEVICE | エンド ユーザーのデバイスの種類。 使用可能な値は次のとおりです。
|
| USER-LANGUAGE | 広告の表示言語を指定する 2 文字の言語コード。 値は、エンド ユーザーのクライアント設定から推論されます。 たとえば、en です。 |
| 検証 | Bingがリンクを生成したかどうかを示すブール値。 リンクBing生成された場合、値は true です。 それ以外の場合は false。 |
CHECKINDAY などのすべての日付は、ホテルのタイムゾーンに含まれています。
動的クエリ パラメーターとエンコードされたエンティティを含む URL の例を次に示します。
<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)
&checkinYear=(CHECKINYEAR)&nights=(LENGTH)</URL>
Bing広告で URL を使用する前に、動的変数名の値に置き換えます。 たとえば、ユーザーがホテル #42 の 2021 年 6 月 7 日から 6 泊分の部屋を予約した場合、Bingは URL を次のようにレンダリングします。
http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6
Bingは、価格フィードとプロパティ フィードとユーザー固有の設定から動的パラメーターの値を取得します。 たとえば、LENGTH 変数の値は Price フィードの Nights 要素から取得され、PARTNER-HOTEL-ID 変数の値は Property フィードの id 要素から取得されます。
一部の変数は Price フィード要素のサブセットです。 たとえば、CHECKINDAY、CHECKINMONTH、CHECKINYEAR 変数は、 Checkin 要素から抽出されます。 その他の変数は、ユーザーのロケールやその他のクライアント設定に基づいて計算されます。
一般的な URL ルール
動的変数を使用する場合に従う一般的な規則を次に示します。
すべての動的パラメーターは省略可能です。 POS URL に動的パラメーターを挿入する必要はありません。 ただし、一般に、変数を使用してスケジュールとユーザー固有の情報を渡すと、エンド ユーザーのエクスペリエンスが向上します。
動的変数名を、かっこで囲んで囲みます。
特殊文字にはエンコードされたエンティティを使用します。 たとえば、アンパサンド (&) を &、スペースを %20、スラッシュ (/) を %2F に置き換えます。
1 つのパラメーターの値は、複数の変数から作成できます。 たとえば、CHECKINDAY、CHECKINMONTH、CHECKINYEAR 変数から checkinDate クエリ パラメーターの値を作成できます。
<URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>認識Bingがサポートされていない動的変数の場合、Bingは変数文字列を空の文字列に置き換えます。
動的クエリ パラメーターはクエリ パラメーターであるため、URL の疑問符記号 (?) に従う必要があります。
条件付きディレクティブの使用
上記の変数に加えて、次のディレクティブを使用して条件付きロジックを作成することもできます。
IF-DEFAULT-DATE - ユーザーが既定の日付を使用したホテル広告をクリックした場合に true に解決されます (ユーザーは日付を選択しませんでした)。 true の場合、Bingは、このディレクティブに続く値を URL に挿入します。 それ以外の場合、Bingは ELSE ディレクティブの後に値を挿入します。
ELSE — 前の条件が満たされていない場合、Bingはこのディレクティブに続く値を挿入します。
ENDIF - 条件付きブロックを終了します。
たとえば、次の URL は、ユーザーが日付を指定する代わりに既定の日付を使用した場合、popup_datepicker クエリ パラメーターを true に設定します。
<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&checkinDay=(CHECKINDAY)&checkinMonth=(CHECKINMONTH)&checkinYear=(CHECKINYEAR)
&nights=(LENGTH)(IF-DEFAULT-DATE)&popup_datepicker=true(ELSE)
&popup_datepicker=false(ENDIF)</URL>
true の場合、Bingは URL を次のようにレンダリングします。
http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true
それ以外の場合、Bing URL は次のようにレンダリングされます。
http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false
一般的な規則
PointsOfSale XSD を使用して、ランディング ページ フィード ファイルをBingに送信する前に検証します。
ランディング ページ フィード ドキュメントでは、UTF-8 エンコードを使用する必要があります。
フィードには、ユーザーが会議室の予約に使用するすべてのサイトのランディング ページが含まれている必要があります。フィード プロセスでは、部分的な更新はサポートされていません。
Bingは、サポートされていない要素または属性を無視します。
要素は、PointsOfSale XSD で指定された順序である必要があります。
データにアポストロフィや引用符などの特殊文字が含まれている場合は、それらをエスケープするか、CDATA セクションを使用します。 エスケープする場合は、エンティティ コードまたは文字コードを使用できます。 たとえば、パウロのをパウロ&asposとしてエスケープすることができます。s または Paul's.
データを含まない要素は含めないでください。 たとえば、ホテルの表示名を指定しない場合は、空の <DisplayNames> 要素を含めないでください。
XML 要素で HTML を使用しないでください。
次の手順
フィード ファイルを作成したら、 PointsOfSale XSD を使用して検証します。
アカウント マネージャーにフィード ファイルのインポートを依頼します。
ホテルのデータもインポートしてください。 プロパティ フィード ファイルの作成については、「プロパティ フィード」を参照してください。
ランディング ページ フィードとプロパティ フィードを正常にインポートした後、ホテルの価格と可用性データの送信を開始できます。 詳細については、「 価格フィード」を参照してください。