Overview: Query Builder for Facebook Ads (Pixels)
How to access the Query Builder for Facebook Ads (Pixels)
Navigate to Metrics > Query Builder to access the Query Builder for Facebook Ads. Click the green + Create Custom Metric button and select your connected Facebook Ads Account from the Data Source drop-down list. Select the Pixel radio 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 Facebook Ads (Pixels)
A
Custom Query Name:
Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.
B
Pixel: Select a Pixel from your connected Facebook Ads Account
C
Metric: Select a Metric from your connected Facebook Ads Data Source, such as "Custom Conversions" or "Events Received by URL."Selecting certain Metrics - like
Custom Conversions - will expose additional fields - like
Custom Conversion - so you can further specify your Metric selection.
D
Date Range: Select up to 8 Date Ranges that will be available for the Custom Metric. The Date Ranges selected are the only periods of time that data is synced for this Custom Metric.
E
Data Preview: After clicking
Run query, 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 tabs at the top of the Data Preview.
How to create a Custom Pixel Metric [Example]
In this example, we'll create a Custom Metric to report on Custom Conversions tracked by our Thank You Page.
1
Navigate to
Metrics > Query Builder
2
Click the green
+ New query button
3
Select the appropriate Facebook Ads Data Source
4
Select the
Pixels radio button
5
In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric "Custom Conversions: Thank You Page"
6
Since we want to track a custom conversion, we'll select
Custom Conversions from the
Metric drop-down list
7
After selecting
Custom Conversions as the Metric, a new field is exposed called
Custom Conversion. We'll click on this drop-down and will select
TY Page as the specific conversion
8
Next, we'll select the Date Range options for our Custom Metric. We will choose
Week to Date, Month to Date, Quarter to Date, and
Year to Date
9
Click
Run query to generate a Data Preview of the Custom Metric.
10
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 Pixel Metric to a Databoard
1
Open the selected Databoard in the Databox Designer, or create a new Databoard.
2
Drag and drop a blank Datablock onto the Databoard from the Visualization Library.
3
Select the appropriate Facebook Ads Data Source in the righthand Property Manager. This must be the same Facebook Ads Account that was selected when creating the Custom Metric.
4
Select the
Custom tab at the top of the
Metric drop-down list.
5
Select the Custom Metric name to populate the Datablock.
Additional Information
- When you create a new Custom Metric using the Query Builder for Facebook Ads (Pixels), 24 months of historical data is available. Because of this, "Last Year" may not initially display a comparison percentage.
- There can be API delays of up to 4 days for Custom Conversions. Meaning, if you compare the Facebook Ads UI with Databox, there can be delayed data in Databox.
- Learn how to verify Custom Conversion data in Databox vs Facebook Ads here.
- Due to technical limitations, it is not currently possible to filter Custom Conversions by Ad, Campaign, or other Dimensions using the Query Builder for Facebook Ads (Pixels).
