Skip to main content

​
Intro

Marketing experts use Facebook Ads to create targeted ads designed to reach different audiences and help them meet their business goals. Domo removes the guesswork from Facebook advertising by providing crucial insights into your campaigns. Create a customized Facebook dashboard with your most important KPIs, schedule automatic reports, or set up alerts for specific metrics. You can easily combine Facebook data with other social networks like Twitter, LinkedIn, Pinterest, and many more. Once your data is in Domo, you can give managers and decision-makers full visibility into critical Facebook metrics with a variety of collaboration and reporting features. You connect to your Facebook Ads Advanced Multi Accounts Connector in the Data Center. This topic discusses the fields and menus specific to the Facebook Ads Advanced Multi Accounts connector user interface. To add DataSets, set update schedules, and edit DataSet information, see Adding a DataSet Using a Connector and Powering up Multi Accounts Connectors.

​
Multi-Account Connector Vs Single Account Connector

Every Multi-Account connector has a corresponding single-account connector. For example, the Facebook Ads Advanced Multi Accounts connector has a corresponding Facebook Ads Advanced single Account connector. You might prefer to use the Facebook Ads Advanced Multi Accounts if the following are true:
  1. You have multiple Facebook Ads Accounts in Domo, OR you have a single Facebook Account in Domo and plan to add more Accounts later, AND
  2. You would like to import the data from one or more of these Accounts into a single dataset.
You might prefer to use the single Account version of this connector if you have one or more Accounts in Domo, and you would like to keep the data from each Account in a separate DataSet.

​
Credentials Pane

To connect to your Facebook Ads Advanced Multi Accounts connector and create a DataSet, you need to select at least one Facebook Ads Account in Domo from the drop-down list. To add a new Account in Domo, you need the email address or telephone number and the password associated with your Facebook account. For more information on selecting and powering the accounts, see Powering Up A Multi-Account Connector (this article explains the process of powering up multiple Connector Accounts and successfully creating a dataset). If a Facebook Account in Domo does not exist yet, you can add the Account by clicking Add Account to open the Facebook OAuth screen, where you can enter your Facebook credentials. Once you have entered valid Facebook credentials and have successfully authenticated, you can use the new Account any time you go to create a new Facebook Ads Advanced Multi Accounts DataSet or in the DataSet you are currently powering up. You can manage Connector Accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing Connectors Accounts.

​
Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the Facebook Ads Advanced Multi Accounts Ads report you want to run. The following reports are available:

Report Description

FBAds PreBuilt Report

Domo’s complimentary pre-built report for Facebook Ads - a comprehensive analysis of advertising performance including accounts, campaigns, ad groups, and ad-level reporting.

Ad Accounts

Returns information about one or more selected Facebook Ads Accounts.

Ad Campaigns

Returns information about one or more Ad Campaigns controlled by the selected Account(s) .

Ad Keyword Statistics (Deprecated)

Returns information about the Keywords used for targeting the selected Ad(s) .

Ad Sets

Returns information about one or more Ad Sets within the selected Ad Campaign(s) .

Ads

Returns information about one or more Ads defined in the selected Ad Set(s) .

Custom Insights

Returns user-selected insight information at a reporting level defined by the Level field.

General Metrics

Returns commonly-used insight metrics at the Campaign level.

Object Information - NEW

This new report enables you to retrieve the Info edge of the all the Account, Campaign, Ad set, or Ad objects associated with the Ad Accounts you select. Select the Ad Accounts and the object type you need information about.

Object Insights - NEW

This new report enables you to retrieve the Insights edge of the all the Account, Campaign, Ad set, or Ad objects associated with the Ad Accounts you select. Select the Ad Accounts and the object type you need insights about, and complete the other insight metrics.

Page Actions (Ad sets)

Returns insights related to Page and Post interactions at the Adset level.

Page Actions (Ads)

Returns insights related to Page and Post interactions at the Ad level.

Placement Metrics

Returns common metrics, broken down by screen placement, at the Campaign level.

Responder Demographics

Returns common metrics, broken down by age and gender, at the Adset level.
User Returns information about the authenticated user.

Select Object Type

Pick an object level to gather data. Domo reports all objects of the type contained in the accounts you have selected.

Effective Statuses

This field appears for the Object Information - NEW report when you select Campaign , Ad Set , or Ad as the Object Type.

Select the effective statuses to filter your data.

Time Increment

Select the granularity used to aggregate the data.

Duration

Choose whether the report should cover a Single Date or a Date Range .

Date From

Choose how you want to set the start date for the report.

  • Relative Date: Enter the number of days back from today.
  • Specific Date: Use the date picker to select a precise date.


For example, if you enter 10 for Date From Offset and five for Date To Offset, and you set the data source to update daily, each new day the report updates to show the information for five to 10 days in the past.

Date From Offset

Enter the number of days you want to go back from the current date. For example, enter 0 for today or 1 for yesterday.

Select Specific Date From

Select the precise start date for the report using the date picker. This option is only available when the Report Date is set to Specific.

Date To

Choose how you want to set the end date for the report.

  • Relative Date: Enter the number of days back from today.
  • Specific Date: Use the date picker to select a precise date.

Choose Relative if you always want the report to retrieve data for a given number of days back (which you specify in Date To Offset ) from the current date. If you choose Relative here, you should also choose Relative for Date From and specify a value for Date From Offset .
For example, if you enter 10 for Date From Offset and 5 for Date To Offset and you set the data source to update daily, each new day the report will update to show information for 5 to 10 days in the past.

Date To Offset

Enter the number of days you want to go back from the selected end date. For example, enter 0 for today or 1 for yesterday.

Select Specific Date To

Select the precise end date for the report using the date picker. This option is only available when the Report Date is set to Specific.

Report Date

Specify whether the report data is based on a fixed date or a relative number of days . A relative number of days indicates the retrospective period from which data will be retrieved. To retrieve data from a specific date, use the date selector.

Choose Relative if you always want the report to retrieve data for a given number of days back (which you specify in Date Offset ) from the current date.
For example, if you enter 5 for Date Offset and set the data source to update daily, each new day the updated report will show information for the date 5 days in the past.

Date Offset

Enter the number of days you want to go back from the current date. For example, enter 0 for today or 1 for yesterday.

Select Specific Date

To select a specific report date, use the date picker . This option is only available when the Report Date is set to Specific .

Columns

Select the columns.

Time Increment

Enter the number of days used to aggregate the data. This should be an integer between 1 and 90. You can also enter monthly to show data by month or all_days to show data for all days with data.

Level

Select the ad level for the report.

Conversion Type Selection

Select if you want to bring custom or standard conversions only.

Breakdowns

Select how you want the report data to be broken down.

Action Breakdowns

Select the desired action breakdown(s) for the report.

Include Archived Objects

If set to True then the Archived objects will be in the results. Otherwise, Archived objects will not be reported.

Action Attribution Windows

Select the desired action attribution windows for the report.

Reset Schema

Select this checkbox if you need to reset the schema.

Warning: This can result in loss of data or change in data type if some fields are temporarily not returned by Facebook’s API. While this checkbox is selected the dataset will reset the schema for each run. Do not use in the APPEND mode

Ad Account Edge

Edge Description
Ad Account Info Returns information about the selected account.
Activities Returns a log of the actions taken on the selected account.
Ad Campaigns Returns a list of ad campaigns for the selected account.
Ad Sets Returns a list of ad sets for the selected account.
Ads Returns a list of ads for the selected account.
Custom Audiences Returns the custom audiences owned by or shared with the selected account.
Insights Returns insight information for the specified criteria.
Partners Returns a list of ad partners for the selected account.
Rate Card Returns a list of currency rates.
Reach Estimate Returns the reach estimate for the selected account and given targeting spec.
Users Returns user IDs, permissions, and roles for the selected account.

Action Report Time

Determines the report time of action stats. For example, if a person saw the ad on Jan 1st but converted on Jan 2nd, when you query the API with action_report_time=impression, you see a conversion on Jan 1st. When you query the API with action_report_time=conversion, you see a conversion on Jan 2nd.
Expand List columns
Option Description
Expand as Columns List data will expand as multiple columns in the results.
Expand as Rows List data will expand into multiple rows in the results. This will result in many rows with duplicated data.
Do not expand List data will not be expanded in the results. It will be returned as “List” in the results.
Expand Lists In Place List data will be converted into a comma-separated list of values for the cell. This does not result in new rows or columns.
Targeting Spec Enter the Targeting Spec.
Skip Failing Ad Set IDs When checking if any Ad Set IDs fail, it skips, and the connector continues to run using the remaining Ad Set IDs.
User Edge
Edge Description
Ad Accounts Returns information for the authenticated user’s ad accounts, such as balance, capabilities, funding sources, etc.
User Info Returns the authenticated user’s name and ID.

​
DataSet Update History

Multi-Account Connectors display the history of running the Connector for each Account on the ‘History’ tab in the DataSet details. For more information on the update history for a Multi-Accounts Connector, and re-running a Multi-Accounts Connector dataset, see https://domo-support.domo.com/s/article/000005825?language=en_US .

​
Troubleshooting and FAQs

I ran the Connector, and one or more of the Accounts threw an error. But the Connector still said the DataSet completed successfully. Why isn’t the DataSet update failing? By default, Multi-Account Connectors ignore failed Accounts and only report the failure as a warning. The reason for this is that some failures may be temporary. If you like the DataSet update to fail if one or more Accounts fail, select the check box entitled ‘ Fail the Dataset if an Account fails ’. What happens if one or more Accounts fail? If one or more Accounts fail, and the ‘Fail the DataSet if an Account fails’ checkbox is not checked, the Connector will perform a partial update. Data in the Dataset derived from Accounts that have not failed will be updated. Data derived from the failed Account(s) will not be updated. Multi-Account connectors enable you to re-run the Connector for one or more Accounts, instead of re-running the entire DataSet. The benefits of re-running one or more Accounts are:
    1. The run time is much shorter than updating the entire dataset.
    2. Re-running specific Accounts does not affect any data successfully brought in by other Accounts.
For more information on re-running one or more Accounts, see https://domo-support.domo.com/s/article/000005825?language=en_US .

​
Others Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Manage Connector Accounts.