Facebook Marketing Integration

Connect your Facebook Ads account to AccessFuel to unlock powerful advertising analytics including campaign performance, ad set optimization, conversion tracking, and ROAS analysis.

Prerequisites

Before you begin, you'll need:

• A Facebook Ad Account with at least Analyst access
• Admin access to the Facebook Business Manager (for OAuth)

Connection Methods

AccessFuel supports two ways to connect Facebook Marketing:

1. OAuth Connection (Recommended) - Quick and secure, no technical setup required
2. Manual Token Setup - For advanced users who need custom app configurations

Setup Guide: OAuth Connection (Recommended)

The OAuth method is the fastest and most secure way to connect Facebook Marketing to AccessFuel. It takes less than 2 minutes and requires no technical configuration.

Step 1: Navigate to Integrations

1. Log in to AccessFuel Console
2. Go to Settings → Integrations → Facebook Marketing
3. Click the Connect with Facebook button

Step 2: Authenticate with Facebook

1. A popup window will open showing Facebook's login page
2. Log in with your Facebook account that has access to Ad Manager
3. Review the permissions requested (read-only access to Ads data)
4. Click Continue to grant AccessFuel access

Step 3: Select Your Ad Account

1. After authentication, you'll see a list of your Ad Accounts
2. Select the Ad Account you want to connect
3. Click Connect to complete the setup

Step 4: Verify Connection

1. You should see a green "Connected" status
2. Data sync will begin automatically
3. Initial data may take a few hours to appear in your dashboard

---

Setup Guide: Manual Token Setup (Alternative)

The manual setup method is useful when you need advanced app configurations, custom permissions, or when OAuth authentication isn't suitable for your organization.

Follow these steps to connect using manual token generation:

Manual Step 1: Get Your Account ID

1. Go to Meta Ads Manager
2. Find the number in your browser's address bar
3. Look for act= in the URL - the number following it is your Account ID

Manual Step 2: Register as a Meta Developer

A Meta Developer account is your gateway to the App Dashboard, SDKs, APIs, development tools, and documentation.

To register, follow the official instructions: Register as a Meta Developer

Manual Step 3: Create a New App

Your Meta app serves as a container for your API credentials and permissions. Meta uses it to monitor API usage, enforce rate limits, and ensure application security.

1. Go to the Meta for Developers App Dashboard
2. Click Create App
3. Name your app "AccessFuel"

4. App Type: Choose Business as the app type when prompted
5. Select your business account

Manual Step 4: Add the Marketing API Product

After creating your app, you'll need to enable the Marketing API to begin making requests.

1. In your app's dashboard, open the sidebar menu
2. Click Add Product
3. Find and select Marketing API from the list of available products

Manual Step 5: Generate an Access Token

To authorize your application to interact with the Facebook Marketing API, you'll need to generate an access token with the appropriate permissions.

1. From your app's dashboard, go to Marketing API → Tools
2. In the Token Permissions section, select the following permissions:
   • ads_management - Manage ads and campaigns
   • ads_read - Read ad and campaign data
   • read_insights - Access insights data for ads, ad sets, and campaigns
   • business_management - Manage business assets (required to access ad accounts connected to a Meta Business Manager)
3. Click Get Token to generate the access token
4. Copy the generated token securely

Manual Step 6: Request Increased Rate Limits

By default, API tokens generated from apps with "Standard Access" are heavily throttled by Facebook. This can make them unsuitable for applications requiring frequent or large data syncs.

To ensure reliable performance, you'll need to request "Advanced Access."

Access App Review

1. From your app's dashboard, go to App Review → Permissions and Features
2. For each of the following permissions marked as "Standard Access", click the Request advanced access button:
   • ads_read
   • ads_management
3. Facebook may prompt you to fill out a form detailing how the permission is used

Complete Business Verification

Make sure your app is associated with a verified Business Manager account. This is a prerequisite for obtaining Advanced Access.

Submit the App Review Request

Once all information is provided, submit the request through the App Review interface. Monitor the status in the dashboard as Facebook reviews your application.

Meet Rate Limit Requirements

Manual Step 7: Send Us the Credentials

Enter the following in Settings > Integrations:

• Account ID(s): Your Facebook Ad Account ID Number(s) to use when pulling data from the Facebook Marketing API
• Access Token: The token you generated in Step 5
• Start Date: The date from which you want to sync data (format: YYYY-MM-DDTHH:mm:ssZ)

What Data Gets Synced?

Once connected, AccessFuel will sync the following data from your Facebook Marketing account:

• Campaigns: Campaign details, status, and performance
• Ad Sets: Ad set configuration and metrics
• Ads: Individual ad performance and creative data
• Insights: Daily, weekly, and monthly performance metrics
• Conversions: Conversion tracking and attribution data

Data Refresh Schedule

• Frequency: Data syncs every 24 hours
• Historical Data: All data from your specified start date
• Real-time Updates: Not available; data reflects the previous day's activity

Troubleshooting

OAuth Connection Issues

Popup Blocked

If the authentication popup is blocked:

1. Check your browser's popup blocker settings
2. Allow popups from app.accessfuel.com
3. Try clicking the Connect button again
4. If using Safari, enable popups in Safari Preferences → Websites → Pop-up Windows

Authorization Failed

If you see an authorization error:

1. Ensure you're selecting a Facebook account with access to Ad Manager
2. Verify you have at least Analyst role on the Ad Account
3. Try using a different browser or clearing cookies
4. If using a corporate account, contact your IT admin

Connection Expired

OAuth tokens expire approximately every 60 days for security. If your connection shows as expired:

1. Navigate to Settings → Integrations → Facebook Marketing
2. Click the Reconnect button
3. Re-authenticate with Facebook
4. Your data will continue syncing automatically

No Ad Accounts Found

If no Ad Accounts appear after authentication:

1. Verify you selected the correct Facebook account
2. Ensure you have access to at least one Ad Account in Ads Manager
3. Check that your Ad Accounts haven't been disabled
4. For Business Manager accounts, verify your user has proper permissions

Manual Setup Issues

Token Expired

If your access token expires, generate a new one and update it in Settings > Integrations.

Missing Permissions

Ensure all required permissions are granted:

• ads_management
• ads_read
• business_management
• read_insights

Rate Limit Errors

If you're experiencing rate limit errors, verify that your app has Advanced Access approved and you're meeting the minimum 1,500 API calls per 15-day period.

Data Not Syncing

Check the following:

1. Verify your Account ID is correct
2. Ensure your access token is valid
3. Confirm Advanced Access is granted
4. Check that your app has the Marketing API product enabled

Security & Privacy

• Token Storage: Access tokens are encrypted and stored securely
• Data Transmission: All data is transmitted over HTTPS
• Access Control: Only authorized AccessFuel team members can access your credentials
• Compliance: We comply with Facebook's Platform Terms and Policies

Related Resources