Facebookでホテルインベントリーを宣伝するには、ホテルの情報をFacebookに提供する必要があります。提供するには、ホテルカタログを作成し、ホテルを入力します。カタログの情報を設定したり更新したりする方法として、次の2種類があります。
ホテルカタログは、コマースマネージャで作成、管理できます。
APIを使用してカタログを管理するには、次のようにします。
ホテルフィードとは、ホテルインベントリーを持つファイルです。ファイル内のラインまたはアイテムはそれぞれ、1つのホテルを表しています。すべてのフィードを合わせるとすべてのホテルインベントリーが格納される場合に限り、1つ以上のホテルフィードを使用できます。
CSVサンプル | TSVサンプル(フラット) | TSVサンプル(JSONスタイル)
"
"
)で囲む必要があります。 address
、neighborhood
、image
など)は、JSONエンコードされた値か、JSONパス構文を使用してラベリングされた「フラット」なプレーンテキスト列を使用して表されます(address.city
、neighborhood[0]
、image[0].url
、image[0].tag[0]
、image[0].tag[1]
など)。両方の表現方法を同じファイルで同時に使用できます。<listings>
XMLノードで囲まれる一連の<listing>
ノードの1つ1つが、それぞれ1つのホテルを表します。<?xml
宣言タグを置く必要があります。 フィード分析ツールは、テキストエンコーディングのUTF8
、UTF16
、UTF32
を自動検出し、予期せぬバイトシーケンスが発生した場合、デフォルトのLATIN1
にします。フィールド値には任意の言語でテキストを提供できますが、フィールド名は英語で、以下のものをそのまま使用する必要があります。
以下に示す対応フィールドは、商品カタログに追加するアイテムを対象として設計されています。
カタログのローカライゼーションについては、ホテル広告で利用できるフィールドをご覧ください。
フィールドと型 | 説明 |
---|---|
型: 文字列 | 必須。 最大長: 100 カタログ内で各ホテルを区別するための固有の識別情報です。このIDは、 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 ホテルの客室タイプに固有IDを入力します。最大文字数: 100 例: |
型: 文字列 | 必須。 最も一般的なホテルの呼称。 例: |
型: 文字列 | 必須。 最大サイズ: 5000 ホテルについての簡潔な説明。 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 ホテル滞在のためのチェックイン日付。フィードがアップロードされた日から最大180日分を追加できます。ISO-8601標準規格( 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 ホテル滞在の泊数。 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 ホテル客室1泊当たりの基本料金。料金には必ず通貨の種類を指定してください(例: 米国ドルの場合USD)。価格のフォーマットは、金額の後にスペースを1個空けてISO通貨コードを指定します。 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。
例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 料金に適用される税率。価格のフォーマットは、金額の後にスペースを1個空けてISO通貨コードを指定します。 例: |
型: 文字列 | ホテルの客室情報を追加する場合は必須。 価格に適用される手数料。価格のフォーマットは、金額の後にスペースを1個空けてISO通貨コードを指定します。 例: |
型: 文字列 | 必須。 ホテルの部屋を予約できる外部サイトへのリンク。URLは、 例: |
型: オブジェクト | 画像オブジェクトのパラメーターをご覧ください。 |
型: オブジェクト | 画像オブジェクトのパラメーターをご覧ください。 |
型: 文字列 | 必須。 ホテルチェーンのブランド名。 例: |
型: オブジェクト | 住所オブジェクトのパラメーターをご覧ください。 |
型: 文字列 | 必須。 地域の最大数: 20 ホテル所在地の地域。地域が複数ある場合は、地域ごとにカラムを追加し、各カラム名にJSONパス構文を使用して、地域の数を指定します。 例: |
型: 浮動小数 | 必須。 ホテル所在地の緯度。 例: |
型: 浮動小数 | 必須。 ホテル所在地の経度。 例: |
型: 文字列 | 任意。
例: |
型: オブジェクト | ゲスト評価オブジェクトのパラメーターをご覧ください。 |
型: オブジェクト | ゲスト評価オブジェクトのパラメーターをご覧ください。 |
型: 浮動小数 | ゲスト評価オブジェクトのパラメーターをご覧ください。 |
型: 文字列 | 任意。 ホテル滞在によるポイント獲得のために使用するロイヤルティプログラム。 例: |
型: 整数 | 任意。 ホテルの収益性を示す指標。値の範囲は1から10まで。 例: |
型: 文字列 | 任意。 ホテルのメイン電話番号。 例: |
型: オブジェクト | 任意。 App Linksを使用して、モバイルアプリ内のホテルの詳細ページに直接遷移するディープリンク。次のようにディープリンクを指定できます(優先順位の高い順)。
製品ディープリンクについて、詳細をご確認ください。 |
型: 整数 | 任意。 ホテルの優先度の指標。値は0(優先度最低)から5(優先度最高)まで。例: |
型: 文字列 | 任意。 プロパティのタイプ。カテゴリとしては内部説明の任意のタイプが可能です。例: |
型: 整数 | 任意。 このホテルリストに含まれるルーム/ユニットの合計数。 例: |
型: 文字列 | カタログのアイテムがアクティブなのかアーカイブ済みなのかを制御します。アクティブなアイテムだけが、広告、ショップ、その他のチャネルで表示されます。使用できる値: 例: 注: Shopifyなど一部のパートナープラットフォームでは、stagingというステータスを使用して、アイテムをカタログに同期することがあります。これは、 以前、このフィールドは |
型: 文字列 | 最大文字数:100 セットを作成するときにアイテムを絞り込む条件に指定する追加情報用のカスタムフィールド(最大5つ)です。例えば、カスタムフィールドを使用して、夏のセールで扱う全客室を指定してから、セットに絞り込むことができます。このフィールドは、数字を含むすべてのテキスト値をサポートします。 例: このフィールドは補足フィードでサポートされています。 |
型: 整数 | 追加の数字関連の情報用のカスタムフィールド(最大5つ)です。セットを作成する場合にアイテムを絞り込む条件として利用します。このフィールドを使って、セットを作成するときに数字の範囲(次より大きいおよび次より小さい)を指定して絞り込むことができます。例えば、このフィールドを使ってホテルが営業を開始した年を示し、特定の年範囲にセットを絞り込むことができます。 このフィールドには、0~4294967295の整数を入力できます。-2、5.5、10,000など、負の数、小数、コンマは使用できません。 例: |
フィールド名と型 | 説明 |
---|---|
型: 文字列 | 必須。 最大アイテム数: 20。 広告に表示するアイテムの画像へのURLリンク。下記の画像仕様に従ってください。
例: 例: |
型: 文字列 | 任意。 画像の内容を示すために画像に付加されるタグ。1枚の画像に複数のタグを付けることもできます。 例:
|
address
などのネストされたフィールドや複数値フィールドは、JSONエンコード値、またはJSONパス構文を使ってラベリングされた「フラット」なプレーンテキスト列を使用して表されます(例: address.region
)。両方の表現方法を同じファイルで同時に使用できます。
フィールド名と型 | 説明 |
---|---|
型: オブジェクト | 必須。 ホテルの住所の主要部分。 例: |
型: オブジェクト | 任意。 ホテルの住所の2番目の部分。 例: |
型: オブジェクト | 任意。 ホテルの住所の3番目の部分。 例: |
型: 文字列 | 任意。 広告クリエイティブのディープリンクURL( 例: |
型: 文字列 | 必須。 ホテルの所在地の市区町村。 例: |
型: 文字列 | 必須。 ホテルの所在地の都道府県、州、郡、地域。 例: |
型: 文字列 | 必須。 ホテルの所在地の国。 例: |
型: 文字列 | 郵便番号のシステムがある国の場合、必須。 ホテルの所在地の郵便番号。 例: |
フィールド名と型 | 説明 |
---|---|
型: オブジェクト | 任意。 ホテルのレビューをした人の合計数。これを指定した場合、 例: |
| 任意。 このホテルを評価した人の合計数。 例: |
型: 文字列 | 任意。 ゲストレビューアーのために使用するシステム。 例: |
型: 整数 | 必須。 ホテルの評価スコアの最大値です。0以上100以下でなければなりません。 例: |
ホテルAPIを使用することにより、カタログ内のホテルを直接追加、編集、削除できます。APIを使用してホテルを管理する方法について詳しくは、ホテルAPIリファレンスをご覧ください。
以下のセクションは、このAPIを使用してカタログを管理する場合のみ、使用します。
ホテルカタログはホテルインベントリーのコンテナです。カタログAPIを使用するには、適切なマーケティングAPIアクセスレベルを持っていること、およびビジネスマネージャで最初のカタログを作成することにより利用規約に同意していることを確認してください。
ホテル広告用のホテルカタログを作成するには、vertical
をhotels
に設定します。
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
カタログを作成したら、次はホテルフィードをFacebookにアップロードする必要があります。APIを使用して、アップロードする各フィードのフィードオブジェクトを作成します。Metaでは、日付を指定したアップロードと直接アップロードをサポートしています。
ホテルセットはカタログのサブセットです。ホテルの広告を設定するには、ホテルセットが必要です。そのため、少なくとも1つのホテルセットを作成する必要があります。
ホテルセットは、ホテルカタログに適用されるフィルターで定義します。例えば、star_rating
が3より大きいすべてのホテルを含むホテルセットを作成できます。注: フィルターを使用せずにホテルセットを作成することもできます。この場合、ホテルセットにはカタログ内のすべてのホテルが含まれます。
brand
フィールドで「サンプルブランド」に言及されているすべてのホテルを含むホテルセットを作成するには、次のようにします。
curl -X POST \
-F 'name="Test Hotel Set"' \
-F 'filter={
"brand": {
"i_contains": "sample brand"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
filter
パラメーターは、次の演算子とデータで構成されます。
演算子 | フィルターのタイプ |
---|---|
| サブ文字列を含む。大文字と小文字を区別しない。 |
| サブ文字列を含まない。大文字と小文字を区別しない。 |
| サブ文字列を含む。大文字と小文字を区別しない。 |
| サブ文字列を含まない。大文字と小文字を区別しない。 |
| 次に等しい。大文字と小文字を区別しない。 |
| 次と等しくない。大文字と小文字を区別しない。 |
| 次より小さい。数値フィールドのみ。 |
| 次以下。数値フィールドのみ。 |
| 次より大きい。数値フィールドのみ。 |
| 次以上。数値フィールドのみ。 |
データ | フィルター処理されるデータ。 |
---|---|
| カタログ内で各ホテルを区別するための固有の識別情報です。 |
| ホテルチェーンのブランド名です。 |
| このホテルの1泊の基準価格。価格の単位はセントです(4,999は$49.99です)。 |
| このホテルの1泊の販売価格です。価格の単位はセントです(4,999は$49.99です)。 |
| 通貨 |
| ホテルが所在する市区町村です。 |
| ホテルが所在する国です。 |
| 各ホテルに通常使用される名前です。 |
| ホテルのスター評価です。有効値は1~5で、0.5の倍数である必要があります。 |