XML プロパティ フィード ファイルを作成する
注:
4月9日の時点で、ホテルセンターへのフルアクセスはできなくなります。 私たちは、エキサイティングなセルフサービス機能を提供するプロパティセンターをご紹介することを楽しみにしています。 新しい機能を使用してヘルプ コンテンツを更新するため、辛抱強くお待ちいただきありがとうございます。 それまでの間に、 これらの今後の変更と、移行プロセスをよりスムーズにする方法についてお読みください。
Microsoft にホテルの一覧を提供するには、アドバタイズする各ホテルの一覧を含む XML ドキュメントを作成します。 一覧には、ホテルの名前、住所、電話番号、地理的座標、アメニティなどが記載されています。
ドキュメントでは UTF-8 エンコードを使用する必要があり、 Hotel XSD に準拠している必要があります。
CSV または TSV ファイル形式を使用してフィード ファイルを作成する方法については、「 CSV プロパティ フィード ファイルの作成」を参照してください。
注:
Microsoft では、すべての XSD 要素がサポートされているわけではありません。 Microsoft は、ドキュメント内でサポートされていない要素または属性を無視します。 プロパティ フィード参照には、Microsoft がサポートする要素と属性のみが含まれています。
注:
このドキュメントでは、Hotel XSD で定義されている順序で要素を指定する必要があります (また、リファレンスに示すように)。
データを適切に取得する
Microsoft は、プロパティ フィード内のプロパティをBing地図の企業と照合するため、ホテルに関して提供するデータが正確かつ完全であることが重要です。
ホテルに情報が見つからない、または正しくない場合は、Microsoft が一致できない可能性があります。 Microsoft がホテルと一致できない場合、Microsoft はホテルを宣伝しません。 Microsoft が一致したホテルまたは一致しなかったホテルを示す照合レポートをホテル センターで表示できます。 Microsoft がホテルと一致しなかった場合、レポートには、 このホテルをBingのプロパティと照合できませんというメッセージが含まれます。 マッチレートの向上に役立つよう、Bingの場所で使用できることを確認してください。
フィードの最上位要素
プロパティ フィードには、最上位レベルの リスト要素が 1 つ含まれています。
listings要素には、languageとlistingという 2 つの必須の子要素が含まれています。
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<language>en</language>
<listing>
. . .
</listing>
...
</listings>
注:
現在、フィード データは英語でのみサポートされています。
language要素は、フィード内のデータが書き込まれる言語を指定します。 言語を指定するには、2 文字の ISO 639 言語コードを使用します。 たとえば、英語には en を使用します。
listing 要素には、名前、住所、電話番号など、ホテルに関する情報が含まれています。 一覧の定義については、「ホテルの一覧 の定義」を参照してください。
ホテル一覧の定義
listing要素は、ホテルを定義します。 アドバタイズするホテルごとに、 listing 要素を指定する必要があります。 次の例は、リストに指定する必要がある最小要素を示しています。 ただし、地理的な座標または電話番号を指定できます。 座標または電話番号を指定することもできますが、両方を指定して、Bing地図でプロパティが一致する可能性を高める必要があります。
<listing>
<id>abc123</id>
<name>Great Ambers Getaway</name>
<address>
<component name="addr1">1234 Porter Road</component>
<component name="city">Goldendale</component>
<component name="province">WA</component>
<component name="postal_code">98234</component>
</address>
<country>US</country>
<latitude>47.694351</latitude>
<longitude>-122.451782</longitude>
<phone type="main">123-456-7890</phone>
</listing>
id 要素の ID はユーザー定義であり、フィード内で一意である必要があります。
address要素の住所は、ホテルの番地です。 住所は、郵便局ではなく番地でなければなりません。 上記の例で示した component 要素を使用するか、次の例に示す自由形式の文字列を使用して、ホテルのアドレスを指定できます。 好みは、 component 要素を使用することです。
<address>1234 Porter Road, Goldendale, WA, 98234</address>
latitude要素と longitude 要素は、ホテルの地理的座標を指定します。
Location API などのジオコーディング API を使用して、番地から座標を生成します。
登録情報には、少なくともホテルのメイン電話番号を指定する必要があります。 メイン番号はフロントの電話番号であり、中央の予約電話番号ではありません。 連絡先の電話番号が多いほど、より適切に提供できます。 次の例は、他の電話オプションを示しています。
<phone type="main">123-456-7890</phone>
<phone type="tollfree">800-456-7890</phone>
<phone type="fax">123-456-7890</phone>
<phone type="tdd">123-456-7890</phone>
<phone type="mobile">123-456-7890</phone>
電話番号の指定の詳細については、 phone 要素に関するページを参照してください。
オプションのホテル一覧フィールドの指定
次の例は、リストに含めるオプションの要素を示しています。 省略可能ですが、現在および将来の使用シナリオをサポートするために、できるだけ多くの情報を含める必要があります。
<listing>
. . .
<category>hotel | inn</category>
<content>
<text type="description">
<body>This element contains the hotel's description.</body>
</text>
<review type="user">
<body>This element contains a review of the hotel.</body>
<date month="2" day="24" year="2018" />
<link>https://contoso.com/reviews/hotels?id=sd87s90</link>
<rating>8.5</rating>
</review>
<attributes>
<website>https://contoso.com</website>
<attr name="air_conditioned">Yes</attr>
<attr name="has_airport_shuttle">Yes</attr>
<attr name="parking_type">No payment required</attr>
</attributes>
<image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
<date month="3" day="3" year="2018" />
<link>https://contoso.com/...</link>
<title>Hotel entrance</title>
</image>
<neighborhoods>
<neighborhood>Sodo District</neighborhood>
</neighborhoods>
<brand>Contoso</brand>
</content>
</listing>
category要素の予期される形式は、vacation_rentalまたはホテルの後にパイプ文字とカスタム値が続きます。 たとえば、 vacation_rental |'カスタム値' または ホテル |'custom value'
カスタム値の一覧については、「 ロッジング プロパティ カテゴリ」を参照してください。
text要素には、ホテルの説明が含まれています。 実際の説明を含む body 要素を指定する必要があります。 説明の長さによっては、表示時に切り捨てられる場合があります。
link要素とtitle要素を含める場合、リンク URL はオンラインで説明を指します。
review要素には、ユーザー レビューまたは編集レビューが含まれます。 編集レビューは、旅行ブロガーなどのレビュー機関によって行われたプロのレビューです。 任意の数のレビューを含めることができますが、送信されたレビューの数によっては、すべて表示されない場合があります。 レビューを含む body 要素を指定する必要があります。 レビューの長さによっては、表示時に切り捨てられる場合があります。
link要素を含める場合は、オンラインでレビューの完全な一覧を指します。
attributes要素には、エアコン、スイミングプール、無料の朝食など、ホテルが提供する設備の一覧が含まれています。 使用可能なアメニティの一覧については、「 属性」を参照してください。 アメニティを指定しない場合は、ホテルが提供していないと見なされます。
image要素には、ホテルの画像が含まれています。 任意の数の画像を含めることができますが、送信されたイメージの数によっては、すべて表示されない場合があります。 推奨される縦横比は 4:3 で、最小幅は 720 ピクセルです。 画像は元の写真である必要があり、スクリーンショットではない可能性があります。
link URL には、AdIdxBot クローラーからアクセスできる必要があることに注意してください。 サイトに robots.txt ファイルが含まれている場合は、次のいずれかを含める必要があります。
- ユーザー エージェント: AdIdxBot
- 許す：/
neighborhood要素は、ホテルが配置されている近隣を識別します。 ホテルが複数の近隣に集中している場合は、複数の近隣を指定できます。
brand要素は、ホテルのブランドを識別します。 たとえば、Contoso がブランドである Fabrikam Residences by Contoso などです。
ホテルのコンテンツが変更された場合はどうなりますか?
フィード実行の間にホテルのプロパティ値を変更した場合 (名前、住所、電話など)、Microsoft Advertising はそれを新しいホテル プロパティとして扱い、新しいリストを作成する場合があります。 Microsoft が新しい一覧を作成した場合、以前のホテルの以前のパフォーマンス履歴は最大 36 か月間使用できます。 古いホテルの入札と乗数は、新しいホテルエンティティに譲渡されないことに注意してください。
ホテルを削除し、以前と同じプロパティ値を持つ後のフィードに追加すると、Microsoft はそれを新しい一覧として扱います。 また、パフォーマンス レポートには、2 つの個別の一覧として表示されます。
一般的な規則
Hotel XSD を使用して、プロパティ フィード ファイルを Microsoft に送信する前に検証します。
プロパティ フィード ドキュメントでは、UTF-8 エンコードを使用する必要があります。
フィードには、すべてのホテルの一覧が含まれている必要があります。フィード プロセスでは部分的な更新はサポートされていません。
Microsoft では、サポートされていない要素または属性は無視されます。
要素は、Hotel XSD で指定された順序で指定する必要があります。
データにアポストロフィや引用符などの特殊文字が含まれている場合は、それらをエスケープするか、CDATA セクションを使用します。 エスケープする場合は、エンティティ コードまたは文字コードを使用できます。 たとえば、パウロのをパウロ&asposとしてエスケープすることができます。s または Paul's.
データを含まない要素は含めないでください。 たとえば、ホテルの地理的座標を指定しない場合は、空の <latitude> および <longitude> 要素を含めないでください。
XML 要素で HTML を使用しないでください。
次の手順
フィード ファイルを作成したら、 Hotel XSD を使用して検証します。
アカウント マネージャーにフィード ファイルのインポートを依頼します。
ランディング ページのデータもインポートしてください。 ランディング ページ フィード ファイルの作成については、「 ランディング ページ フィード」を参照してください。
Microsoft がデータを正常にインポートし、ホテルとBing地図のプロパティを照合できたら、ホテルの価格と可用性データの送信を開始できます。 詳細については、「 価格フィード」を参照してください。