コミュニティのスコアとバッジ

注意

AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

概要

AEM Communitiesのスコアとバッジ機能を使用すると、コミュニティメンバーを特定し、報奨を与えることができます。

スコアとバッジの主な側面は次のとおりです。

注意 バッジの授与は デフォルトでは有効になっていません.

注意

CRXDE Liteに表示される実装構造は、UI が使用可能になった後で変更される場合があります。

バッジ

バッジは、コミュニティ内での役割または地位を示すために、メンバーの名前の下に配置されます。 バッジは、画像として、または名前として表示できます。 画像として表示される場合、この名前はアクセシビリティのための代替テキストとして含まれます。

デフォルトでは、バッジは次の場所のリポジトリに配置されます。

  • /etc/community/badging/images

別の場所に保存されている場合は、すべてのユーザーが読み取りアクセス可能である必要があります。

UGC では、バッジをルールに従って割り当てたか、獲得したかを区別します。 現在は、割り当てられたバッジがテキストとして表示され、獲得したバッジが画像として表示されます。

バッジ管理 UI

コミュニティ バッジコンソール は、獲得(与えられる)時やコミュニティで特定の役割を担う(割り当てられる)時に、メンバーに対して表示できるカスタムバッジを追加する機能を提供します。

割り当てられたバッジ

ロールベースのバッジは、コミュニティ内での役割に基づいて、管理者がコミュニティメンバーに割り当てます。

割り当てられた(および待ち受けの)バッジは、選択した SRP およびは直接アクセスできません。 GUI が使用できるようになるまで、ロールベースのバッジを割り当てる唯一の方法は、コードまたは cURL を使用して割り当てることです。 cURL の手順については、「 バッジの割り当てと取り消し.

このリリースには、次の 3 つの役割ベースのバッジが含まれています。

  • モデレーター

    /etc/community/badging/images/moderator/jcr:content/moderator.png

  • グループマネージャー

    /etc/community/badging/images/group-manager/jcr:content/group-manager.png

  • 権限を持つメンバー

    /etc/community/badging/images/privileged-member/jcr:content/privileged-member.png

chlimage_1-366

授与されたバッジ

報酬ベースのバッジは、コミュニティ内のアクティビティに適用されるルールに基づいて、スコア付けサービスによってコミュニティメンバーに付与されます。

アクティビティに対する報酬としてバッジを表示するには、次の 2 つの処理が必要です。

  • バッジは必ず設定します 有効 フィーチャコンポーネント用
  • スコアルールとバッジルールは次の条件を満たす必要があります 適用 を、コンポーネントが配置されているページ(または上位ページ)に追加します。

このリリースには、次の 3 つの報酬ベースのバッジが含まれています。

  • ゴールド

    /etc/community/badging/images/gold-badge/jcr:content/gold.png

  • シルバー

    /etc/community/badging/images/silver-badge/jcr:content/silver.png

  • ブロンズ

    /etc/community/badging/images/bronze-badge/jcr:content/bronze.png

chlimage_1-367

メモ

「不適切」とフラグ付けされた投稿に対して負のポイントを割り当て、スコアの値に影響を与えるようにスコアルールを設定できます。 ただし、バッジを獲得すると、スコアリングポイントの削減やスコアリングルールの変更により、バッジは自動的に削除されません。

授与されたバッジは、割り当てられたバッジと同じ方法で取り消すことができます。 詳しくは、 バッジの割り当てと取り消し 」セクションに入力します。 今後の改善には、メンバーのバッジを管理する UI が含まれます。

カスタムバッジ

カスタムバッジは、 バッジコンソール バッジルールで割り当てるか指定します。

バッジコンソールからインストールすると、カスタムバッジはパブリッシュ環境に自動的にレプリケートされます。

スコアリングを有効にする

スコアリングは、デフォルトでは有効になっていません。 スコア付けとバッジの授与を設定して有効にする基本的な手順は次のとおりです。

詳しくは、 クイックテスト セクションを開き、フォーラムとコメントのデフォルトのスコアルールとバッジルールを使用して、コミュニティサイトのスコアを有効にします。

コンテンツへのルールの適用

スコアとバッジを有効にするには、プロパティを追加します scoringRules および badgingRulesを、サイトのコンテンツツリー内の任意のノードに追加します。

サイトが既に公開されている場合は、すべてのルールを適用してコンポーネントを有効にした後、サイトを再公開します。

バッジが有効なコンポーネントに適用されるルールは、現在のノードまたはその上位ノード用のものです。

ノードのタイプがの場合 cq:Page (推奨)次に、CRXDE|Lite を使用して、プロパティをそのに追加します。 jcr:contentノード。

プロパティ タイプ 説明
badgingRules 文字列[] 配列のリスト バッジルール
scoringRules 文字列[] 配列のリスト スコア付けルール
メモ

スコアルールがバッジの授与に影響を与えないように見える場合は、バッジルールの scoringRules プロパティでスコアルールがブロックされていないことを確認します。 「 バッジルール.

コンポーネントのバッジを有効にする

スコアルールとバッディングルールは、 オーサリングモード.

boolean プロパティ allowBadgesコンポーネントインスタンスのバッジの表示を有効または無効にします。 これは、 コンポーネント編集ダイアログ フォーラム、Q&A、コメントコンポーネントの場合は、「 」というラベルの付いたチェックボックスを使用します。 バッジを表示.

例:フォーラムコンポーネントインスタンスの allowBadges

chlimage_1-368

メモ

フォーラム、Q&A およびコメントで見つかった HBS コードを例として使用して、任意のコンポーネントをオーバーレイしてバッジを表示できます。

スコアルール

スコア付けルールは、バッジを授与するためのスコア付けの基礎です。

非常に簡単に、各スコアルールは 1 つ以上のサブルールのリストです。 バッジが有効な場合に適用するルールを識別するために、スコアルールがコミュニティサイトのコンテンツに適用されます。

スコア付けルールは継承されますが、加算的ではありません。 次に例を示します。

  • page2 にスコアルール 2 が含まれ、その上位ページ 1 にスコアルール 1 が含まれる場合

  • page2 コンポーネントのアクションは、rule1 と rule2 の両方を呼び出します。

  • 両方のルールに同じに適用可能なサブルールが含まれる場合 topic/verb:

    • ルール 2 のサブルールのみがスコアに影響を与えます
    • 両方のサブルールのスコアは、一緒には追加されません

複数のスコアルールがある場合、スコアは各ルールごとに個別に維持されます。

スコア付けルールは、 cq:Page プロパティを含む jcr:content定義するサブルールのリストを指定するノード。

スコアは SRP に保存されます。

メモ

ベストプラクティス:各スコアルールに一意の名前を付けます。

スコア付けルール名は、グローバルに一意である必要があります。同じ名前で終わるべきではありません。

not 手順:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring

スコアサブルール

スコア付けサブルールには、コミュニティに参加するための値の詳細を示すプロパティが含まれます。

各スコアサブルールは、

  • 追跡されているアクティビティ
  • 関連する特定のコミュニティ機能
  • 与えられるポイント数

デフォルトでは、サブルールでコンテンツの所有者がポイント ( forOwner) をクリックします。

各サブルールは、1 つ以上のスコアルールに含めることができます。

通常、サブルールの名前は、 件名、オブジェクト および 動詞. 次に例を示します。

  • member-comment-create
  • member-receive-vote

サブルールは、タイプのノードです cq:Page プロパティを含む jcr:contentノード 動詞とトピック .

プロパティ タイプ 値 説明
VERB Long
  • 必須動詞はイベントアクションに対応する
  • 動詞プロパティは少なくとも 1 つ必要です
  • 動詞はすべて大文字で入力する必要があります
  • 複数の動詞プロパティを使用できますが、重複はありません
  • 値は、このイベントに適用するスコアです
  • 値は正または負です
  • このリリースでサポートされている動詞のリストは、 トピックと動詞 セクション
topics String[]
  • オプション;サブルールを、イベントトピックで識別されるコミュニティコンポーネントに制限します。
  • 指定した場合:値は、イベントトピックの複数値文字列です
  • このリリースのトピックのリストは、 トピックと動詞 セクション
  • デフォルトでは、動詞に関連付けられたすべてのトピックに適用されます
forOwner ブーリアン
  • オプション;メンバーが自分のコンテンツに対して行動を起こす場合は関係ありません
  • true の場合は、アクションを実行するコンテンツの所有者にスコアを適用します
  • false の場合は、アクションを実行するメンバーにスコアを適用します
  • デフォルトは false です。
scoringType 文字列
  • オプション;スコアエンジンを識別します。
  • 「basic」の場合は、数量に基づいてスコアエンジンを指定します。
    • リリースに含まれる
  • 「詳細」の場合は、品質と数量に基づいてスコアエンジンを指定します
  • デフォルトは「basic」です。

含まれるスコアルールとサブルール

このリリースには、 フォーラム機能 (フォーラム機能の「フォーラム」および「コメント」コンポーネントごとに 1 つずつ):

  1. /etc/community/scoring/rules/comments-scoring

    • subRules[] =

      /etc/community/scoring/rules/subrules/member-comment-create

      /etc/community/scoring/rules/subrules/member-receive-vote

      /etc/community/scoring/rules/subrules/member-give-vote

      /etc/community/scoring/rules/subrules/member-is-moderated

  2. /etc/community/scoring/rules/forums-scoring

    • subRules[] =

      /etc/community/scoring/rules/subrules/member-forum-create

      /etc/community/scoring/rules/subrules/member-receive-vote

      /etc/community/scoring/rules/subrules/member-give-vote

      /etc/community/scoring/rules/subrules/member-is-moderated

メモ:

  • 両方 rulesおよび sub-rules ノードのタイプは cq:Page です。

  • subRulesは String 型の属性です[] 規則の jcr:content ノード

  • sub-rules は、様々なスコアルールで共有できます

  • rulesはリポジトリの場所に配置し、全員に対して読み取り権限を付与する必要があります

    • ルール名は、場所に関係なく一意である必要があります

カスタムスコアルールのアクティブ化

オーサー環境でスコアルールやサブルールに対して行った変更や追加は、パブリッシュ環境にインストールする必要があります。

バッジルール

バッジルールは、次の項目を指定することで、スコアルールをバッジにリンクします。

  • どのスコアルールか
  • 特定のバッジを待機するために必要なスコア。

バッジルールはタイプのノードです cq:Page プロパティを含む jcr:contentスコアルールをスコアおよびバッジに関連付けるノード。

バッジのルールは必須の thresholdsバッジにマッピングされたスコアの順序付きリストであるプロパティ。 スコアは、値を増やすために並べ替える必要があります。 次に例を示します。

  • 1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png

    • 1 ポイントの獲得に対してブロンズバッジが待機されています
  • 60|/etc/community/badging/images/silver-badge/jcr:content/silver.png

    • シルバーバッジは 60 ポイントの累積時に授与されます
  • 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png

    • 80 ポイントが累積すると、ゴールドバッジが表示されます

バッジルールは、ポイントの累積方法を決定するスコアルールと対になります。 「 コンテンツへのルールの適用.

この scoringRulesプロパティは、特定のバッジルールと対にできるスコアルールを制限するだけです。

メモ

ベストプラクティス:各AEMサイトに固有のバッジ画像を作成します。

chlimage_1-369

プロパティ タイプ 値 説明
しきい値 String[] (必須) 「number|path」の形式の複数値文字列
  • 数値=スコア
  • | =縦線の文字 (U+007C)
  • path =バッジ画像リソースの完全パス
文字列は、値が増加し、数値とパスの間に空白のスペースが現れないように、並べ替える必要があります。
エントリの例:
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
badgingType 文字列 (オプション) スコアリングエンジンを「基本」または「詳細」として識別します。 高度なスコアエンジンが必要な場合は、 高度なスコアとバッジ. デフォルトは「basic」です。
scoringRules String[] (オプション) バッジルールを、スコアルールで識別されるスコアイベントに制限する複数値の文字列

含まれるバッジルール

このリリースには、 フォーラムおよびコメントのスコアリングルール.

  • /etc/community/badging/rules/comments-badging
  • /etc/community/badging/rules/forums-badging

メモ:

  • rules ノードのタイプは cq:Page です。

  • rulesはリポジトリの場所に配置し、全員に対して読み取り権限を付与する必要があります

    • ルール名は、場所に関係なく一意である必要があります

カスタムバッジルールの有効化

オーサー環境でバッジルールや画像に加えた変更や追加は、すべてパブリッシュ環境にインストールする必要があります。

バッジの割り当てと取り消し

バッジは、 メンバーコンソール または cURL コマンドをプログラムで使用する。

次の cURL コマンドは、バッジの割り当てと取り消しに HTTP リクエストで必要な処理を示します。 基本的な形式は次のとおりです。

cURL -i -XPOST-H ヘッダー -u *signin * -F *operation * -F *badge * member-profile-url

ヘッダー = "Accept:application/json"
サーバーに渡すカスタムヘッダー(必須)

サインイン = administrator-id:password
例:admin:admin

操作 = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"

バッジ = "badgeContentPath=badge-image-file"

badge-image-file =リポジトリ内のバッジ画像ファイルの場所
例:/etc/community/badging/images/moderator/jcr:content/moderator.png

member-profile-url =公開時のメンバーのプロファイルのエンドポイント
例:https://<server>:<port>/home/users/community/riley/profile.social.json

メモ

この member-profile-url

例:

モデレーターバッジを割り当て

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/etc/community/badging/images/moderator/jcr:content/moderator.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

割り当てられたシルバーバッジを取り消す

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/etc/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
メモ

cURL を使用したバッジの割り当てと取り消しは、どのバッジ画像でも機能しますが、獲得の代わりに割り当てられたバッジは、割り当てられたバッジとしてマークされ、それに応じて処理されます。

カスタムコンポーネントのスコアとバッジ

カスタムコンポーネントに対してスコアルールとバッジルールを作成するには、コンポーネント用に作成されたイベントトピックを動詞に関連付けます。

トピックと動詞

メンバーがコミュニティ機能とやり取りすると、通知やスコアリングなどの非同期リスナーをトリガーにできるイベントが送信されます。

コンポーネントの SocialEvent インスタンスは、イベントを actionsそれは topic. SocialEvent には、 verbアクションに関連付けられている。 ここに n-1 ~間の関係 actionsおよび verbs.

配信されるコミュニティコンポーネントについて、次の表で次の内容を説明します verbsそれぞれに定義 topic~で使用できる スコアサブルール.

メモ

新しいブール型プロパティ allowBadgesコンポーネントインスタンスのバッジの表示を有効または無効にします。 更新時に設定可能になります コンポーネント編集ダイアログ ラベル付きのチェックボックスを通じて バッジを表示.

カレンダーコンポーネント
SocialEvent topic= com/adobe/cq/social/calendar

動詞 説明
POST メンバーがカレンダーイベントを作成する
追加 カレンダーイベントに対するメンバーのコメント
更新 メンバーのカレンダーイベントまたはコメントが編集されました
削除 メンバーのカレンダーイベントまたはコメントが削除されました

コメントコンポーネント
SocialEvent topic= com/adobe/cq/social/comment

動詞 説明
POST メンバーがコメントを作成
追加 メンバーがコメントに返信しました
更新 メンバーのコメントが編集されます
削除 メンバーのコメントが削除されます

ファイルライブラリコンポーネント
SocialEvent topic= com/adobe/cq/social/fileLibrary

動詞 説明
POST メンバーがフォルダーを作成
添付 メンバーはファイルをアップロードします
更新 メンバーがフォルダーまたはファイルを更新
削除 メンバーがフォルダまたはファイルを削除

フォーラムコンポーネント
SocialEvent topic= com/adobe/cq/social/forum

動詞 説明
POST メンバーがフォーラムトピックを作成します
追加 フォーラムトピックに返信するメンバー
更新 メンバーのフォーラムのトピックまたは返信が編集されます
削除 メンバーのフォーラムトピックまたは返信が削除されました

ジャーナルコンポーネント
SocialEvent topic= com/adobe/cq/social/journal

動詞 説明
POST メンバーがブログ記事を作成します
追加 メンバーがブログ記事にコメントを投稿
更新 メンバーのブログ記事またはコメントが編集されます
削除 メンバーのブログ記事またはコメントが削除されました

Q&A コンポーネント
SocialEvent topic = com/adobe/cq/social/qna

動詞 説明
POST メンバーが Q&A 質問を作成
追加 メンバーが Q&A 回答を作成
更新 メンバーの Q&A の質問または回答が編集されます
選択 メンバーの回答が選択されています
選択解除 メンバーの回答が選択解除されました
削除 メンバーの Q&A の質問または回答が削除されます

レビューコンポーネント
SocialEvent topic= com/adobe/cq/social/review

動詞 説明
POST メンバーがレビューを作成
更新 メンバーのレビューが編集されます
削除 メンバーのレビューが削除されます

評価コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/rating

動詞 説明
評価を追加 メンバーのコンテンツが評価されました
評価を削除 メンバーのコンテンツが評価を下げました

投票コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/voting

動詞 説明
投票を追加 メンバーのコンテンツが投票に参加しました
投票を削除 メンバーのコンテンツが投票で否決されました

モデレートが有効なコンポーネント
SocialEvent topic= com/adobe/cq/social/moderation

動詞 説明
拒否 メンバーのコンテンツが拒否されました
「不適切」のフラグ メンバーのコンテンツにフラグが設定されています
不適切としてフラグ解除 メンバーの内容にフラグが設定解除されました
ACCEPT メンバーのコンテンツがモデレーターによって承認されました
閉じる メンバーが編集と返信に対するコメントを閉じる
開く メンバーがコメントを再度開く

カスタムコンポーネントイベント

カスタムコンポーネントの場合、 SocialEvent がインスタンス化され、コンポーネントのイベントが actionsそれは topic.

スコアリングをサポートするには、 SocialEvent でメソッドを上書きする必要があります getVerb() 適切な verbが返される action. この verb アクションに対して返されるのは、一般的に使用される ( POST) またはコンポーネント専用の ( 例えば ADD RATING) をクリックします。 ここに n-1 ~間の関係 actionsおよび verbs.

トラブルシューティング

バッジが表示されません

スコアルールとバッジルールが Web サイトのコンテンツに適用されていて、どのアクティビティに対してもバッジが表示されない場合は、そのコンポーネントのインスタンスに対してバッジが有効になっていることを確認します。

詳しくは、 コンポーネントのバッジを有効にする.

スコア付けルールは無効です

スコアルールとバッジルールが Web サイトのコンテンツに適用され、一部のアクションにバッジが与えられ、他のアクションにはバッジが与えられない場合は、適用されるスコアルールがバッジルールによって制限されていないことを確認します。

詳しくは、 scoringRulesプロパティ バッジルール.

大文字と小文字の区別

プロパティや値のほとんど、特に動詞は、大文字と小文字が区別されます。 スコアサブルールで使用する場合、動詞はすべて大文字にする必要があります。

機能が期待どおりに動作しない場合は、データが正しく入力されていることを確認します。

クイックテスト

スコアとバッジを、 入門チュートリアル (エンゲージメント)サイト:

  • 作成者のCRXDE Liteにアクセス

  • ベースページを参照します。

    • /content/sites/engage/en/jcr:content
  • badgingRules プロパティを追加します。

    • 名前badgingRules
    • String
    • 選択 複数
    • 選択 追加
    • /etc/community/badging/rules/forums-badging と入力します。
    • + を選択します。
    • /etc/community/badging/rules/comments-badging と入力します。
    • 選択 OK
  • scoringRules プロパティを追加します。

    • 名前scoringRules
    • String
    • 選択 複数
    • 選択 追加
    • /etc/community/scoring/rules/forums-scoring と入力します。
    • + を選択します。
    • /etc/community/scoring/rules/comments-scoring と入力します。
    • 選択 OK
  • 選択 すべて保存

chlimage_1-370

次に、フォーラムとコメントのコンポーネントでバッジを表示できるようにします。

  • CRXDE Lite

  • フォーラムコンポーネントを参照

    • /content/sites/engage/en/forum/jcr:content/content/primary/forum
  • 必要に応じて、allowBadges ブール型プロパティを追加し、true に設定する

    • 名前allowBadges
    • Boolean
    • true

chlimage_1-371

次に、 再公開 コミュニティサイトです。

最後に

  • パブリッシュインスタンス上のコンポーネントを参照します。

  • コミュニティメンバーとしてサインイン ( 例:weston.mccall@dodgit.com / password)

  • 新しいフォーラムトピックを投稿します

  • バッジを表示するには、ページを更新する必要があります

    • ログアウトし、別のコミュニティメンバーとしてログインします ( 例:aaron.mcdonald@mailinator.com / password)
  • フォーラムを選択

これにより、コミュニティメンバーは、最初のフォーラムバッジルールの最初のしきい値がスコア 1 なので、フォーラム投稿でブロンズバッジを表示できます。

気取った

追加情報

詳しくは、 スコアとバッジの基本事項 開発者向けのページ

高度なスコアエンジンについて詳しくは、 高度なスコアとバッジ.

設定可能なリーダーボード コンポーネント および 関数 は、コミュニティサイトでのメンバーとそのスコアの表示を簡素化します。

このページ