Click on Add Data Widget or edit an existing one, and select Facebook Ads as Integration. 

After that, select your account and click on next.

In the second step, you select your Ad account, and afterward, you can choose your Campaign and Ad.

The steps for the campaign and ad are entirely optional and you can leave each of those fields blank if you wish to. 

Filtering by Platform

Let's say that we want to filter out and show the data for our Campaign performance but only on Instagram. 

For us to see how the platforms are named we will have to create a table widget that will have the (publisher) platform as a dimension. 

The fastest way we can do this is by creating a Standard widget which we will switch to a Custom one. 

After we create this widget we will get a table such as this one. 

For us to get the name of the dimension we will click on the i button to see the widget details. 

Now that we know that the filtering goes through publisher_platform we will use that and create a filter. 

Below the widget, there is a custom filter field. Here we can filter our data using Facebook Ads' API.

For this example, which is the campaign performance of the Instagram platform, - we will use this filter:

publisher_platform==(instagram) 

Important Notice: whenever you're applying certain filters, after the operators such as ==, != the filter variable has to be in brackets ( ). 

If we want to keep the same metrics as we already have in the table widget we can just switch the dimension from Publisher Platform to Campaign and get the same results but with a campaign overview. 

Or we can edit this existing widget, change it to Campaign Performance and then switch it to a custom one. 

This is how your Widget details will look like after the filter is correctly applied. 

You could have accomplished this same filter by using the NOT EQUAL operator. 

This filter works in a way that you can tell the API that you don't want to pull certain data. So that filter would look like this:

publisher_platform!=(facebook|audience_network|messenger) 

Filtering by Campaign Name

Let's say that you're running a lot of campaigns that all are separated by the name of the country. 

It would be a real bore if you needed to report on each country individually especially if there are different types of campaigns involved such as remarketing, prospecting, etc. 

Well you can accomplish filtering the data by the name of the campaign itself! 

You can, of course, do an exact match with the ==, but you can also use a Contains operator. 

But if we wish to include all campaigns from this widget that include the word USA in them we would need a filter that has a contains operator. 

And this is the filter we would use to get only the campaigns that contain the word USA in them.

campaign.name=~USA

So the widget would look like this:

Facebook Ads Operators

Here is a table with all the Facebook Ads operators that can be used in data filtering.

Reportz Custom filter allows you to combine multiple filters for Facebook Ads using AND and OR logic statements.

OR Operator

The OR operator is defined using a comma (,). It takes precedence over the AND operator and may NOT be used to combine dimensions and metrics in the same expression.

AND Operator

The AND operator is defined using a semi-colon (;). It is preceded by the OR operator and CAN be used to combine dimensions and metrics in the same expression.

Did this answer your question?