Experimental feature: LinkedIn Ads connector is currently in beta. We’re actively improving sync reliability and adding more features.
Prerequisites
- A LinkedIn Ads account with active campaigns
- Admin or Analyst access to the LinkedIn Campaign Manager account you want to sync
- LinkedIn account must have campaigns with data
Connecting LinkedIn Ads
You can connect LinkedIn Ads in two ways: from the Sources page if you’re already using AstroBee, or during the onboarding process if you’re a new user.- During onboarding
- From Sources page
Start connection
A “Configure Connector” modal appears showing “LinkedIn Ads Not Connected”. Click the orange Connect button to begin setup.
Authorize with Fivetran
AstroBee uses Fivetran to securely connect to LinkedIn Ads. Review the security information and click Continue.
- Secure: Data transfer is encrypted end-to-end and your credentials are never exposed
- Private: Your data passes through without permanent storage
Authenticate with LinkedIn
On the Fivetran setup page, click Authorize to log in through OAuth. You’ll be redirected to LinkedIn to grant access.
Configure sync settings
After authentication succeeds, configure your sync settings:
- Accounts sync mode: Choose “Sync all accounts” or select specific accounts
- Reports sync mode: Choose “Sync all reports” or select specific reports
- Historical Sync Time Frame: Select how much historical data to sync (ALL_TIME syncs everything)
Select tables to sync
Back in AstroBee, the “Configure Connector” modal shows your sync progress. Expand Sync Settings to select which tables to include.
- account_history: Account information and settings
- campaign_history: Campaign details and configurations
- ad_analytics_by_campaign: Performance metrics by campaign
- ad_analytics_by_creative: Performance metrics by creative
- creative_history: Ad creative content and formats
Data layer building
A modal appears showing “Your data layer is building”. AstroBee is unifying, deduplicating, and resolving entities across your data.
Data syncing
The Sources page shows your sync progress. Your data source is syncing and the data layer will be generated automatically once syncing completes.
What happens next
After connecting LinkedIn Ads, AstroBee automatically generates a data layer from your synced tables. Once complete, you can start querying your advertising data using natural language.Syncing data
LinkedIn Ads connections sync automatically when first connected and during historical backfill. After the initial sync completes, you can trigger manual syncs to refresh your data. To sync your latest advertising data:- Navigate to the Sources page
- Find your LinkedIn Ads connection under MY SOURCES
- Click the sync button
Understanding LinkedIn Ads data
LinkedIn Ads syncs multiple related tables:- Campaign data: Campaign names, objectives, budgets, and status
- Ad performance: Impressions, clicks, spend, and engagement metrics
- Creative content: Ad formats, text, images, and targeting
- Conversion tracking: Lead generation forms, website conversions, and attribution data
- Audience insights: Demographic and professional targeting information
Troubleshooting
For additional help, see Fivetran’s LinkedIn Ads troubleshooting guide.Authentication failed
Authentication failed
Issue: Unable to authorize access to LinkedIn Ads.Solution:
- Ensure you have Admin or Analyst access to the LinkedIn Campaign Manager account
- Verify you’re signed in to the correct LinkedIn account
- Check that your organization allows third-party access to LinkedIn Ads
- Try re-authorizing from the beginning
- Confirm your LinkedIn account is not locked or restricted
No data syncing
No data syncing
Issue: Connection succeeds but no data appears in tables.Solution:
- Verify your LinkedIn Ad account has active or past campaigns
- Check that you selected the correct ad account during setup
- Ensure your campaigns have actually run and generated data
- Wait for the initial sync to complete (can take 10+ minutes for accounts with extensive campaign history)
- Trigger a manual sync to refresh data
Sync taking too long
Sync taking too long
Issue: Initial sync appears stuck or is taking longer than expected.Solution:
- Accounts with extensive campaign history can take 30+ minutes to sync
- Check your internet connection
- Avoid making changes to the connection during sync
- LinkedIn Ads API rate limits may slow down large syncs
- If stuck for more than an hour, contact support at support@astrobee.ai
Missing campaigns or ads
Missing campaigns or ads
Issue: Some campaigns or ads don’t appear in synced data.Solution:
- Verify you have access to those campaigns in LinkedIn Campaign Manager
- Check that campaigns are not archived or deleted
- Ensure your account sync mode includes the ad account containing those campaigns
- Trigger a new sync to pull the latest data
- Review your LinkedIn permissions - you need at least Analyst access
Conversion data missing
Conversion data missing
Issue: Conversion tracking data is not syncing.Solution:
- Verify conversion tracking is properly configured in LinkedIn Campaign Manager
- Check that conversions have actually occurred and been recorded
- Ensure you have the necessary permissions to view conversion data
- LinkedIn conversions may have a data delay of up to 48 hours
- Trigger a new sync after conversions have had time to process
Account access denied
Account access denied
Issue: Cannot access specific LinkedIn Ad accounts.Solution:
- Confirm you have Admin or Analyst role for those accounts
- Check that the account owner hasn’t revoked your access
- Verify the ad account is not suspended or closed
- Re-authenticate to refresh your access permissions
- Contact your LinkedIn Ads account administrator if access issues persist
Historical backfill taking too long
Historical backfill taking too long
Issue: Status shows “Backfilling history” for many hours.Solution:
- Historical backfills for LinkedIn Ads can take 12+ hours for accounts with years of campaign data
- This is normal behavior, not a stuck sync
- You can safely close the browser and return later
- The sync continues in the background and your data layer will generate automatically when complete
- If backfill exceeds 72 hours with no progress, contact support at support@astrobee.ai
Data layer not generating
Data layer not generating
Issue: Sync completed but data layer shows an error or never finishes building.Solution:
- Check that at least one table was selected during setup
- Verify your synced tables contain actual data (not empty)
- Try refreshing the page to see updated status
- If the error persists, try disconnecting and reconnecting LinkedIn Ads
- Contact support at support@astrobee.ai with the error message if the issue continues