Documentation

Facebook Ads Insights Integration

Alooma can read and replicate all of the Facebook Ads report data from your Facebook Ads account. This allows you to merge ad data with other data such as customer usage data in your data destination.

Background

Alooma provides a way for you to pull your Facebook Ads Insights data using Facebook's Marketing API. Alooma pulls the Facebook Ads Insights data daily, including the last 30 days of results by default, to account for updated attribution.

When setting up this integration you can choose to import historical data, in which case Alooma will retrieve historical data from that date.

Setting up the integration

You can connect Facebook Ads Insights to Alooma in just a few steps:

Add your Facebook Ads Insights input from Alooma's plumbing screen

Authenticate with the Continue with Facebook button

Supply the following information

Accounts: Select the Ads Insights account or accounts you'd like to pull from. If you make no selection, we'll pull from all accounts including any that may be added in the future.

Report Level: Represents the level of result (defaults to Account).

Action Report Time:Determines the report time of action stats (defaults to Impression).

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 will see a conversion on Jan 1st. When you query the API with action_report_time=conversion, you will see a conversion on Jan 2nd.

Breakdown: How to break down the result (defaults to Age). The breakdown combinations are exhaustively listed, with each breakdown combination in alphabetical order.

ReportFields: Define the fields to be retrieved (default are Impressions and Spend).

Decide how many days of data to pull back on every daily pull to complete attribution (default is 30). More days back means more data flowing through your system, but also more complete data.

Choose whether you'd like to import historical events (by default it will start today with data the day before).

Chose whether you'd like to stop pulling data at some date in the future.

Keep the mapping mode to the default of OneClick if you'd like Alooma to automatically map the Facebook Ads Insights events directly to your data destination. Otherwise, they'll have to be mapped manually from the Mapper screen.