DocumentazioneAEM 6.5Guida di Communities

Punteggio avanzato e badge advanced-scoring-and-badges

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

Panoramica overview

Il punteggio avanzato consente di assegnare distintivi per identificare i membri come esperti. Il punteggio avanzato assegna punti in base alla quantità e di contenuto creato da un membro, mentre il punteggio di base assegna punti in base alla quantità di contenuto creato.

Questa differenza è dovuta al motore di punteggio utilizzato per calcolare i punteggi. Il motore di punteggio di base applica una matematica semplice. Il motore di punteggio avanzato è un algoritmo adattivo che premia i membri attivi che contribuiscono a contenuti importanti e rilevanti, dedotti attraverso l’elaborazione del linguaggio naturale (NLP) di un argomento.

Oltre alla rilevanza dei contenuti, gli algoritmi di punteggio tengono conto delle attività dei membri, come le votazioni e la percentuale di risposte. Anche se il punteggio di base li include quantitativamente, il punteggio avanzato li utilizza in modo algoritmico.

Pertanto, il motore di punteggio avanzato richiede dati sufficienti per rendere l’analisi significativa. La soglia di successo per diventare un esperto viene costantemente rivalutata man mano che l’algoritmo si adatta continuamente al volume e alla qualità dei contenuti creati. Esiste anche un concetto di decadimento dei post più vecchi di un membro. Se un membro esperto smette di partecipare alla materia in cui ha ottenuto lo stato di esperto, ad un certo punto predeterminato (vedi configurazione del motore di punteggio) potrebbe perdere il suo stato di esperto.

L’impostazione del punteggio avanzato è praticamente identica al punteggio di base:

Le differenze nell’impostazione delle regole di punteggio e badge sono:

  • Motore di punteggio avanzato configurabile

  • Regole di punteggio avanzate:

    • scoringType impostato su advanced
    • Richiede stopwords

  • Regole di badge avanzate:

    • badgingType impostato su advanced
    • badgingLevels impostato su numero di livelli esperti da assegnare
    • Richiede badgingPaths array di badge invece di soglie. La mappatura degli array punta ai badge.
NOTE
Per utilizzare le funzionalità avanzate di assegnazione di punteggi e contrassegni, installare il pacchetto di identificazione avanzata.

Motore di punteggio configurabile configurable-scoring-engine

Il motore di punteggio avanzato fornisce una configurazione OSGi con parametri che influiscono sull’algoritmo di punteggio avanzato.

motore di assegnazione punteggio avanzato

  • Pesi punteggio

    Per un argomento, specifica il verbo a cui assegnare la priorità più elevata durante il calcolo del punteggio. È possibile immettere uno o più argomenti, ma è possibile specificarne solo un verbo per argomento. Consulta Argomenti e verbi.
    Inserito come topic,verb con escape virgola. Ad esempio:
    /social/forum/hbs/social/forum\,ADD
    Il valore predefinito è impostato sul verbo ADD per i componenti QnA e forum.

  • Intervallo punteggio

    L’intervallo per i punteggi avanzati è definito da questo valore (punteggio massimo) e da 0 (punteggio più basso possibile).

    Il valore predefinito è 100, quindi l’intervallo di punteggio è compreso tra 0 e 100.

  • Intervallo di decadimento entità

    Questo parametro rappresenta il numero di ore dopo le quali tutti i punteggi di entità vengono decaduti. Questa opzione è necessaria per non includere più il contenuto precedente nei punteggi di un sito community.

    Il valore predefinito è 216000 ore (~24 anni).

  • Tasso di crescita punteggio
    Questo specifica il punteggio tra l’intervallo con punteggio 0, oltre il quale la crescita rallenta per limitare il numero di esperti.

    Il valore predefinito è 50.

Regole di punteggio avanzate advanced-scoring-rules

Nel punteggio di base, è nota la quantità necessaria per ottenere un distintivo.

Nel caso del punteggio avanzato, la quantità necessaria viene costantemente adeguata in base alla quantità di dati di qualità all’interno del sistema. Il punteggio viene continuamente calcolato in modo simile a una curva a campana.

Se un membro ha ottenuto un distintivo di esperto su un argomento che non è più attivo, c’è la possibilità che perda il suo distintivo a causa di un decadimento nel tempo.

scoringType scoringtype

Una regola di punteggio è un set di regole secondarie di punteggio, ognuna delle quali dichiara scoringType.

Per richiamare il motore di punteggio avanzato, scoringType deve essere impostato su advanced.

Vedi Sottoregole punteggio.

advanced-scoring-type

Parole di arresto stopwords

Il pacchetto di assegnazione punteggio avanzato installa una cartella di configurazione contenente un file di parole non significative:

  • /libs/settings/community/scoring/configuration/stopwords

L’algoritmo di punteggio avanzato utilizza l’elenco di parole contenute nel file delle parole non significative per identificare le parole inglesi comuni che vengono ignorate durante l’elaborazione del contenuto.

Non ci si aspetta che questo file venga modificato.

Se manca il file delle parole d’arresto, il motore di punteggio avanzato restituisce un errore.

Regole di assegnazione dei badge avanzate advanced-badging-rules

Le proprietà della regola di assegnazione dei badge avanzate sono diverse dalle proprietà della regola di assegnazione dei badge di base.

Invece di associare i punti a un’immagine del badge, è sufficiente identificare il numero di esperti ammessi e l’immagine del badge da assegnare.

regole di contrassegno avanzate

Proprietà
Tipo
Descrizione valore
badgingPath
String[]
(Obbligatorio) Stringa con più valori di immagini di badge fino al numero di badgingLevels. I percorsi delle immagini del badge devono essere ordinati in modo che il primo venga assegnato al massimo esperto. Se il numero di badge è inferiore a quello indicato da badgingLevels, l’ultimo badge nell’array occuperà il resto dell’array. Esempio di voce:
/libs/settings/community/badging/images/expert-badge/jcr:content/expert.png
badgingLevels
Lungo
(Facoltativo) Specifica i livelli di esperienza da assegnare. Ad esempio, se devono essere presenti expert e almost expert (due badge), il valore deve essere impostato su 2. Il valore badgingLevel deve corrispondere al numero di immagini badge correlate all’esperto elencate per la proprietà badgingPath. Il valore predefinito è 1.
badgingType
Stringa
(Obbligatorio) Identifica il motore di punteggio come "di base" o "avanzato". Impostate questo parametro su "Advanced", altrimenti l'impostazione predefinita è "Basic".
scoringRules
String[]
(Facoltativo) Stringa con più valori per limitare la regola di assegnazione dei badge agli eventi di punteggio identificati da una o più regole di assegnazione dei punteggi elencate.
Voce di esempio:
/libs/settings/community/scoring/rules/adv-comments-scoring
L'impostazione predefinita non prevede alcuna restrizione.

Regole e badge inclusi included-rules-and-badge

Badge incluso included-badge

In questa versione beta è incluso un distintivo per gli esperti basato su premi:

  • expert

    /libs/settings/community/badging/images/expert-badge/jcr:content/expert.png

badge esperto

Affinché il badge di esperto venga visualizzato come ricompensa per l’attività, assicurati:

  • Badges abilitati per la funzionalità, ad esempio un forum o un componente QnA.

  • Le regole avanzate di punteggio e badge vengono applicate alla pagina (o al predecessore) in cui viene posizionato il componente

Consulta le informazioni di base per:

Regole e sottoregole di punteggio incluse included-scoring-rules-and-sub-rules

Nella versione beta sono incluse due regole di punteggio avanzate per la funzione forum (una per ogni componente forum e commenti della funzione forum):

  1. /libs/settings/community/scoring/rules/adv-comments-scoring

    code language-none 
    subRules[] =
/libs/settings/community/scoring/rules/sub-rules/adv-comments-rule
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule-owner
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule

  2. /libs/settings/community/scoring/rules/adv-forums-scoring

    code language-none 
    subRules[] =
/libs/settings/community/scoring/rules/sub-rules/adv-forums-rule
/libs/settings/community/scoring/rules/sub-rules/adv-comments-rule
/libs/settings/community/scoring/rules/sub-rules/adv-voting-rule-owner

Note:

  • Entrambi i nodi rules e sub-rules sono di tipo cq:Page.
  • subRules è un attributo di tipo String[] nel nodo jcr:content della regola.
  • sub-rules può essere condiviso tra varie regole di punteggio.
  • rules deve trovarsi in un percorso archivio con autorizzazione di lettura per tutti.
  • I nomi delle regole devono essere univoci indipendentemente dalla posizione.

Regole di assegnazione dei badge incluse included-badging-rules

Nella versione sono incluse due regole di badge avanzate che corrispondono alle regole di punteggio per forum e commenti avanzati.

  • /libs/settings/community/badging/rules/adv-comments-badging
  • /libs/settings/community/badging/rules/adv-forums-badging

Note:

  • rules nodi sono di tipo cq:Page.
  • rules deve trovarsi in un percorso archivio con autorizzazione di lettura per tutti.
  • I nomi delle regole devono essere univoci indipendentemente dalla posizione.
recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791