Connecting Facebook
Adding the Data Source
-
Go to the Setup Settings
-
Follow the instructions in the article How to Connect a Direct Data Network Connection to begin the process of making the Network connection
-
As in step "7" in the above, linked article you will be presented with a pop-up window to authenticate with the required credentials and also allow the appropriate permissions
In some cases, there are programmatic ways to find the requested credentials. Ultimately you may have to contact the data source provider to obtain the credentials. We try to advise or help direct you to the credentials when we can.
Click the "Add Network" button near the bottom right
Connecting Advertiser-Specific Integration Data to a NinjaCat Account
- Follow the instructions in the article How to Add a Single Data Connection to a NinjaCat Account to begin the process of making the client-specific data connection
- Fill in the required fields on the Connect Data Source page by using the provided drop-down menus or by typing in the requested credentials or information
Click "Connect" near the bottom right
Connecting the Meta Network is required to connect Meta/Facebook Ads AND/OR Facebook Insights. When connecting at the Advertiser Level you select the desired Facebook marketing platform for the specific Advertiser.
If you need to connect multiple instances of the same data source to one account follow the steps in the article How To Add Multiple Instances of a Single Data Source
Controlling Attribution Windows in the NinjaCat Template Builder
-
Access the NinjaCat Template Builder
-
Select the desired widget from the widget browser
-
After selecting the provider "Facebook" as the data source the "Action Attribution Window" selection dropdowns will be available for "view" and "clicks"
-
The windows available are:
- Default
- 1 Day
- 7 Day
- 28 Day
- None
Campaign Filtering
Facebook Ads connections support flexible campaign filtering, letting you scope a connection to a subset of campaigns from a larger shared Facebook ad account. Filtering is applied at the API level, which can improve dashboard load times.
Where to Find It
Campaign filtering is configured on each Facebook Advertiser Network Connection within an account.
Note: Campaign filtering was previously located under Account > More Actions > Advanced. That location has been removed. Filters are now managed directly on the connection itself.
Match Types
| Match Type | Behavior |
|---|---|
| Exact | Campaign name must match exactly |
| Contains | Campaign name must contain the specified text |
| Regex | Campaign name must match the regular expression |
To remove filtering entirely, delete the filter configuration from the connection.
Setup Notes
- Filter values can be selected from a list of available campaigns or entered manually.
- A Test function is available during setup — it previews both the full list of available campaigns and the subset that the current filter will return, before you save.
- Validation is enforced to prevent invalid configurations (e.g., blank filter values, malformed regex patterns).
Bulk Management
Campaign filter configuration can also be managed at scale through the Bulk Manager via the Advanced Settings (JSON) CSV field. See the Bulk Management Datasource Connections page for details.