Enregistrer l'utilisation dans le Dashboard

Comment enregistrer les données d'utilisation de vos clients dans le Dashboard manuellement ou à l'aide d'un fichier CSV

Vous devez enregistrer l’utilisation dans Stripe pour facturer à vos clients les montants correspondant à leur consommation à chaque période de facturation. Pour enregistrer l’utilisation, vous pouvez ajouter manuellement des données d’utilisation ou charger un fichier CSV contenant les données d’utilisation dans le Dashboard. Stripe analyse, valide et transforme les données d’utilisation en événements de mesure.

Une fois les événements chargés, vous pouvez les voir dans le flux de mesure réel. Vous pouvez vérifier l’état de vos fichiers chargés sur la page Gestion des données.

Ajouter des données d’utilisation manuellement

Vous pouvez ajouter manuellement des données d’utilisation sur la page Dispositifs de mesure dans le Dashboard Stripe.

Sur la page Dispositifs de mesure, sélectionnez le nom du dispositif.
Sur la page du dispositif, cliquez sur Ajouter des données de consommation > Saisie manuelle des données de consommation.
Dans la page Ajouter des données de consommation, procédez comme suit :
- Sélectionnez votre client dans la liste déroulante Client.
- Pour Valeur, saisissez un exemple de valeur.
- Cliquez sur Envoyer.

Charger un fichier CSV contenant des données d’utilisation

Une fois votre fichier CSV préparé avec les données d’utilisation, vous pouvez le charger dans le Dashboard Stripe. Assurez-vous de formater votre fichier pour qu’il corresponde au modèle disponible dans le Dashboard. La taille de fichier maximale autorisée est de 5 Mo.

Format et champs du fichier CSV

Veillez à ce que votre fichier CSV respecte l’exemple de format de fichier suivant :

`timestamp`	`event_name`	`payload_stripe_customer_id`	`payload_value`
2024-09-25	ai_search_api	cus_QMJJtcu70R1x46	400
2024-09-26	ai_search_api	cus_GAXJtSu6021a6s	600
2024-09-27	cpu_usage	cus_Qz0fwcfSysB9Z3	600

Suivez le modèle de l’événement de mesure lorsque vous incluez les champs suivants dans votre fichier :

Champ	Description
`timestamp`	Date à laquelle l’événement s’est produit. Nous prenons en charge les formats d’horodatage suivants : `yyyy-MM-dd` : par exemple, `2024-09-23`. `yyyy-MM-dd'T'HH:mm:ssZ` : par exemple, `2024-09-23T16:22:25+0530`. `Epoch` : par exemple, `1727108545`.
`event_name`	Nom de l’événement de mesure.
`payload_stripe_customer_id`	Le ID client pour lequel l’événement est créé. Vous pouvez obtenir les informations concernant `customer_id` sur la page Clients.
`payload_value`	Valeur numérique d’utilisation de l’événement de mesure, par exemple le nombre d’heures à facturer. Si vous avez spécifié une clé différente dans `value_settings`, vous devez mettre à jour le nom de la colonne pour qu’il corresponde à la valeur de la clé. Par exemple, si vous spécifiez `tokens` dans `value_settings`, basculez le nom de la colonne sur `payload_tokens`.

Charger votre fichier CSV

Si votre fichier contient des erreurs, vous pouvez télécharger un fichier d’erreurs comportant le motif de l’échec pour chaque enregistrement concerné. Une fois les erreurs corrigées, vous pouvez télécharger le fichier mis à jour.

Sur la page Dispositifs de mesure, sélectionnez le nom du dispositif auquel vous souhaitez ajouter des événements d’utilisation.
Sur la page du dispositif, cliquez sur Ajouter des données de consommation > Charger des données de consommation.
Sur la page Charger des données de consommation, sélectionnez votre fichier.
Cliquez sur Charger un fichier.
Vérifiez le nombre d’événements de mesure et la valeur agrégée sur la page du dispositif de mesure.