テンプレート処理中にエラーが発生しました。
Java method "com.liferay.portal.json.JSONFactoryImpl.createJSONObject(String)" threw an exception when invoked on com.liferay.portal.json.JSONFactoryImpl object "com.liferay.portal.json.JSONFactoryImpl@2ad66ae2"; see cause exception in the Java stack trace.

----
FTL stack trace ("~" means nesting-related):
	- Failed at: navigationJSONObject = jsonFactoryUti...  [in template "17855804202317#32484267#LEARN-ARTICLE-NAV" at line 4, column 9]
----
1<#assign 
2	groupFriendlyURL = themeDisplay.getScopeGroup().getFriendlyURL() 
3	groupPathFriendlyURLPublic = themeDisplay.getPathFriendlyURLPublic() + groupFriendlyURL 
4	navigationJSONObject = jsonFactoryUtil.createJSONObject(navigation.getData()) 
5	navigationMenuItems = 
6
7			"Analytics Cloud": { 
8				"image": "/documents/d${groupFriendlyURL}/analytics_c-svg", 
9				"title": "Analytics Cloud", 
10				"url": "analytics-cloud" 
11			}, 
12			"Commerce": { 
13				"image": "/documents/d${groupFriendlyURL}/commerce_product-svg", 
14				"title": "Commerce", 
15				"url": "commerce" 
16			}, 
17			"DXP": { 
18				"image": "/documents/d${groupFriendlyURL}/dxp_p-svg", 
19				"title": "DXP / Portal", 
20				"url": "dxp" 
21			}, 
22			"Liferay Cloud": { 
23				"image": "/documents/d${groupFriendlyURL}/dxp_c-svg", 
24				"title": "Liferay Cloud", 
25				"url": "liferay-cloud" 
26			}, 
27			"Reference": { 
28				"image": "/documents/d${groupFriendlyURL}/reference-svg", 
29				"title": "Reference", 
30				"url": "reference" 
31
32
33 
34	breadcrumbJSONArray = navigationJSONObject.getJSONArray("breadcrumb") 
35	childrenJSONArray = navigationJSONObject.getJSONArray("children") 
36	parentJSONObject = navigationJSONObject.getJSONObject("parent") 
37	productJSONObject = breadcrumbJSONArray.getJSONObject(breadcrumbJSONArray.length()-1)!navigationJSONObject.getJSONObject("self") 
38	siblingsJSONArray = navigationJSONObject.getJSONArray("siblings") 
39/> 
40 
41<div class="learn-article-nav"> 
42	<#if productJSONObject?has_content && productJSONObject.getString("title")?has_content && navigationMenuItems[productJSONObject.getString("title")]?has_content && navigationMenuItems[productJSONObject.getString("title")].title?has_content> 
43		<div 
44			class="dropdown learn-article-nav-root learn-dropdown" 
45
46			<div class="learn-article-nav-item"> 
47				<div class="d-flex"> 
48					<div class="learn-article-nav-image"> 
49						<img 
50							class="lexicon-icon lexicon-icon-caret-bottom product-icon" 
51							role="presentation" 
52							src='${navigationMenuItems[productJSONObject.getString("title")].image}' 
53							viewBox="0 0 512 512" 
54						/> 
55					</div> 
56 
57					<span class="learn-article-nav-text">${navigationMenuItems[productJSONObject.getString("title")].title}</span> 
58				</div> 
59 
60				<div id="dropdown-icon"> 
61					<svg 
62						class="lexicon-icon lexicon-icon-caret-bottom" 
63						role="presentation" 
64						viewBox="0 0 512 512" 
65
66						<use xlink:href="/o/admin-theme/images/clay/icons.svg#caret-bottom"></use> 
67					</svg> 
68				</div> 
69			</div> 
70 
71			<ul class="dropdown-menu learn-dropdown-menu"> 
72				<#list navigationMenuItems as key, value> 
73					<li> 
74						<a 
75							class="dropdown-item learn-article-nav-item" 
76							href="/w/${navigationMenuItems[key].url}/index" 
77							tabindex="4" 
78
79							<span class="d-flex"> 
80								<span class="learn-article-nav-image"> 
81									<img 
82										class="lexicon-icon lexicon-icon-caret-bottom product-icon mt-0 mr-2" 
83										role="presentation" 
84										src="${value.image}"height: 25px; margin-left: 5px; max-width: none; width: 25px; 
85										viewBox="0 0 512 512" 
86									/> 
87								</span> 
88								<span class="learn-article-nav-text">${value.title}</span> 
89							</span> 
90 
91							<#if navigationMenuItems[productJSONObject.getString("title")].url == value.url> 
92								<span> 
93									<@clay["icon"] symbol="check" /> 
94								</span> 
95							</#if> 
96						</a> 
97					</li> 
98				</#list> 
99			</ul> 
100		</div> 
101	</#if> 
102 
103	<div class="learn-article-nav-content"> 
104		<#if parentJSONObject?has_content && parentJSONObject.getString("url")?has_content> 
105			<div class="learn-article-nav-item learn-article-nav-parent liferay-nav-item p-2"> 
106				<div class="mr-2"> 
107					<a 
108						href='${parentJSONObject.getString("url")}' 
109
110						<svg 
111							class="lexicon-icon lexicon-icon-angle-left" 
112							role="presentation" 
113							viewBox="0 0 512 512" 
114
115							<use xlink:href="/o/admin-theme/images/clay/icons.svg#angle-left"></use> 
116						</svg> 
117					</a> 
118				</div> 
119 
120				<span>${parentJSONObject.getString("title")}</span> 
121			</div> 
122		</#if> 
123 
124		<#if childrenJSONArray.length() gt 0> 
125			<ul class="m-0 p-2"> 
126				<#list 0..childrenJSONArray.length()-1 as i> 
127					<li class="learn-article-nav-item"> 
128						<a 
129							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == childrenJSONArray.getJSONObject(i).url)?then("selected", "")}' 
130							href="${childrenJSONArray.getJSONObject(i).url}" 
131
132							<span>${childrenJSONArray.getJSONObject(i).getString("title")}</span> 
133						</a> 
134					</li> 
135				</#list> 
136			</ul> 
137		<#elseif siblingsJSONArray.length() gt 0> 
138			<ul class="m-0 p-2"> 
139				<#list 0..siblingsJSONArray.length()-1 as i> 
140					<li class="learn-article-nav-item"> 
141						<a 
142							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == siblingsJSONArray.getJSONObject(i).url)?then("selected", "")}' 
143							href="${siblingsJSONArray.getJSONObject(i).url}" 
144
145							<span>${siblingsJSONArray.getJSONObject(i).getString("title")}</span> 
146						</a> 
147					</li> 
148				</#list> 
149			</ul> 
150		</#if> 
151	</div> 
152</div> 

Search Experiencesのパーソナライズ

Search ExperiencesとSearch Blueprintsの主な使用例の1つは、Liferayの検索結果 をパーソナライズすることです。 パーソナライズされた検索エクスペリエンスでは、各ユーザーは自分のコンテキストの特定の詳細に応じて結果を見る。 現在、次のようなコンテキストの質問の答えにブループリントを反応させるための要素があります。

  • ユーザーはどこにいるのか?
  • ユーザーにはどのような役割がありますか?
  • そのユーザーが所属しているサイトは?
  • ユーザーはどのようなコンテンツを所有しているのか?
  • ユーザーはゲストですか?
  • そのユーザーは新規ユーザーですか?
  • どの ユーザーセグメントに属しているか?

各ユーザーのコンテキストに合わせたブループリントがなければ、デフォルトの結果は、検索されたキーワードのテキストが、インデックス化されたドキュメントの トークン化された 値とどれだけ一致するかによって関連性を計算するクエリに基づいてスコア付けされる。

検索結果をパーソナライズすることで、ユーザーが成功に必要なものを見つけられる可能性が高まる。 これにより、ユーザーをコンテンツに引き付け続けることができ、サイトが成功する可能性が高まります。 いくつかの例を挙げます。

  • ユーザーのIPアドレスに近い場合、特定の結果を優先する。
  • ユーザーが初めての場合、特定のコンテンツを優先する
  • ユーザーが認証されていない場合、特定のコンテンツを非表示にする

パーソナライズ要素

パーソナライゼーションの取り組みに特に有効な要素がいくつかあります。

Boost Proximity: は、 ipstack サービスを使って、ドキュメント内の geopoint フィールドによってマークされたユーザーの位置により近い検索結果をブーストする。 下記の例 では、サービスの設定方法とBoost Proximity要素の使用方法を紹介しています。

現在の言語用にコンテンツをブーストする: 現在のセッションの言語にマッチする defaultLanguageId フィールドを持つ検索結果をブーストする。

Hide Contents in a Category for Guest Users: 検索ユーザーが認証されていない場合、 特定のカテゴリー フィールドにマッチする検索結果を非表示にします。

Limit Search to My Contents: 文書の userId フィールドが検索ユーザーと一致する場合のみ、検索結果を返します。

Limit Search to My Sites:ユーザーがメンバーであるサイトにスコープされた検索結果のみを返します。

Boost Contents on My Sites: は、検索ユーザーがスコープされているサイトのメンバーである場合に、検索結果をブーストします。

ブースト・コンテンツ・オン・マイ・サイト: 検索ユーザーが、検索結果がスコープされているサイトのメンバーである場合、検索結果がブーストされます。

新規ユーザーアカウントのカテゴリ内コンテンツをブースト: 検索ユーザーのアカウントが特定の時間範囲に作成された場合、 特定のカテゴリ で検索結果をブーストします。

Boost Contents in a Category for a User Segment: ユーザーが特定のユーザーセグメント に属している場合、特定のカテゴリ で検索結果をブーストします。

検索結果をパーソナライズするためのブループリントの構築

ユーザーの位置情報に基づいて結果を表示したい場合があります。 そのためには

Ipstackサービスの設定

ブループリントを設定する前に、 ipstack key を取得し、Liferay で ipstack サービスを有効にする必要があります。

  1. https://ipstack.com にアクセスし、APIキーを取得します。
  2. Liferayの[システム設定] → [プラットフォーム] → [Search Experiences] → [Ipstack]に進みます。
  3. 有効] をクリックします。
  4. APIキーを入力します.
  5. 保存] をクリックします。

システム設定でipstackサービスを設定する。

位置情報アセットを設定する

ipstackサービスとBoost Proximity Elementで動作するためには、検索ドキュメントに geopointフィールド 。 Liferayには互換性のある位置情報フィールドがあり、既存のアセットにカスタムフィールドとして追加することができます。

  1. [コントロールパネル] → [カスタムフィールド] に移動します。
  2. ブログのエントリに新規カスタムフィールドを追加します。
    • タイプ:位置情報
    • フィールド名:場所
  3. 保存] をクリックします。
  4. 2つの新規ブログを追加します(サイトメニューを開き、[コンテンツ] & [データ] → [ブログ]に移動します)。
    • 最初のブログのエントリ
      • タイトル: ブログタイトル
    • コンテンツ: ブログの内容
    • カスタムフィールドで、現在地から約100km離れた場所に位置情報ピンをドラッグします。
    • ブログを公開します。
    • 2つ目のブログのエントリ - タイトル: 2つ目のブログタイトル
      • コンテンツ: 2つ目のブログの内容
      • カスタムフィールドで、位置情報ピンを現在地にできるだけ近くなるようにドラッグします。
      • ブログを公開します。
tip

ピンをより正確に配置するために、ジオロケーションマップをズームします。

検索ページで blog 。 タイトルとコンテンツ・フィールドが短いブログ・エントリー(最初のもの、タイトルは ブログタイトル)は、検索結果ウィジェットに最初に表示される。

位置情報認識機能を持ったブループリントを設定する

これで ipstack サービスが設定され、ジオポイントデータを含む検索ドキュメントが作成されたので、検索ユーザーからの近さによって特定の結果を高めるブループリントを設定する準備ができました:

  1. [グローバルメニュー] → [アプリケーション] (Search Experiences) から [ブループリント] をクリックして、ブループリントアプリケーションを開きます。

  2. Add(Add) をクリックしてブループリントを追加します。

    Add Blueprint ウィンドウからブループリントの作成を開始します。

  3. [新規検索ブループリント]ウィンドウで、ブループリントに[name] (必須) と[description](オプション) を指定します。

  4. クエリビルダー を使用して、Boost Proximity要素を追加してください。

    • フィールドを expando__keyword__custom_fields__location_geolocationとして設定します。
    • 減衰を0.8に設定します。
    • スケールを10kmに設定します。
    • ブーストの値を100に設定します。 Boost Proximity要素を設定します。
  5. ブループリントを構築し、構成しながらテストします。 [プレビュー] をクリックします。

  6. 現在地のユーザーの検索体験をモデル化するには、歯車のアイコン(Cog)をクリックして、あなたのパブリックIPV4アドレスを検索コンテキストに設定します。

    • キー: search.experiences.ip.address
    • 値:[自分のパブリックIPV4アドレス]

完了] をクリックします。

  1. キーワード ブログ を入力し、現在地から近いブログのエントリーが、遠いブログのエントリーよりも先に返されることを確認する。

  2. ブループリントの作成が完了したら、 [保存] をクリックします。

これで、 ブループリントをLiferayの検索ページに適用することができます

送信IPアドレスに近いかどうかで文書をスコアリングするガウス関数を調整する必要があるかもしれない:

Decay は、ユーザーとアセットの距離がスケールと等しい場合に、ブースト値を減少させる係数を定義します。

スケール は、ユーザーのIPアドレス位置からの距離で、これを超えると結果の関連性が低下し始める。

ブースト は、定義されたスケール内で結果をブーストするための数値である。

例えば、ユーザーから 10 km 以内に位置する検索結果に対して 100 のブーストを指定し、減衰係数を 0.5 と定義した場合、ユーザーからちょうど 10 km 離れた検索結果は最大ブースト値の半分、つまり 50 のブーストを受けます。 10km以上の距離では、ガウス関数が残りのスコアを決定することになります。

詳しくは ElasticのFunction Score Query ドキュメントをご覧ください。