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

# Événements et conversions

> Ce que font vos utilisateurs, et ce que vos messages leur font faire.

Un **événement** est une action de l’utilisateur : `transfert_effectue`, `panier_valide`. Il nourrit la fiche utilisateur, les segments (« a fait X au moins N fois en J jours ») et les déclencheurs in-app.

Une **conversion** est un événement attribué au dernier push ou message in-app cliqué dans les 24 heures.

## Depuis l’application

```ts theme={null}
DexNotify.User.trackEvent("transfert_effectue", { montant: 25000 });
DexNotify.Session.addOutcome("inscription");
DexNotify.Session.addUniqueOutcome("premier_transfert");
DexNotify.Session.addOutcomeWithValue("achat", 5000);
```

## Depuis votre serveur

```bash theme={null}
curl -X POST https://api.dexnotify.com/api/v1/audience/events/by-external-id \
  -H "x-api-key: $DEXNOTIFY_CLE" -H "content-type: application/json" \
  -d '{
    "externalId": "client-48213",
    "events": [
      { "id": "commande-48213", "name": "commande_payee", "properties": { "montant": 25000 } }
    ]
  }'
```

`id` dédoublonne : un événement renvoyé avec le même `id` n’est compté qu’une fois.

## Lire

| Route | Rend |
| - | - |
| `GET /api/v1/events` | les événements du projet sur une fenêtre, avec l’écart à la précédente |
| `GET /api/v1/events/{name}/series` | occurrences et utilisateurs, jour par jour |
| `GET /api/v1/outcomes/overview` | conversions : totaux, canaux, série, par nom |
| `GET /api/v1/outcomes/messages` | les messages qui font convertir |

Le [webhook](https://docs.dexnotify.com/webhooks.md) `outcome.tracked` part à chaque conversion attribuée.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.