静的ホテルフィードでは、ホテルごとに1つの料金を指定します。チェックイン日付、滞在期間、ルームタイプに基づいて異なる価格設定を指定することはできません。その変数に基づいてより正確な価格を広告に表示するには、動的(日付固有)価格設定を使用することにより、さまざまな日付、ルームタイプ、および滞在期間に応じた価格を指定することができます。それらを指定した後、ホテルテンプレートタグを使用することにより、広告でそれらの価格を使用できるようになります。
ルームタイプおよび価格設定データをバッチアップロードして、価格設定の詳細情報をFacebookとシェアしてください。
全パラメーターの説明については、ルームと価格設定のパラメーターをご覧ください。
バッチアップロードは次の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サンプル | 料金を指定するルームタイプがすでに存在することを確認してください。 チェックイン日付( ファイルの先頭に、 |
複数ルームタイプのないXML | XMLサンプル | ホテルID ( ファイルの先頭に、 |
バッチ処理による料金変数のアップデートや削除の方法については、「料金変数バッチリファレンス」をご覧ください。
フィールド名と型 | 説明 |
---|---|
型: 文字列 | 必須。ホテルフィードの |
型: 文字列 | 必須。広告主が指定する、ルームタイプの一意の識別子。 |
型: 文字列 | 必須。ホテルのルームタイプの名前。 |
型: 文字列 | 必須。ホテルのルームタイプの説明。 |
型: 浮動小数点数 | 必須。ホテルルームの最低宿泊料金。通貨を含めてください。 例: |
型: 文字列 | ホテルのルームのページへのリンク。 |
型: 日付 | 必須。 |
型: 整数 | 必須。 |
型: 浮動小数点数 | 必須。 例: |
型: 浮動小数点数 | 必須。宿泊に対する課税額。 |
型: 浮動小数点数 | 必須。宿泊に適用されるサービス料。 |
型: 浮動小数点数 | 割引料金(該当する場合)。 例: |
型: 浮動小数点数 | 割引料金に対する課税額。 |