スクリプトタグをウェブサイトに正常に追加した後(「Knowledge Tagsをウェブサイトに追加」を参照)、埋め込みコードを使用してお客様向けコンテンツをページに追加できます。これにより、Yextに保存されているエンティティのコンテンツをウェブサイトに表示することができます。つまり、エンティティのコンテンツを更新すると、それが自動的にウェブサイトに反映されます。
注意:埋め込みコードを利用してコンテンツを追加する前に、ページに<script>
タグを追加する必要があります。
お客様向けコンテンツをサイトに追加するには:
- ナビゲーションバーにある[ページ]をクリックし、[Knowledge Tags]をクリックします。
- [Knowledge Tagsをウェブサイトに追加(Add Knowledge Tags to Website)]ボタンをクリックします。
- [エンティティを選択(Select Entity)]ボタンをクリックし、お望みのエンティティを選択します。
- 該当する場合には希望するロケールを選択します。
- 該当する場合はご希望のAnalyticsの設定を選択してください。
- Yext Knowledge Graphを使用したフィールドの埋め込みコードを取得します。追加のエンティティフィールドを表示するには、[More Fields(追加のフィールド)]リンクをクリックします。
- ウェブサイト上で表示したい場所に埋め込みコードを追加します。
例
次の埋め込みタグを使用すると、Yext エンティティのコンテンツをウェブページに直接表示できます。
<span data-yext-field="name"></span>
Yextからフィールドを選択するには、 data-yext-field
の値を表示したいフィールドのAPI名に変えます。上記の例では、「Name」フィールドを表示しています。エンティティフィールドのAPI 名を見つけるには、「フィールドのAPI名を表示する」を参照してください。
複数のエンティティを持つページ
ページに複数のエンティティのコンテンツが表示される場合は、埋め込みコードに、どのエンティティのデータをタグで使用するかを指定するdata-yext-id
プロパティも含まれていることを確認してください。例:
ページに複数のエンティティのコンテンツが表示される場合は、埋め込みコードに、どのエンティティのデータをタグで使用するかを指定するdata-yext-id
プロパティも含まれていることを確認してください。例:
- ページが1つのエンティティ用である場合、住所コードは次のようになります。
<span data-yext-field="address.line1"></span>
- ページに複数の住所フィールドが表示される場合、各住所の住所コードは次のようになります。
<span data-yext-field="address.line1"data-yext-id="815"></span>
複数のエンティティからデータを取得するには、Knowledge Tagリクエストの各エンティティにentity_idパラメータを含める必要があります(例: entity_id=example1&entity_id=example2
)。
カスタムフィールド
カスタムフィールドに保存されているコンテンツをページに表示するには、次の形式で埋め込みコードを作成します。
<span data-yext-field="c_myCustomField"></span>
ここで、c_myCustomField
はカスタムフィールドのAPI名であり、HTMLタグ(この例では <span>
)はフィールドタイプによって異なります。
リストフィールド
ページにリストタイプのフィールドを表示するには、次のHTML tagのいずれかを使用して、ページのリストフィールドタイプのコンテンツを表示できます。
-
<ul>
— 箇条書きリスト -
<ol>
— 番号付きリスト -
<span>
— カンマで区切られた1行のリスト -
<div>
— 一連の<div>
要素がそれぞれ別の行に配置されます
たとえば、製品の箇条書きリストを表示するには、次の埋め込みタグを使用します。
<ul data-yext-field=”products”></ul>
リストを含むカスタムフィールドを表示するには、次の手順を使用します。
<ul data-yext-field="c_listField"></ul>
その他のフィールド
以下は、ページにコンテンツを埋め込むために使用できるフィールドのリストです。Knowledge Tagsが特定のフォーマットでデータを返すため、これらのフィールドは強調表示されています。
フィールド名 | 埋め込みタグ | 表示 |
---|---|---|
営業時間(曜日を含む) | <span data-yext-field="hours"></span> |
月曜日 12:00pm - 11:00pm |
営業時間 | <span data-yext-field="hours-monday"></span> |
12:00pm - 11:00pm |
休日営業時間 | <span data-yext-field="holidayHoursFormatted"></span> |
2020年7月2日(土)休業 |
住所 | <span data-yext-field="address.line1"></span> |
61 9th Avenue |
提供する食事(リストオプション) | <span data-yext-field="mealsServed" <span> |
選択オプションのリスト(例:朝食、ランチ、ブランチ、ディナー、ハッピーアワー、深夜) |
提供する食事 | <span data-yext-field="mealsServed[0]"><span> |
特定のオプション(例:朝食) |
Eメール | info@contact.com | |
道案内リンクを取得 |
|
道案内を取得(リンクはその住所をターゲットにしたGoogleマップを開きます) |
ロゴ | <img data-yext-field="logo.url"> |
![]() |
Google属性 | <span data-yext-field="googleAttributesFormatted"></span> |
カンマで区切られた関連属性のリスト(例:女性が所有している、オンラインクラスを提供している) |
イベントの開始日と時刻 | <div data-yext-field="start-datetime"</div> |
2022年10月5日 1:00:00 PM |
イベント終了日と時間 | <div data-yext-field="start-datetime"</div> |
2022年10月5日 4:00:00 PM |
その他のエンティティデータの命名とフォーマットの完全なリストについては、 Content Delivery API Documentation をご覧ください。