Skip to main content

How do I create Emma metrics?

Updated

Visualize, discover, and act on your email marketing data by creating Emma data feed metrics.

Connecting PowerMetrics to your Emma data

When connecting PowerMetrics to your Emma data, you'll be asked to enter your Emma Public Key and Private Key. When writing queries, you'll need to enter your Emma Account ID and, depending on the query, your Mailing ID.

Finding your Emma Public Key and Private Key

  1. Log in to your Emma account.
  2. Click on your Account Name on the top right corner.
  3. From the dropdown menu, select Account.
  4. Select API Key.
  5. Copy your Public Key and retrieve your Private Key from your records.
    Note: Private Keys are only displayed in Emma when initially generated. If you lose your Private Key, you can regenerate a new key pair (Public and Private) in Emma.

Finding your Emma Account ID

  1. Log in to your Emma account.
  2. Click on your Account Name on the top right corner.
  3. From the dropdown menu, select Account.
  4. Under Account ID, copy your ID number.

Finding your Mailing ID

  1. In the left navigation sidebar, click the + button beside Metrics and select See all services.

  2. On the Where is your data? page, under Data Feed Services, select Emma.
  3. Click +New data feed > Select Emma data.
  4. On the Choose a pre-built or custom connection page, select the Mailings pre-built data source.
  5. Enter your Emma Public Key and Private Key, then click Continue.
  6. Enter your Emma Account ID.
  7. Click Get data.
  8. Copy your Mailing ID from the query results.

Creating Emma data feed metrics

When you create Emma data feed metrics, you:

Connecting to your Emma account and adding a data feed

Every metric needs a data feed. As you create metrics, you’ll either create a new data feed or select one from your list of existing data feeds. Learn more about data feeds.

To create a new data feed for your metric:

  1. In the left navigation sidebar click the + button beside Metrics and select See all services.
  2. On the Where is your data? page, under Data Feed Services, select Emma.
  3. Click +New data feed > Select Emma data.
  4. Select a pre-built data source from the left section of the Choose a pre-built or custom connection page or click +Create a custom Emma data source.
  5. On the Configure data service page, enter your Emma Public Key and Private Key. Click Continue.
  6. If you chose a pre-built data source for your data feed:
    • At Query URL, the query is prefilled based on the pre-built data source you chose in the previous step. Replace the information at <accountID> as directed.
    • Optionally, continue to modify the query to return the data you're looking for. Refer to the Emma API documentation for assistance.
  7. If you chose a custom-built data source for your data feed:
    • At Query URL, edit the query to return the data you're looking for, replacing <accountID> with your own information. Refer to the Emma API documentation for assistance.
  8. Click Get data.
  9. Ensure this is the data you’re looking for. Then, click Continue. Next step - refine the data in the data feed editor.

To use an existing data feed for your metric:

  1. In the left navigation sidebar, click Data Feeds.
  2. In your list of Data Feeds, select the one you want to use for your metric.
  3. Click the Metrics tab in the right-side pane.
  4. Click +Add metric and proceed to Configuring your metric.

Refining data in the data feed editor

You’ve arrived in the data feed editor where you can choose to either accept the automatic settings or make changes.

If you’re happy with the automatic settings:

If you want to make changes:

  • Emma returns data in a JSON format. The method for refining and editing JSON source data is slightly different than when dealing with source data that’s already in a tabular format. Learn how to refine and edit JSON source data feeds.
  • Some common adjustments include changing the data format or names for columns, updating the data feed name, and combining columns using formulas - there are many customization options available.
  • If you want to adjust the original query, click the tile under Data service.
  • When you’re finished editing the data feed, click Save data feed and proceed to Configuring your metric.

Note: After you’re finished creating a metric with this data feed, you can return to it and use it to make more data feed metrics. In the left navigation sidebar, click Data Feeds. Select the desired data feed from the list and click +Add metric.

Configuring your metric

When you configure a data feed metric, you select the measure and dimensions from the data feed to include in the metric and choose settings that determine how the data will be visualized. Go here for detailed instructions on configuring your metric.

Next steps – Interacting with your data

Now that you're connected and have some metrics, it's time to start learning from your data and tracking your progress.

Here are a few suggestions for interacting with your data:

Related articles