We’ve migrated our documentation to a new site, which means some URLs have changed.
Audience

タクソノミ設定手順

概要

Piano Insightをご利用中のお客様はWebページコンテンツの処理にPiano Insightの標準タクソノミ 及び 任意の数のカスタムタクソノミを適用することができます。コンテンツ処理にいくつかのタクソノミを適用する目的は各ユーザーの関心事項の識別を改善するためです。正しく適用されると、ユーザーは短期的、長期的な関心事項にマッチするキーワードでタグ付けされるようになります。

タクソノミはキーと値の組み合わせを割り当てたものです。キーは例えば Toyotaspaghetti bolognese のようなドキュメント上(Webページ上)で見られる言葉で、値はその2つの例を補完するような motor/cars/toyota や food/pasta といったドキュメントでタグ付けするのに使うタクソノミのパスです。例えば、 食べ物/パスタ でタグ付けされたドキュメントを読んだユーザーはそうした情報が追加されたタグを持つことになります。Piano Insightの標準タクソノミに全てのパスのリストはこちらで確認できます。

タクソノミのキーと値の組み合わせは Excelファイルまたは JSON形式で辞書を保持しています。任意のカスタム辞書(タクソノミまたは言語)の管理と更新の実用性については辞書管理チュートリアルで説明されています。お客様はCxenseの標準タクソノミを利用することもできますし(その場合何もする必要はありません)、それに加えてあるいは代わりに、メンテナンスが必要になるカスタムタクソノミを利用することもできます。

2016年8月時点で、Piano Insightの標準タクソノミは以下の言語で提供されています:デンマーク語、英語、フィンランド語、インドネシア語、ノルウェー語、ロシア語、スペイン語、スウェーデン語
Piano Insightの標準タクソノミを有効にして、ドキュメントで検出された言語がサポートされている言語に含まれていない場合、タクソノミのタグ付けは行われません。

注意:URLベースのタギングとタクソノミを混同しないでください

コンテンツプロファイルには2つのフィールドがあり、タクソノミを持つことなく、タクソノミと何か関係があるため、混乱しかねません。

  • taxonomy - Piano Insight が各々のWebページをトラッキングするために作成、保持するタクソノミのフィールドは従来のタクソノミとは何も関係がありません。タクソノミのフィールドの値はページURLのパスです。したがって、  http://server.domain/sports/football/some-football-page.html のURLのWebページはsports/football を保持しています。これはタクソノミのパスのように見え、多くの場合でタクソノミのパスのように素晴らしい仕事をしてくれそうですが、実際にはそうではありません。単純にURLパスの一部です。

  • category - カテゴリのフィールドはデフォルトでいわゆるタクソノミフィールドの全てのパスの一部を含んでいます。したがって、上の例のような特定のケースでは、カテゴリのフィールドはsports  のリストが保持されています。 

実際にタクソノミのパスが保持されるフィールドは xyz-categories です( xyzはカスタマープリフィックスのプレースホルダです)。

タクソノミ機能の動作の仕組み

以下の図ではタクソノミの機能が標準タクソノミまたはカスタムタクソノミであるかどうかでどのように動作するかを示しています。青のステップはお客様のアクションを示しており、緑はシステムによって実行されます。どのタクソノミが使われるにせよ、最初に必要なことは青のステップ1及び2です。青のステップ1はサポートされているいずれかの言語で書かれたドキュメントで標準タクソノミの使用を有効化します。青のステップ2は図で示されているように、お客様が作成されたタクソノミ(JSONファイルの利用もサポートされています)のExcelをアップロードします。

image-20220118-024736.png

青のステップ3と緑のステップ3は2つのデータ処理方法があることを示しています。ほとんどのケースでは Piano Insight のクローラー(緑)で行われます。しかし、お客様がAPIを使ってデータをアップロードすることも可能です(青)。どちらの場合でもタクソノミはアップロードされたデータに影響を受けます。どちらの場合にも、アップロードされたタクソノミのキーと値の組み合わせが適用される、共通の緑のステップ4で示されているように、タクソノミはアップロードされたデータに影響します。図ではドキュメント内でピックアップされた Toyota と spaghetti bolognese という2つの用語が表示されたと想像してください。motor/cars/toyota  food/pasta のタクソノミパスを持ったxyz-categories は既に保持していたコンテンツプロファイルの属性に対してパスのリストとして追加されます(xyz はカスタマープリフィックスです) 。

標準タクソノミの有効化

サイトの標準タクソノミを有効にしたいなら、Piano プロフェッショナルサービスにご相談いただくか、 support@piano.io にメールリクエストを送ってください。

カスタムタクソノミのアップロード

Pianoの担当者のみがカスタムタクソノミの利用を有効化できますが、お客様自身でその維持管理を行うことを前提としています。辞書管理チュートリアル は弊社側の誰が辞書を有効化できるのか、一方でお客様はどのようにそれを更新するか、を説明しています。

以下では標準タクソノミからタクソノミ辞書テンプレートを作成しました。独自のカスタム辞書を作成するお役様はこれを始まりとして、辞書(または実際にタクソノミのExcelファイルとして)を使うことができます。

{
    "global-properties": {
		"tokenizer-context": "<言語を選択します: en, fr, es, de, no, sv, ja, etc.>",
		"mode": "overlap",
		"leftmost-longest-match": true,
		"key-normalization-flags": 4,
		"value-normalization-flags": 4,
		"swap-fields": true,
		"count": 2,
		"unique-count": 2,
		"count-field": "value",
		"expand-paths": true,
		"group-prefix": "カスタマープリフィックスを設定します"
		"annotate-paths": false,
    },
	"food": {
		"spaghetti bolognese": "food/pasta",
		"bibimbap": "food/asian/korean"
	},
	"motor": {
		"toyota": "motor/cars/toyota",
		"renault": "motor/cars/renault",
	}
}

標準タクソノミとカスタムタクソノミの結合

1つあるいはそれ以上のカスタムタクソノミと一緒にPiano Insight 標準タクソノミの使用を組み合わせることは可能です。唯一考慮が必要な注意点は同じキーと値の組み合わせが複数のタクソノミに現れる場合です。タクソノミの値の重み付けは各タクソノミの寄与度合いの合計になります。これはタクソノミごとのキーと値の組み合わせの重複がないことを事前に確認することによって、避けることができます。

Last updated: