Set up and ingest events into Metronome with Segment.
- From the Segment Destinations page, click Add Destination. Search for and select Metronome (Actions) within the Destinations Catalog.
- Click on Configure Metronome (Actions), select the source you'd like to connect to, and give the destination a name (for example, Metronome Instance #1).
- Enter your Metronome API token on the Settings pane in the API Token box and save changes.
Data field mapping
Map your Segment events to the Metronome usage event format. The five fields listed are the required fields for Metronome. To start, click on the Mappings tab at the top of the Settings pane. You have a set of mappings by default. To add to or change them, choose Edit Mapping from the ellipsis dropdown.
It is required to specify a mapping even if the property name does not differ between the Segment event and the Metronome payload.
The required fields for Metronome are:
transaction_id(string) - unique identifier for each event
customer_id(string) - which customer in Metronome the event applies to
timestamp(string) - when the event happened in RFC 3339
event_type(string) - the kind of event, for example
properties(object) - key/value pairs with details of the event
track call looks like this:
ts: new Date('2020-04-02T00:10:25.000Z')
then your field mapping should look like this:
Metronome usage events require the
transaction_id field to ensure all events are processed exactly once. The default mapping uses the Segment
messageId field as the Metronome
transaction_id. This is probably ideal for most users, but if you want to control the Metronome
transaction_id manually, you can provide a mapping to any field in the Segment event.
Additional Destination Actions
The integration supports Destination Actions, allowing users to create subscriptions. This means that the Metronome (Actions) destination sends data to Metronome based on a set of conditions known as triggers. Create additional triggers and mappings by clicking on the New Mapping button on the Mapping pane. You can set a trigger for any number of conditions. For example, create a condition to trigger events to Metronome only when the
User ID field is not an email address from your company (does not contain