Skip to main content

Facebook Ads Integration with PostTrack (via Facebook Developer)

This guide will help you connect Facebook (Meta) ad accounts to PostTrack. Insert your screenshots in the marked places — file names are provided as hints.

Table of Contents​

  1. What You'll Need
  2. Step 1. Create an app in Meta for Developers
  3. Step 2. Link app to business
  4. Step 3. Get token
  5. Step 4. Grant access to ad accounts
  6. Step 5. Add integration in PostTrack
  7. Step 6. Import and verify accounts
  8. Verifying functionality
  9. Common errors and solutions
  10. Security notes
  11. FAQ
  12. Glossary

What You'll Need​

  • Access to Meta for Developers (developers.facebook.com).
  • Business Manager (Business Settings) with your ad accounts.
  • App ID and App Secret of the future app.
  • System User token with ads_read permissions (and read_insights if needed).

Step 1. Create an App in Meta for Developers​

  1. Go to developers.facebook.com → My Apps → Create App.

    Create app

  2. In the next window, enter the app name and click Next

    Create app

  3. Select "Track ad performance data using the Marketing API" and click Next

    Create app

  4. Select "Business" and click Next

    Create app

  5. On the requirements page, simply click Next

    Create app

  6. Click the create app button

    Create app

Step 2. Getting Data​

  1. Go to the app dashboard and navigate to "Settings"

    Create app

  2. Getting EAA token: go to "Tools" section, enable ads_read and generate access token, save it

    Create app

  3. Getting APP ID and APP Secret: go to "App Settings" => "Basic", get the data and save

    Create app

Step 3. Adding Data to PostTrack​

  1. Go to Agencies section

  2. Click add button and add app data

    Create app

  3. Import accounts: go to "Facebook Accounts" section, import needed Facebook accounts or add all

    Create app

Verifying Functionality​

  • Go to Statistics tab.
  • Select a period (default — last 7 days) and click Show.
  • If needed, click Synchronize — the service will pull fresh Insights and update the table.

Common Errors and Solutions​

SymptomPossible CauseWhat to Do
Empty list on importSystem User has no access to Ad AccountGrant access in Business Settings → Ad Accounts → Assign
401/403 on requestsToken expired/invalid, missing permissionsGenerate new token with ads_read and read_insights if needed
No data in reportNo traffic for selected period or account not importedCheck period and import; run Synchronization
App validation errorApp ID/Secret don't match tokenVerify App + System User Token pairing
Different currenciesDifferent accounts in different currenciesGroup by accounts and analyze separately

Security Notes​

  • Don't share App Secret and Access Token in public channels.
  • Restrict PostTrack access to trusted users only.
  • Regularly revoke old System User tokens and generate new ones.
  • Log integration actions and set up error alerts.

FAQ​

Are ads_management permissions needed? No, ads_read (and read_insights if needed) is sufficient.

Can I connect multiple apps? Yes. Add each app separately and import its accounts.

What if I only have ID without act_? Both formats are supported — act_123 or 123.

How long does synchronization take? Depends on number of accounts and period — typically from seconds to a few minutes.

Glossary​

  • App ID / App Secret — identifiers of your app in Meta for Developers.
  • System User Token — service token on behalf of business system user.
  • Business Manager — company (business) admin panel in Meta.
  • ads_read / read_insights — permissions for accessing Ads/Insights data.
  • act_XXXXXXXXXXXX — ad account identifier.