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

# Suivi des conversions

> Suivez les inscriptions, les démos et les achats sur votre site avec le SDK JavaScript de Scribe et attribuez chaque conversion à la signature e-mail qui l'a générée.

Le suivi des conversions boucle la boucle sur vos signatures e-mail. L'analyse des signatures vous montre déjà les vues et les clics. Avec le SDK JavaScript de Scribe, vous enregistrez aussi ce qui se passe ensuite sur votre propre site — inscriptions, démos réservées, achats — et vous rattachez chacune de ces actions à la signature, au collaborateur et au lien qui l'ont générée. C'est le bas du funnel : vues, puis clics, puis conversions.

Dans Scribe, ces conversions s'appellent des **événements**. Vous les enregistrez en quelques lignes de JavaScript, et Scribe les attribue automatiquement grâce au même suivi des clics qui alimente le reste de votre analyse.

<Note>
  Le suivi des conversions est disponible sur les forfaits payants. Si le forfait de votre espace de travail ne l'inclut pas, le snippet de suivi n'enregistre rien.
</Note>

## Fonctionnement

1. Un destinataire clique sur un lien dans l'une de vos signatures e-mail.
2. Scribe le redirige vers votre site et ajoute un paramètre `scribe_click_id` à l'URL de destination.
3. Le SDK Scribe présent sur votre page d'atterrissage lit ce `scribe_click_id`, le stocke en first-party et le rattache à chaque événement que vous enregistrez.
4. Quand le visiteur convertit, vous appelez `scribe.track('signup')`. Scribe relie l'événement au clic d'origine.

Résultat : vous voyez quelles signatures, quels collaborateurs et quels éléments cliqués génèrent de vraies conversions et du chiffre d'affaires, pas seulement des clics. L'attribution fonctionne au niveau de l'expéditeur, de la signature et de l'élément, et Scribe rapproche une conversion d'un clic jusqu'à 30 jours après le clic.

Si un événement arrive sans `scribe_click_id` connu (trafic direct, lien expiré ou paramètre supprimé), il est tout de même enregistré. Il n'est simplement pas attribué à un clic.

## Avant de commencer

Vous avez besoin de trois éléments :

* **Un forfait payant** qui inclut le suivi des conversions.
* **Le suivi activé** pour votre espace de travail. Il s'agit du même paramètre qui alimente les analyses de vues et de clics des signatures. Activez-le uniquement après avoir obtenu le consentement nécessaire (voir [Confidentialité et consentement](#privacy-and-consent)).
* **Votre Event Tracking ID.** Il s'agit d'un identifiant public et non secret pour votre espace de travail. Il peut être intégré en toute sécurité dans le HTML de votre site.

<Steps>
  <Step title="Copier votre Event Tracking ID">
    Dans Scribe, ouvrez **Settings**, allez dans l'onglet **Workspace** et copiez la valeur sous **Event Tracking ID**. Pendant que vous y êtes, vérifiez que **Tracking** est activé.
  </Step>

  <Step title="Ajouter le SDK à votre site">
    Utilisez l'extrait de script pour un site web classique, ou le package npm pour une application ou une single-page app. Les deux exposent la même API `scribe.track(...)`.

    **Option A. Extrait de script.** Ajoutez ceci à chaque page que vous souhaitez suivre, juste avant la balise fermante `</head>`. L'extrait s'initialise automatiquement depuis `data-workspace`, aucun appel à `init()` n'est donc nécessaire.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Option B. npm ou yarn.** Installez le package, puis initialisez-le une seule fois au démarrage de l'application.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    L'import du module n'a aucun effet de bord (il est sûr pour le rendu côté serveur). Rien n'est envoyé tant que vous n'appelez pas `init()`.
  </Step>

  <Step title="Enregistrer votre première conversion">
    Appelez `scribe.track` partout où une conversion se produit, par exemple dans votre gestionnaire de succès d'inscription.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    Le SDK capture pour vous l'attribution du clic Scribe depuis l'URL de destination, regroupe vos événements et les envoie de manière fiable, y compris lorsque le visiteur quitte la page.
  </Step>

  <Step title="Vérifier que tout fonctionne">
    Déclenchez l'événement sur votre site, puis ouvrez **Analytics** dans Scribe. Vos conversions apparaissent aux côtés des vues et des clics, ventilées par signature, collaborateur, campagne et pays.
  </Step>
</Steps>

## Référence du SDK

### `scribe.track(name, metadata)`

Enregistre un événement. `name` est requis, par exemple `signup`, `demo_booked` ou `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` et `event_id` sont des champs de premier niveau reconnus.
* **Toute autre clé** devient un élément des `properties` de l'événement. Limitez les propriétés à des valeurs scalaires simples (chaînes, nombres, booléens). N'incluez pas de données personnelles telles que des e-mails ou des numéros de téléphone dans les propriétés : Scribe supprime automatiquement les clés qui ressemblent à des données personnelles.
* Fournissez votre propre `event_id` pour rendre un envoi sûr à réessayer. Le même `event_id` reçu deux fois en 24 heures n'est enregistré qu'une seule fois.

### `scribe.identify(userId, traits)`

Associe le visiteur à l'un de vos propres utilisateurs, afin que vous puissiez voir quelles signatures acquièrent quels clients. Utile pour le B2B et les démarches basées sur les comptes.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Après un appel à `identify`, les appels `track` suivants sont liés à cet utilisateur. Appelez `scribe.reset()` à la déconnexion pour effacer l'identité.

### `scribe.flush()`

Les événements sont regroupés et envoyés automatiquement, ainsi qu'à chaque masquage de la page. Appelez `flush()` uniquement si vous devez forcer l'envoi immédiat du lot en cours.

### Attributs du snippet

Lorsque vous utilisez le snippet de script, configurez-le à l'aide des attributs `data-*` :

| Attribut             | Requis | Description                                                                                           |
| -------------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| `data-workspace`     | Oui    | Votre ID de suivi d'événements.                                                                       |
| `data-consent`       | Non    | Définissez sur `"denied"` pour désactiver le stockage propriétaire jusqu'au consentement du visiteur. |
| `data-cookie-domain` | Non    | Définissez votre domaine apex pour partager l'identité entre les sous-domaines.                       |

### Content Security Policy

Si votre site définit une Content Security Policy, autorisez les hôtes Scribe :

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  Vous devez enregistrer un événement faisant autorité depuis votre backend, par exemple un paiement confirmé par votre serveur ? Scribe accepte aussi les événements via l'API avec une clé API `events:write`, ce qui garantit la fiabilité des montants plutôt que de dépendre du client. Consultez la [référence de l'API](/api-reference/introduction) pour en savoir plus.
</Tip>

## Cas d'usage : transformez les conversions en croissance

Le suivi des conversions transforme vos signatures e-mail en canal d'acquisition mesurable. Voici comment les équipes exploitent ces données, y compris en les injectant dans le remarketing payant.

### Lancez des campagnes de remarketing sur Google Ads et Meta Ads

Déclenchez les pixels de conversion de vos plateformes publicitaires au même endroit où vous appelez `scribe.track`, pour qu'une seule conversion soit enregistrée simultanément dans Scribe, Google Ads et Meta. Scribe vous indique que la conversion provient d'une signature e-mail ; Google et Meta utilisent le même signal pour leurs enchères et leurs audiences.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Construisez des audiences de retargeting à forte intention

Les personnes qui ont cliqué sur votre signature et atteint votre site sans convertir sont des prospects chauds. Utilisez Scribe pour confirmer le trafic issu des signatures, puis reciblez ces visiteurs avec une offre adaptée sur Google et Meta. Comme ce trafic provient de vos propres e-mails, ces audiences convertissent mieux que la prospection à froid.

### Générez des audiences lookalike et similaires à partir de vos convertis

La meilleure audience de départ, ce sont les personnes qui ont déjà converti via un canal de confiance. Extrayez les visiteurs acquis par les signatures (filtrez par signature, collaborateur ou campagne), importez-les comme Custom Audience dans Meta ou comme liste Customer Match dans Google Ads, puis générez des audiences Lookalike ou Similar à partir de cette base de qualité.

### Excluez vos clients existants des dépenses d'acquisition

Arrêtez de payer pour acquérir des personnes déjà inscrites ou déjà clientes. Exportez vos convertis et ajoutez-les comme liste d'exclusion ou de suppression sur vos campagnes de prospection : votre budget se concentre alors sur les prospects réellement nouveaux.

### Optimisez pour le chiffre d'affaires, pas seulement pour les clics

Transmettez une vraie `value` et un `currency` à chaque conversion. Avec le chiffre d'affaires rattaché, vous pouvez basculer Google et Meta sur des enchères basées sur la valeur, et dans Scribe classer les signatures, les collaborateurs et les campagnes par le chiffre d'affaires généré plutôt que par les seuls clics.

### Prouvez la performance du canal et réallouez le budget

Le suivi des conversions vous permet de comparer le chiffre d'affaires généré par les signatures e-mail à celui de vos canaux payants, dans les mêmes termes. Quand une campagne de signature dépasse une campagne payante, vous avez les chiffres pour déplacer le budget vers ce qui fonctionne.

## Demandez à un agent IA de le configurer

Vous n'avez pas à tout câbler à la main. Si vous utilisez un assistant IA de code (comme Claude Code, Cursor ou un agent similaire dans votre éditeur), collez-lui un prompt de ce type, avec votre propre Event Tracking ID et les conversions qui vous intéressent :

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Une fois les conversions remontées, un agent connecté au [serveur MCP Scribe](/fr/ai-agents/connect) peut lire et expliquer les résultats à votre place. Posez-lui des questions comme « quelles signatures et quels collaborateurs ont généré le plus de conversions et de chiffre d'affaires ce mois-ci ? » ou « liste les visiteurs acquis par mes signatures cette semaine ». Consultez [Scribe pour les agents IA](/fr/ai-agents) et la [compétence analytique Scribe](/fr/ai-agents/skills) pour voir ce que votre assistant peut récupérer.

## Confidentialité et consentement

Le suivi des conversions est conçu pour respecter vos visiteurs et vos obligations :

* **Les adresses IP sont anonymisées.** Scribe hache l'IP avant de la stocker. Les IP brutes ne sont jamais conservées.
* **Aucune donnée personnelle dans les propriétés.** Les clés qui ressemblent à des données personnelles (e-mail, téléphone, mot de passe, jetons, numéros de carte et similaires) sont automatiquement retirées des propriétés d'événement. Utilisez `identify` lorsque vous souhaitez délibérément associer un utilisateur.
* **Stockage conditionné au consentement.** Définissez `data-consent="denied"` (snippet) ou `consent: false` (npm `init`) pour empêcher le SDK de stocker l'identifiant de clic tant que votre visiteur n'a pas donné son consentement.
* **Obtenez le consentement avant d'activer le suivi.** Le paramètre de suivi de l'espace de travail engage la même responsabilité que n'importe quel pixel analytique. Assurez-vous d'avoir le consentement requis dans votre région avant de l'activer.

## Articles associés

* [Vue d'ensemble des analytics](/fr/analytics-overview) : vues, clics, portée et CTR à l'échelle de votre espace de travail.
* [Tableau de bord analytics](/fr/analytics-dashboard) : consultez les conversions aux côtés des vues et des clics dans chaque onglet.
* [Analytics de signature](/fr/signature-analytics) : performance d'une signature individuelle.
* [Campagnes marketing](/fr/marketing-overview) : lancez et mesurez des campagnes de bannières dans les signatures.
* [Scribe pour les agents IA](/fr/ai-agents) : laissez un assistant configurer le suivi et rendre compte des conversions.