> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metronome.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Envoyer des événements d'usage depuis Segment
Configurez et ingérez des événements dans Metronome avec [Segment](https://segment.com/).
## Configuration initiale
1. Depuis la page **Segment Destinations**, cliquez sur **Add Destination**. Recherchez et sélectionnez **Metronome (Actions)** dans le **Destinations Catalog**.
2. Cliquez sur **Configure Metronome (Actions)**, sélectionnez la source à laquelle vous souhaitez vous connecter et donnez un nom à la destination (par exemple, *Metronome Instance #1*).
3. Entrez votre token d'API Metronome dans le volet **Settings** dans la case **API Token** et enregistrez les modifications.
## Mapping des champs de données
Mappez vos événements Segment au format d'événement d'usage Metronome. Les cinq champs listés sont les champs requis pour Metronome. Pour commencer, cliquez sur l'onglet **Mappings** en haut du volet **Settings**. Vous disposez d'un ensemble de mappings par défaut. Pour les ajouter ou les modifier, choisissez **Edit Mapping** dans le menu déroulant des points de suspension.
**TOUS LES MAPPINGS SONT REQUIS**
Vous devez spécifier un mapping même si le nom de la propriété ne diffère pas entre l'événement Segment et le payload Metronome.
Les champs requis pour Metronome sont :
* `transaction_id` (string) - identifiant unique pour chaque événement
* `customer_id` (string) - à quel client dans Metronome l'événement s'applique
* `timestamp` (string) - quand l'événement s'est produit, au format [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt)
* `event_type` (string) - le type d'événement, par exemple `page_view` ou `cpu_used`
* `properties` (object) - paires clé/valeur avec les détails de l'événement
Si votre appel `track` ressemble à :
```javascript theme={null}
analytics.track('billing_event', {
cid: '533c3db43f22',
data: {
action: 'runJob',
jobId: 'fd82-aa0f-45a7-a756',
username: 'jsmith'
},
t: 'user_action',
ts: new Date('2020-04-02T00:10:25.000Z')
});
```
alors votre mapping de champ doit être :
**TRANSACTION ID REQUIS**
Les événements d'usage Metronome exigent le champ `transaction_id` pour s'assurer que tous les événements sont traités exactement une seule fois. Le mapping par défaut utilise le [champ `messageId` de Segment](https://segment.com/docs/guides/duplicate-data/) comme `transaction_id` Metronome. C'est probablement idéal pour la plupart des utilisateurs, mais si vous souhaitez contrôler manuellement le `transaction_id` Metronome, vous pouvez fournir un mapping vers n'importe quel champ de l'événement Segment.
## Destination Actions supplémentaires
L'intégration prend en charge les [Destination Actions](https://segment.com/docs/connections/destinations/#destination-actions), permettant aux utilisateurs de créer des *souscriptions*. Cela signifie que la destination Metronome (Actions) envoie des données à Metronome en fonction d'un ensemble de conditions appelées *triggers*. Créez des triggers et mappings supplémentaires en cliquant sur le bouton **New Mapping** dans le volet **Mapping**. Vous pouvez définir un trigger pour un nombre quelconque de conditions. Par exemple, créez une condition pour déclencher les événements vers Metronome uniquement lorsque le champ `User ID` n'est pas une adresse e-mail de votre entreprise (ne contient pas `@company.com`).
