AckdbScoreExplain

Per-criterion score breakdown — identical math to the compiled sc__ column.

Properties

scoreKeystringrequired

grainstringrequired

"company""person"

scorenumber (nullable)required

The normalized 0–100 score. NULL when the row is outside a SCOPED definition's segment (#443) — the row is not scored, which is not the same statement as scoring 0, and its sc__ column reads NULL too.

labelstring (nullable)

normalizationstringrequired

"absolute""percentile"

scopeobject

SCOPED definitions only (#443): which segment the definition scores, and whether THIS row is in it. When inScope is false, score/label are null and the criteria below describe what the row WOULD contribute — render "not scored — this model covers <segment>", never a 0.

segmentIdstringrequired

segmentNamestring (nullable)required

segmentKindstringrequired

"company""contact""person"

inScopebooleanrequired

groupsarray ofrequired

keystringrequired

weightnumberrequired

pointsnumberrequired

Σ of the group's criterion points (pre-weight).

criteriaarray ofrequired

fieldstringrequired

labelTextstringrequired

groupstringrequired

matchedstring (nullable)

Match/band criteria: the row's raw value.

aggValuenumber (nullable)

Aggregate criteria: the raw aggregate. Null ONLY on an agg=latest criterion with no observed value (#424) — counting aggregates report 0.

asOfstring <date-time> (nullable)

agg=latest criteria (#424): when the scored value was observed (the winning event's timestamp), so a UI can render "1,240 as of Jul 12". Null when nothing carried the field.

pointsnumberrequired

weightednumberrequired

points × the group's weight.

cappedboolean

perUnitPoints criteria: the ±cap clamp bit.

firedSourcesarray of

convergence criteria: the listed sources that fired in the window (aggValue = count).

string

firedSignalsarray of

signals-mode convergence criteria (#421): the listed signal refs that fired in the window, verbatim (aggValue = count).

string

populationExcludedboolean

percentilePopulation: "active" definitions only (#432): present (true) when this row is outside the ranking population — no non-trait criterion fired, score is 0 and the row is in nobody's denominator. The FE renders "no scored activity — not ranked".

Example

AckdbScoreExplain example

{
  "scoreKey": "string",
  "grain": "company",
  "score": 82,
  "label": "Excellent",
  "normalization": "absolute",
  "scope": {
    "segmentId": "string",
    "segmentName": "string",
    "segmentKind": "company",
    "inScope": false
  },
  "groups": [
    {
      "key": "string",
      "weight": 0,
      "points": 0
    }
  ],
  "criteria": [
    {
      "field": "string",
      "labelText": "string",
      "group": "string",
      "matched": "string",
      "aggValue": 0,
      "asOf": "1970-01-01T00:00:00.000Z",
      "points": 0,
      "weighted": 0,
      "capped": false,
      "firedSources": [
        "string"
      ],
      "firedSignals": [
        "string"
      ]
    }
  ],
  "populationExcluded": false
}