> For the complete documentation index, see [llms.txt](https://doc.api-engagement.beta.gouv.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.api-engagement.beta.gouv.fr/annoncer-des-missions/tracking-des-candidatures/cas-n-1-votre-site-internet-recueille-lui-meme-les-candidatures/introduction-comment-fonctionne-le-tracking-de-lapi-engagement.md).

# Introduction : comment fonctionne le tracking de l'API Engagement ?

Le tracking repose sur une chaîne en trois étapes :

1. **URL trackée** : l'utilisateur arrive sur votre site via un lien fourni par l’API Engagement au site diffuseur, qui contient un paramètre `?apiengagement_id=…`.
2. **Cookie déposé** : le JSTag lit ce paramètre et dépose un cookie `apiengagement` (valable 30 jours).
3. **Événement déclenché** : quand votre code appelle `trackApplication` / `trackAccount`, l'appel vers API Engagement ne part **que si le cookie est présent**.

Sans cookie, `trackApplication()` et `trackAccount()` ne font rien : aucune erreur, aucune requête réseau. C'est le problème le plus courant lors des tests de l'intégration ; Si vous ouvrez directement votre page sans passer par une URL trackée, aucun cookie n'est posé, donc rien n'est envoyé. Cela ne signifie pas que votre code est incorrect.

### Le cookie `apiengagement`

| Attribut        | Valeur                                                             |
| --------------- | ------------------------------------------------------------------ |
| Nom             | `apiengagement`                                                    |
| Valeur          | l'identifiant de clic (`apiengagement_id`) reçu dans l'URL trackée |
| Durée de vie    | 30 jours                                                           |
| Domaine         | votre domaine (`www.exemple.fr` → `.exemple.fr`)                   |
| Path / SameSite | `/` · `Lax` · `Secure`                                             |
| Posé par        | le JSTag, dès qu'il détecte `?apiengagement_id=…` dans l'URL       |

Le cookie fait le lien entre le clic d'origine et la candidature. Tant qu'il est présent (jusqu'à 30 jours après le clic), `trackApplication` / `trackAccount` enverront l'événement.