Passer au contenu principal
Dans Metronome, les clients sont les destinataires d’une facture et peuvent représenter des utilisateurs individuels, des entreprises, des clés API ou toute spécification dont votre organisation a besoin. Ce guide décrit comment créer un client dans Metronome. La création de votre client comprend la création de l’objet client et la configuration des configurations de facturation associées facultatives.
INFOUn client doit avoir au moins un contrat provisionné pour commencer la tarification de la facturation. Vous pouvez également configurer plusieurs contrats par client, si nécessaire.

​
Créer un client

Créez un objet client individuel dans Metronome ou construisez un flux pour créer des clients programmatiquement à partir de déclencheurs système.

​
Comprendre les alias d’ingestion

Les alias d’ingestion mappent vos identifiants client internes à l’ID client de Metronome. Lorsque vous envoyez de l’usage indexé sur un alias d’ingestion, Metronome l’associe automatiquement au bon client Metronome. Cela vous permet de maintenir vos entités client existantes sans avoir besoin de basculer vers un ID client Metronome. Les alias d’ingestion peuvent également être utilisés pour maintenir une hiérarchie de comptes. Les clients entreprise ont souvent des sous-organisations qui se rattachent à un seul contrat. Utilisez les alias d’ingestion pour modéliser cela. Par exemple, vous pouvez représenter l’organisation entreprise comme un client dans Metronome, avec chaque sous-organisation représentée par un alias d’ingestion attaché à ce client : 
Parent Account - Metronome Customer e7f893e5-07f7-483b-8c16-6905944c6a89  
  + Sub-Org 1 - IngestAlias1  
  + Sub-Org 2 - IngestAlias2  
  + Sub-Org 3 - IngestAlias3  
  + Sub-Org 4 - IngestAlias4
Vous pouvez répartir l’usage de chaque sous-organisation sur la facture que Metronome génère. Apprenez à utiliser les clés de groupe pour modifier la présentation des factures. Les alias d’ingestion peuvent être spécifiés sur l’objet client Metronome au moment de la création ou à tout moment après. Ajouter rétroactivement un alias d’ingestion au client est un moyen de retirer Metronome du chemin critique de l’inscription du client tout en mesurant correctement l’usage. Par exemple, si vous envoyez d’abord de l’usage indexé sur IngestAlias1 et que vous ajoutez plus tard cet alias d’ingestion à un client existant, Metronome associe rétroactivement cet usage au bon client.

​
Créer un client avec l’application Metronome

Pour créer un client avec l’application :
  1. Allez à la page Customers → Add a customer.
  2. Ajoutez un nom.
  3. Ajoutez un alias d’ingestion.
  4. (Facultatif) Définissez un champ personnalisé pour le client dans l’onglet Settings.

​
Construire un flux de création de client avec l’API

Utilisez l’API Metronome pour créer un flux permettant de créer des clients dans Metronome programmatiquement, basé sur des mouvements pilotés par les ventes ou par le produit. Pour un mouvement piloté par les ventes, vous pouvez utiliser Salesforce CPQ pour capturer des opportunités. Lorsqu’une opportunité est conclue, vous pouvez planifier une tâche pour créer un client à l’aide de l’API Metronome. Cet exemple de requête montre comment :
  • Créer un client fictif, WidgetsExpress, dans Metronome
  • Codifier la relation entre le client Metronome et le compte SFDC en stockant le sfdc_account_id dans un champ personnalisé
curl https://api.metronome.com/v1/customers \  
  -H "Authorization: Bearer <TOKEN>" \  
  -H "Content-Type: application/json" \  
  -d '{  
    "ingest_aliases": [  
      "team@widgetsexpress.com"  
    ],  
    "name": "WidgetsExpress",  
    "custom_fields": {  
      "sfdc_account_id": "sfdc1001"  
    }  
  }'
Pour un mouvement de croissance piloté par le produit, créez un workflow similaire où le déclencheur provient d’une inscription sur votre site web. Stockez la relation entre le client Metronome et votre objet client interne.

​
Ajouter une configuration de facturation à un client

Un client dans Metronome peut être facturé à différentes destinations, souvent en fonction de votre mouvement de facturation. Vous devez d’abord créer une customer_billing_provider_configuration sur le client puis l’affecter à un contrat. Metronome vous permet de configurer plusieurs customer_billing_provider_configurations par client, ce qui signifie qu’un client peut être facturé dans plusieurs systèmes — un par contrat.
INFOAvant de configurer une customer_billing_provider_configuration, Metronome doit d’abord être connecté au système pertinent. Suivez les étapes dans Facturer avec Stripe ou Facturer avec les marketplaces (AWS et Azure).
Metronome recommande de définir les customer_billing_provider_configurations lors de la création du client. Par exemple, supposons que WidgetsExpress a acheté votre produit via AWS Marketplace. Modifiez l’appel précédent pour ajouter une customer_billing_provider_configurations au client WidgetExpress : 
curl https://api.metronome.com/v1/customers \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "ingest_aliases": [
      "team@widgetsexpress.com"
    ],
    "name": "WidgetsExpress",
    "custom_fields": {
      "sfdc_account_id": "sfdc1001"
    },
    "customer_billing_provider_configurations": [
      {
        "billing_provider": "aws_marketplace",
        "configuration": {
          "aws_customer_id": "ABC123ABC12",
          "aws_product_code": "my_product",
          "aws_region": "us-west-1"
        },
        "delivery_method": "direct_to_billing_provider"
       }
    ]
  }'
Après soumission, le client sera créé avec la configuration AWS associée. Cependant, il ne sera pas facturé à AWS tant qu’un contrat n’est pas créé avec AWS défini comme billing_provider_configuration du contrat. Si vous ne définissez pas de customer_billing_provider_configuration lors de la création du client, vous pouvez en ajouter une plus tard à l’aide du point de terminaison /setCustomerBillingProviderConfigurations.
BÊTAVous pouvez archiver une customer_billing_provider_configuration soit en archivant le client, soit en archivant la configuration spécifique via le point de terminaison /archiveCustomerBillingProviderConfigurations. Lorsque vous archivez une configuration de facturation, elle devient disponible pour être réutilisée sur un nouveau client. Si vous archivez une customer_billing_provider_configuration qui est attachée à un contrat actif, la configuration sera immédiatement archivée sur le contrat et ne facturera plus à la destination associée. Une nouvelle billing_provider_configuration ne peut pas être provisionnée sur le contrat.