Facebook

This guide explains how to set up the Facebook UA data grabber in the Magify analytics system.

The grabber enables automated import of user acquisition data such as campaign spend, impressions, clicks, installs, and other key performance metrics directly from your Facebook account into your analytics pipeline.

Getting Started

1. Navigate to Configurations > Integrations > UA Grabbers in the Magify interface.
2. Find Facebook UA in the list and click Add Grabber to create a new data source.
3. A configuration form will open.

This form is used to connect Magify to your Facebook account by providing the required credentials (App Token, Facebook UA Country report) and a custom integration name.

Each field in the form is described below.

General Settings

Name

A descriptive name for the grabber configuration. Helps identify the data source among other integrations.

Recommended format: Facebook UA Grabber [CompanyName]

Optional field – recommended to fill in for easier navigation.

Organization

Select your organization from the dropdown list.

App Token

1. Go to https://developers.facebook.com → Create a new app with Business type (e.g., "For grabbing").
2. Navigate to Business Settings → Under Users, click System Users → Click Add New System User → Select the Employee role → Give a name to the system user and click Create System User.
3. Assign assets, such as your Ad Accounts, with View Performance permission → Assign Apps (just created App) with Develop App permission → Select ads_read and ads_management permissions.
4. Click Generate New Token. Copy and save your Token.

5. Go to Business Settings → Accounts → Apps → Locate your mobile app → Assign the System User with Develop App permission. Double-check the assigned assets for correctness.

These credentials will be used for setting up integrations or accessing reporting features.