> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spottracker.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Lire les scores

> Ce que valent intentScore, icpScore et commercialScore, et ce qu'ils ne valent pas.

Chaque entreprise renvoyée par l'API porte trois notes sur 100. Elles ne
mesurent pas la même chose, et se lisent différemment.

<CardGroup cols={3}>
  <Card title="intentScore" icon="fire">
    **Le comportement.** Ce que l'entreprise a fait sur votre site, et quand.
  </Card>

  <Card title="icpScore" icon="bullseye">
    **Le profil.** L'adéquation firmographique à votre client idéal : secteur,
    taille, pays.
  </Card>

  <Card title="commercialScore" icon="scale-balanced">
    **La synthèse.** Une moyenne pondérée des deux, selon le poids configuré
    dans votre workspace.
  </Card>
</CardGroup>

## `intentScore` — le comportement

Il est **dérivé des visites**, recalculé à la lecture, et non stocké tel quel.
Trois mécanismes le gouvernent :

<AccordionGroup>
  <Accordion title="Un socle, pas un zéro" icon="stairs">
    Une entreprise identifiée dont on ne sait rien du comportement ne vaut pas
    0 : elle est venue. Elle part d'un socle et reste simplement froide.
  </Accordion>

  <Accordion title="Une décroissance de 14 jours" icon="hourglass-half">
    Chaque signal perd la moitié de son poids tous les quatorze jours. Un
    signal d'achat B2B reste vif une quinzaine de jours, puis se discute. Une
    visite de la page Tarifs d'il y a deux mois ne pèse presque plus rien.
  </Accordion>

  <Accordion title="Une fenêtre de 90 jours" icon="calendar-xmark">
    Au-delà de trois mois il ne reste qu'environ 1 % du signal : il est ignoré
    plutôt que traîné.
  </Accordion>
</AccordionGroup>

<Warning>
  **Le score bouge sans qu'aucune visite ne survienne.** La décroissance est
  fonction du temps écoulé : une entreprise inactive voit son `intentScore`
  baisser toute seule, à chaque lecture. Ne concluez pas d'une baisse qu'un
  événement s'est produit.
</Warning>

## `intentLevel` — la température

Trois paliers, dérivés du score :

| Palier | `intentScore` |
| ------ | ------------- |
| `hot`  | 75 et plus    |
| `warm` | 45 à 74       |
| `cold` | moins de 45   |

Ces seuils sont les mêmes partout dans le produit. Si vous devez trier ou
filtrer, utilisez `intentLevel` plutôt que de recoder vos propres bornes :
elles resteraient alignées sur l'application.

## `commercialScore` — la synthèse

C'est la moyenne pondérée de `icpScore` et `intentScore`. Le poids est réglable
par workspace, dans **Administration → ICP & scoring** : privilégier le profil
convient à une vente à cycle long, privilégier l'intention à une vente
réactive.

## Ce que ces scores ne sont pas

<Warning>
  **Ils ne sont pas comparables d'un workspace à l'autre.** Ils dépendent
  entièrement de votre configuration de scoring : vos secteurs cibles, vos
  tailles cibles, vos pays, vos règles de pages, et votre pondération.
  La même entreprise obtient des notes différentes chez deux clients
  SpotTracker. Un score n'a de sens qu'à l'intérieur de votre workspace.
</Warning>

Ils ne sont pas non plus une probabilité de conversion. Ce sont des outils de
**priorisation** : ils répondent à « qui rappeler en premier aujourd'hui »,
pas à « quelle est ma chance de signer ».

## Conséquence pour vos intégrations

* **Ne mettez pas un score en cache longtemps.** Il est recalculé à chaque
  lecture ; une valeur d'hier est déjà fausse.
* **Ne calibrez pas de seuils sur les chiffres bruts.** Si vous changez votre
  configuration de scoring, tous les seuils codés en dur dans vos scripts
  deviennent faux du jour au lendemain. `intentLevel` suit, lui.
* **Ne triez pas côté client.** Les collections arrivent déjà triées par
  `intentScore` décroissant.

<Card title="Référence des champs" icon="code" href="/reference/lister-les-entreprises" horizontal>
  Le détail de chaque champ renvoyé, schéma par schéma.
</Card>