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 | ホテルの地理的座標の緯度。 注:
|
10 進数 | いいえ |
longitude | ホテルの地理的座標の経度。 注:
|
10 進数 | いいえ |
phone | ホテルへの連絡に使用するメイン音声電話番号。 番号はフロントの電話番号で、中央の予約電話番号ではありません。 注:
|
String | はい |
category | ホテルの種類を識別するカテゴリ。 予期される形式は 、vacation_rental または ホテル の後にパイプ文字とカスタム値が続きます。 たとえば、 vacation_rental |'カスタム値' または ホテル |'custom value' カスタム値の一覧については、「 ロッジング プロパティ カテゴリ」を参照してください。 |
String | いいえ |
hotel_brand | ホテルチェーンのブランド。 たとえば、Contoso がブランドである Fabrikam Residences by Contoso などです。 | String | いいえ |
star_rating | ホテルのstar評価。 使用可能な値は 1 から 5 です。 | String | いいえ |
注:
address
列とaddr
、addr2
、addr3
、city
、province
、および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地図のプロパティを照合できたら、ホテルの価格と可用性データの送信を開始できます。 詳細については、「 価格フィード」を参照してください。