Overview: Query Builder for HubSpot Marketing (Workflows)


How to access the Query Builder for HubSpot Marketing (Workflows)

Navigate to  Metrics > Query Builder to access the Query Builder for HubSpot Marketing. Click the green + Create Custom Metric button and select your connected HubSpot Marketing Account from the Data Source drop-down list. Select the Workflows button. 

    Query Builder is available in Plus and Business Accounts. Agency Basic Accounts have access to Query Builder in the Agency Account only.  Request a trial of Query Builder by following these steps.  

How to use the Query Builder for HubSpot Marketing (Workflows)

  Data Source: This is the Data Source that the Custom Metric is syncing data from. 
  Workflow: Select a Workflow from your connected HubSpot Marketing Data Source.   
  Metric: Select a Metric from your connected HubSpot Marketing Data Source, such as "Active Enrolled," "Total Enrolled" or "Contact Performance." 
If you select "Contact Performance," the Dimension and Aggregation fields will be exposed. 
Dimension: Specify the contact performance that you want to track. Dimension options are "Completed Workflow," "Contacts Enrolled," and "Contacts Lost." 

Aggregation: Select the aggregation, which determines the buckets that the contacts are grouped into. This selection will determine how you can visualize your Custom Metric on a Chart. 

  Invert Metric (Optional): This checkbox should be selected if a lower Metric value indicates positive growth / performance (i.e., Unsubscribers, Cost per Conversion, etc.) Inverting the Custom Metric in Databox will make it so an increase in the Metric value will show a red percentage change color on a Databolock, while a decrease in the Metric value will show a green percentage change color on a Datablock.  
  Preview data: After clicking Preview data, a Data Preview of the Custom Metric will be displayed. Daily Metric values are displayed in this section, along with the total Metric values for the Date Range in bold at the bottom. You can view the Data Preview for different Date Ranges by clicking on the drop-down list at the top of the Data Preview.  
   Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.
   Save: Save your Custom Metric.

How to create a Custom Workflow Metric [Example]

In this example, we'll create a Custom Metric to return the number of Contacts who completed our Onboarding Workflow. 

 Navigate to Metrics > Query Builder   
 Click the green + New query button
 Select the appropriate HubSpot Marketing Data Source and the Workflows button
 We will select Onboarding Completed from the Workflow dropdown list
 Since we want to track Contacts who completed the Workflow, we'll select Contact Performance as the Metric and Completed Workflow as the Dimension
 We'll select WEEK as the Aggregation
 In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric  # Contacts Completed Onboarding Workflow
 Click Preview data to generate a Data Preview of the Custom Metric
 Once we confirm that these are the results we're looking for, we'll click Save to save the Custom Metric

How to add a Custom Workflow Metric to a Databoard

 Open the selected Databoard in the Databox Designer, or create a new Databoard.
 Drag and drop a blank Datablock onto the Databoard from the Visualization Library. 
 Select the appropriate HubSpot Marketing Data Source from the righthand Datablock Settings panel. This must be the same HubSpot Marketing Account that was selected when creating the Custom Metric. 
 Select the  Custom tab at the top of the  Metric drop-down list. 
 Select the Custom Metric name to populate the Datablock.

Additional Information

  • For "Contact Performance" Metrics created by this Query Builder up to 36 months of historical data can be synced with Databox.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us