ホテル広告 - 日付に基づく価格設定

静的ホテルフィードでは、ホテルごとに1つの料金を指定します。チェックイン日付、滞在期間、ルームタイプに基づいて異なる価格設定を指定することはできません。その変数に基づいてより正確な価格を広告に表示するには、動的(日付固有)価格設定を使用することにより、さまざまな日付、ルームタイプ、および滞在期間に応じた価格を指定することができます。それらを指定した後、ホテルテンプレートタグを使用することにより、広告でそれらの価格を使用できるようになります。

ルームタイプおよび価格設定データをバッチアップロードして、価格設定の詳細情報をFacebookとシェアしてください。

全パラメーターの説明については、ルームと価格設定のパラメーターをご覧ください。

ルームタイプおよび価格設定データのバッチアップロード

バッチアップロードは次の2つの部分で構成されています:

  1. ルームタイプのアップロード
  2. 価格設定のアップロード

バッチアップロードを使用する場合、ファイルあたりのアップロードサイズの上限は50MBで、ファイルあたりのアイテム数の上限は約50,000です。料金変数については、もっと小さいアップロードをより高い頻度で実行するようおすすめします。


ルームタイプのアップロード

ホテルルームバッチAPIを使用して、複数のルームタイプのファイルを1つ以上アップロードします。

:複数のルームタイプがない場合、このステップはスキップできます。

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

ルームタイプファイルの形式

ルームタイプは、XML形式で提供することができます。サンプルをご覧ください。

<PropertyDataSet> XMLノードの<property>で各ホテルを指定し、<RoomData>でルームタイプを指定します。ファイルの先頭に、<?xml宣言タグを記述する必要があります。

バッチAPIを使ったルームタイプのアップロードや削除については、「ホテルルーム、バッチリファレンス」をご覧ください。


価格設定のアップロード

料金変数バッチAPIを使用して、価格設定の詳細が含まれる1個以上のファイルをアップロードします。複数のルームタイプがある場合もない場合も、価格設定の詳細情報をアップロードできます。

: 客室数が非常に少ない場合は、ホテルルームAPIを使用してルームタイプを作成し価格設定することもできます。

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

価格設定ファイルの形式

ルームタイプをアップロードする前に、それらの客室のホテルがカタログ内にすでに存在していることを確認してください。指定できる料金変数の形式は、次のとおりです:

ファイル形式とサンプル説明

複数ルームタイプのXML | XMLサンプル

料金を指定するルームタイプがすでに存在することを確認してください。


チェックイン日付(<Checkin>)と滞在期間(<Nights>)の組み合わせに基づく、各ルームタイプ(<RoomBundle>)の価格設定(<Baserate>)を指定します。


ファイルの先頭に、<?xml宣言タグを記述する必要があります。

複数ルームタイプのないXML | XMLサンプル

ホテルID (<Property>)、チェックイン日付(<Checkin>)、滞在期間(<Nights>)の各組み合わせに対する価格設定(<Baserate>)を指定します。


ファイルの先頭に、<?xml宣言タグを記述する必要があります。

バッチ処理による料金変数のアップデートや削除の方法については、「料金変数バッチリファレンス」をご覧ください。

ルームと価格設定のパラメーター

フィールド名と型説明

Property

型: 文字列

必須。ホテルフィードのhotel_idとして広告主が指定する、ホテル固有の識別子。

RoomID

型: 文字列

必須。広告主が指定する、ルームタイプの一意の識別子。

Name

型: 文字列

必須。ホテルのルームタイプの名前。

Description

型: 文字列

必須。ホテルのルームタイプの説明。

BasePrice

型: 浮動小数点数

必須。ホテルルームの最低宿泊料金。通貨を含めてください。

例: 159 USD

URL

型: 文字列

ホテルのルームのページへのリンク。

CheckinDate

型: 日付

必須。priceに対応するチェックイン日。フィードがアップロードされた日付から180日間までサポートされています。ISO‑8601 (YYYY‑MM‑DD)を使用してください。

Nights

型: 整数

必須。priceに対応するホテル宿泊日数。最大値: 14

Baserate

型: 浮動小数点数

必須。checkin_datelength_of_stayに基づく価格。

例: 180

Tax

型: 浮動小数点数

必須。宿泊に対する課税額。

OtherFees

型: 浮動小数点数

必須。宿泊に適用されるサービス料。

SalePrice

型: 浮動小数点数

割引料金(該当する場合)。

例: 159

SalePriceTax

型: 浮動小数点数

割引料金に対する課税額。