Welcome to Measurely! This guide will walk you through creating your first application, setting up your first metric, and sending data programmatically using our API. Let’s get started!

Step 1: Create Your First Application

Log in to the Measurely Dashboard:Head to Measurely Dashboard and log in using your preferred authentication method (GitHub, Google, etc.).

Create an Application:

• Provide a name for your new application
• Add an image (optional)
• Click on the Create Application button.

Step 2: Define Your First Metric

Navigate to the Metrics Section:

• Within your application, click on Create Metric.

Create a Metric:

• Click on Add Metric and define the following:

  • Type: Select a metric type (e.g., basic, dual). More are on the way
  • Metric Name: Choose a meaningful name (e.g., users).
  • Base Value: Provide a base value for your metric. (optional)

• Click Create to add the metric.

Step 3: Set Up Your Code to Send Metrics

Now that your application and metric are ready, it’s time to integrate Measurely into your codebase.

Get Your API Key

• Click on the API Key button at the top of the page.
• Copy the API Key provided there.

Get Your Metric Id

• Navigate to the metrics page
• Click on the 3 dots of your newly created metric
• Click on Copy ID

Example: Sending Metrics Using cURL

Here’s a simple example of how to send data to Measurely:

curl -X POST https://api.measurely.dev/event/v1/YOUR_METRIC_ID \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "value": 42
}'

Example: Sending Metrics Using Javascript

If you’re using javascript, here’s an example:

export const updateMetric = async (API_KEY, METRIC_ID, value) => {
  const response = await fetch(`https://api.measurely.dev/event/v1/${METRIC_ID}`, {
    method: 'POST',
    headers: {
      'Authorization' : `Bearer ${API_KEY}`
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ value: value }),
  });
  return response.status;
}

You can find more language examples in the documentation

Step 4: View Your Metrics in the Dashboard

Go to the Metrics Tab:

• Navigate to your application’s Metrics tab.
• You should see your metric and the value you just sent. Visualize Your Data:
• Use the built-in charts and filters to analyze your metrics over time.

Conclusion

You’ve successfully set up your first application, created a metric, and sent data to Measurely. From here, you can start adding more metrics, integrating Measurely deeper into your workflow, and gaining valuable insights.

Don't hesitate to leave a feedback :)
Need help? Check out our documentation or contact support at [email protected].