次の方法で共有


CSV プロパティ フィード ファイルを作成する

Microsoft にホテルの一覧を提供するには、アドバタイズする各ホテルの一覧を含む CSV ファイルを作成します。 一覧には、ホテルの名前、住所、電話番号、地理的座標が記載されています。

XML ドキュメントを使用したフィード ファイルの作成については、「 XML プロパティ フィード ファイルの作成」を参照してください。

注:

プロパティ フィードでは、ローカル言語がサポートされています。

CSV 形式では、イメージはサポートされていません。 代わりに XML 形式を使用します。

データを適切に取得する

Microsoft は、プロパティ フィード内のプロパティをBing地図の企業と照合するため、ホテルに関して提供するデータが正確かつ完全であることが重要です。

ホテルに情報が見つからない、または正しくない場合は、Microsoft が一致できない可能性があります。 Microsoft がホテルと一致できない場合、Microsoft はホテルを宣伝しません。 TAM がプロパティ フィード ファイルをインポートすると、Microsoft が一致したホテルまたは一致しなかったホテルを示すレポートが送信されます。 Microsoft がホテルと一致しなかった場合、レポートには、 このホテルをBingのプロパティと照合できませんというメッセージが含まれます。 一致率の向上に役立つ場合は、TAM に問い合わせてください。

ホテル一覧の定義

フィード ファイルの最初の行はヘッダー行で、フィード内のホテル データの列名が含まれます。 ヘッダーには、必要なすべてのデータ要素の列名を含める必要があります。 オプションの列の名前は、データを指定する場合にのみ含めます。

フィードに含める可能性がある列の一覧を次に示します。 フィード ファイルには任意の順序で列を含め、列名では大文字と小文字が区別されません。

列名 説明 データ型 必須
id フィード内のホテルを一意に識別する不透明なユーザー定義 ID。

Price フィードを作成するときは、Price フィードの Property 要素でこの ID を使用してホテルを識別します。
String はい
name ホテルの名前。 名前には、最大 200 文字を含める場合があります。 String はい
address 自由形式のテキストを使用したホテルの番地。 アドレスの各コンポーネントをコンマで区切り、アドレスを引用符で囲みます。 たとえば、「1234 Billings Way、Redmond、WA、98030」などです。

この列は、自由形式のテキストを使用してアドレスを指定する場合にのみ使用します。それ以外の場合は、addr1、city、province などのアドレス コンポーネント列を使用します。 自由形式のテキストを使用する代わりに、アドレス コンポーネント列を使用することをお勧めします。
String はい
addr1 ホテルの番地。 たとえば、1234 Billings Way などです。 住所は物理的な住所で、郵便局やその他の郵送専用住所ではありません。 String はい
addr2 2 番目の番地の住所行。 String いいえ
addr3 3 番目の番地の住所行。 String いいえ
city ホテルがある都市の名前。 String はい
ホテルがある州、地域、または都道府県の名前。 String はい
postal_code 住所の郵便番号。 String はい
country ホテルがある国または地域。 2 文字の ISO 3116 国コードを使用して、国または地域を指定します。 たとえば、米国には US を使用します。 String はい
latitude ホテルの地理的座標の緯度。

注:
  • 緯度と経度は、 phoneを指定しない場合にのみ必要です。 電話と地理的な座標の両方を指定することをお勧めします。
  • 緯度は、-90.0 ~ 90.0 の範囲である必要があります。
  • Location API または別の GeoCoding ツールを使用して、番地から座標を生成します。
10 進数 いいえ
longitude ホテルの地理的座標の経度。

注:
  • 緯度と経度は、 phoneを指定しない場合にのみ必要です。 電話と地理的な座標の両方を指定することをお勧めします。
  • 経度は-180.0 ~ 180.0 の範囲である必要があります。
  • Location API または別の GeoCoding ツールを使用して、番地から座標を生成します。
10 進数 いいえ
phone ホテルへの連絡に使用するメイン音声電話番号。 番号はフロントの電話番号で、中央の予約電話番号ではありません。

注:
  • 読みやすくするために、電話番号にダッシュ、スペース、またはかっこを使用します。 たとえば、"6102223333" ではなく "610-222-3333" または "(610) 222-3333" を使用します。
  • 電話番号を 1 つだけ指定します。650-123-2222/33 など、複数の数値を指定しないでください。
  • 電話番号には、最大 7 桁の延長が含まれている場合があります。 拡張機能の前に、"ext"、"extn"、および "x" のいずれかの省略形を指定します。 たとえば、"408-555-1111x12345" や "408-555-1111 x12345" などです。
  • 電話番号にアルファベット文字を含めないようにしてください。
  • 電話番号に国番号が含まれている場合は、その前に "+" を付けます。 たとえば、国コードが 65 のシンガポールの数値の場合は "+65 6722-2323"、国コードが 001 である米国の数値の場合は "+001 (408) 555-1111" などです。
String はい
category ホテルの種類を識別するカテゴリ。 予期される形式は 、vacation_rental または ホテル の後にパイプ文字とカスタム値が続きます。 たとえば、 vacation_rental |'カスタム値' または ホテル |'custom value'

カスタム値の一覧については、「 ロッジング プロパティ カテゴリ」を参照してください。
String いいえ
hotel_brand ホテルチェーンのブランド。 たとえば、Contoso がブランドである Fabrikam Residences by Contoso などです。 String いいえ
star_rating ホテルのstar評価。 使用可能な値は 1 から 5 です。 String いいえ

注:

address列とaddraddr2addr3cityprovince、およびpostal_code列は相互に排他的です。 address列またはアドレス コンポーネント列のいずれかを指定します。 アドレス コンポーネント列を指定することをお勧めします。

地理的座標または電話番号を指定することもできますが、両方を指定して、Bing地図でプロパティが一致する可能性を高める必要があります。

リストの説明、画像、レビューを含めるには、XML フィード ファイルを使用します。 「 XML プロパティ フィード ファイルを作成する」を参照してください。

CSV 形式のヘッダーの例を次に示します。 すべての列をコンマで区切ります。 少なくとも 1 つのホテルの値を含む列のみを含めます。

id,name,addr1,city,province,postal_code,country,phone

ヘッダー行の後に、アドバタイズする各ホテルの行を含めます。 フィードには、すべてのホテルの一覧が含まれている必要があります。フィード プロセスでは部分的な更新はサポートされていません。 フィードに空白行を含めないでください。

値にコンマが含まれている場合は、値を引用符で囲む必要があります。 CSV ファイルの例の内容を次に示します。

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

ホテルのコンテンツが変更された場合はどうなりますか?

フィード実行の間にホテルのプロパティ値を変更した場合 (名前、住所、電話など)、Microsoft Advertising はそれを新しいホテル プロパティとして扱い、新しいリストを作成する場合があります。 Microsoft が新しい一覧を作成した場合、以前のホテルの以前のパフォーマンス履歴は最大 36 か月間使用できます。 古いホテルの入札と乗数は、新しいホテルエンティティに譲渡されないことに注意してください。

ホテルを削除し、以前と同じプロパティ値を持つ後のフィードに追加すると、Microsoft はそれを新しい一覧として扱います。 また、パフォーマンス レポートには、2 つの個別の一覧として表示されます。

次の手順

アカウント マネージャーにフィード ファイルのインポートを依頼します。

ランディング ページのデータもインポートしてください。 ランディング ページ フィード ファイルの作成については、「 ランディング ページ フィード」を参照してください。

Microsoft がデータを正常にインポートし、ホテルとBing地図のプロパティを照合できたら、ホテルの価格と可用性データの送信を開始できます。 詳細については、「 価格フィード」を参照してください。