エンティティのアップロードテンプレートの詳細 – Yext Help

エンティティアップロードツールを使用すると、スプレッドシートをアップロードしてアカウントにエンティティを一括で更新・追加できます。この記事では、データファイルのアップロード時に含めることができるすべてのフィールドについて詳しく説明します。

以下の目的のエンティティをクリックして、特定のエンティティテンプレートの詳細に移動します。

ロケーションテンプレート
イベントテンプレート

ロケーションテンプレート：

タブ1：ロケーションデータのアップロードテンプレート
- サンプルテンプレート。この情報はエンティティ情報で上書きできます。
タブ2：ロケーションデータフィールドの説明
- 各フィールドの説明と入力例、必須か否かの説明。
タブ3： 14フィールドの営業時間形式
- 14列の営業時間形式のテンプレート。曜日ごとに開店時刻と閉店時刻を示す個別の列が含まれます。

注：この表では、米国を拠点とする企業のロケーションエンティティタイプのフィールドの概要を示しています。他のロケールのテンプレートは異なる場合があります。

Knowledge Graphのフィールド名	フィールド名：マッピング規則	要否	追加情報
エンティティタイプ	エンティティタイプ	必須
エンティティID	エンティティID	必須
名前	名前	必須
住所	住所 > 1行目	必須	番地を含める必要があります
階、部屋番号、ユニット	住所 > 2行目		住所の2行目（例：部屋番号など）
町名	住所 > 町名		（任意）一部の国では地域、区、郡などが表示されます
市	住所 > 都市	必須
州	住所 > 地域	必須
郵便番号	住所 > 郵便番号	必須
国	国/地域	必須	国はISO標準略称形式で表記します
緯度	表示用緯度/経度 > 緯度
経度	表示用緯度/経度 > 経度
メイン電話番号	メイン電話番号 > 電話番号	推奨
Featured Message	Featured Message > 説明	推奨	コンテンツは対象国の現地言語で提供する必要があります
Featured Message URL	Featured Message > URL	推奨	URLはhttps://形式とする必要があります
メインウェブサイト	ウェブサイトURL > URL	必須	URLはhttps://形式とする必要があります。トラッキングURLに対応しています。ウェブサイトURLに追加してください。
説明	説明	推奨	コンテンツは対象国の現地言語で提供する必要があります
営業時間	営業時間 > 月曜日営業時間 > 火曜日営業時間 > 水曜日営業時間 > 木曜日営業時間 > 金曜日営業時間 > 土曜日営業時間 > 日曜日	推奨	7または14フィールドの形式（月曜日 9am-5pm または月曜日開店 9:00am, 月曜日閉店 5:00pm）が使用できます。指定できる時間形式の例：5:00pm、5:00 PM、05:00pm、17:00、1700。24時間営業の場合には、"24hr"、"24時間"、"12:00am-12:00am"のいずれかとします。休業の場合には、"休業"または"x"とします。時間を分けた営業の場合には、コンマで区切って時間帯を入力します（例：8:00am-11:30am、1:00pm-5:30pm）。
カテゴリ	カテゴリ	推奨	カテゴリー名をカンマで区切った優先順位順のリスト。
事業ロゴ	ロゴ > URL	推奨	写真はURLとしてアップロードする必要があります。画像は、画像ガイドライン（jpg、gif、png形式のいずれかで、最大400x400、250kb）を満たす必要があります。
写真ギャラリー	写真ギャラリー > URL	推奨	写真はURLとしてアップロードする必要があります。複数の画像をアップロードするには、URLをコンマで区切ります。画像は、画像ガイドライン（jpg、gif、png形式のいずれかで、最大1025x768、500kb）を満たす必要があります。
ビデオ	ビデオ > URL	推奨	事業を紹介するYouTubeビデオ（チャンネルのURLではなく単一の動画のURL）
支払いオプション	支払いオプション		事業で対応する支払方法（カンマ区切り）
ブランド	ブランド		事業が販売するブランド
製品	製品		事業が提供する製品
サービス	サービス		事業が対応するサービス
スペシャリティ	スペシャリティ		事業に関して強調したい特別なアイテムやサービス
キーワード	キーワード		事業に関連または事業の説明に使用されるキーワード
言語	言語		ロケーションで話される言語
関連	関連		事業が関連付けられている組織
設立年	設立年		ロケーションの設立年（4桁）
twitter	Twitterハンドル名		事業のTwitterハンドル名
FacebookページURL	FacebookページURL		FacebookページのURL

イベントテンプレート：

タブ1：イベントデータのアップロードテンプレート

サンプルテンプレート。この情報はエンティティ情報で上書きできます。

タブ2：イベントデータフィールドの説明

各フィールドの説明と入力例、必須か否かの説明。

タブ3：カテゴリー

サポートイベントカテゴリーのリスト。

イベントのロケーションのオプション

イベントを追加する際、テンプレートの一部のセクション（列O～V）にはイベントのタイプに応じて異なる方法で入力します。イベントのタイプ別の手順は以下を参照してください。

Knowledge Graphに保存されているロケーションの1つでイベントが行われる場合
- [リンクされたロケーション > エンティティID]フィールドに関連するロケーションのエンティティIDの入力が必要となります。
- このセクションの残りのフィールド（列P～V）は空白のままとなります。
Knowledge Graphに保存されていないロケーションでイベントが行われる場合
- 以下のフィールドに入力する必要があります。
  - 施設名
  - 住所 > 住所1
  - 住所 > 住所2
  - 住所 > 都市
  - 住所 > 州
  - 住所 > 郵便番号
- このセクションの残りのフィールド（列Oと列V）は空白のままとなります。
イベントが特定のロケーションで行われない場合
- イベントのタイムゾーンを入力する必要があります。
- このセクションの残りのフィールド（列O～U）は空白のままとなります。

Knowledge Graphのフィールド名	フィールド名：マッピング規則	要否	追加情報
エンティティタイプ	エンティティタイプ	必須
エンティティID	エンティティID	必須
名前	名前	必須
カテゴリ	カテゴリ	必須	カテゴリー名をカンマで区切ったリスト。カテゴリーはアップロードテンプレートの3番目のタブのリストから取得できます。
日付/時間	日付/時間 > 開始 > 日付	必須	指定できる日付形式の例：DD/MM/YY または DD/MM/YYYY
日付/時間	日付/時間 > 開始 > 時間	必須	指定できる時間形式の例：5:00pm、5:00 PM、05:00pm、17:00、1700。
日付/時間	日付/時間 > 終了 > 日付	必須	指定できる日付形式の例：DD/MM/YY または DD/MM/YYYY
日付/時間	日付/時間 > 終了 > 時間	必須	指定できる時間形式の例：5:00pm、5:00 PM、05:00pm、17:00、1700。
無料イベント	無料イベント	必須	指定できるオプション：「はい」または「いいえ」
チケットが発行されたイベント	チケットが発行されたイベント	必須	指定できるオプション：「はい」または「いいえ」
イベントのステータス	イベントのステータス	必須	指定できるステータス：スケジュール済み、リスケジュール、延期、キャンセル済み。
説明	説明	必須
オーガナイザー名	オーガナイザー名	必須
国/地域	国/地域	必須	国はISO標準略称形式で表記します。

リンクされたロケーション > エンティティID	ロケーションID	必須（イベントのタイプに基づく）	これは、このイベントが開催されるYextロケーションのロケーションIDとなります。
施設名	施設名	必須（イベントのタイプに基づく）	イベントが行われる会場の名前。
住所	住所 > 住所1	必須（イベントのタイプに基づく）	番地を含める必要があります。
階、部屋番号、ユニット	住所 > 住所2	必須（イベントのタイプに基づく）	住所の2行目（例：部屋番号など）
市	住所 > 都市	必須（イベントのタイプに基づく）
州	住所 > 州	必須（イベントのタイプに基づく）
郵便番号	住所 > 郵便番号	必須（イベントのタイプに基づく）
タイムゾーン	タイムゾーン	必須（イベントのタイプに基づく）

ウェブサイト	ウェブサイトURL > URL	推奨	イベントページや詳細情報を含むウェブサイトへのリンク。
写真ギャラリー	写真ギャラリー > URL	推奨	Eventbriteでの表示を最適化するには、アスペクト比2:1の写真をお勧めします。 BoxまたはGoogleドライブのリンクはサポートされていません。複数の写真をアップロードする場合は、最初の写真がプライマリ画像として使用されます。
オーガナイザーEメール	オーガナイザーEメール	推奨
オーガナイザーの電話番号	主催者の電話番号 > 電話番号	推奨
チケットURL	チケットURL	推奨	チケットの購入用リンク（チケットを発券するチケットの場合）。