Skip to documentation content
Paid advertising

Instagram Ads

Analyze the Instagram placement portion of paid campaigns in selected Meta ad accounts.

Connection workflow
Connect ad accounts · Instagram placements
Authentication
Meta OAuth via Nango
Guide address
/documentation/instagram-ads/

Before you start

  • A Facebook identity authorized for Meta ad accounts that run Instagram placements and Data Weaver source-management access.
  • Identify the Meta ad accounts to select. Paid Instagram reporting uses ad-account authorization, separate from connecting an organic Instagram account.

Set up the connection

  1. Connect Instagram Ads in the target client's Sources through Meta authorization.
  2. Select the intended Meta ad accounts explicitly and save. Selecting none syncs none.
  3. Sync, then check that the selected accounts actually have Instagram-placement results in the reporting window.

Permissions requested

  • Read access is needed to discover ad accounts/currency and retrieve campaign insights by publisher platform. Data Weaver does not edit campaigns, placements or budgets.
  • Authorize the Facebook identity with access to your intended Meta ad accounts, review Meta's consent screen and return to Data Weaver to select the accounts. Instagram-placement filtering happens when their reports are read.

Data read and actions performed

  • The connector requests recent daily campaign insights with a publisher-platform breakdown and keeps Instagram rows, including spend, impressions, clicks and available attributed conversion measures.
  • Supported scoped questions can use campaign rankings and spend trends for the selected accounts.

Refresh and sync

  • Default scheduled cadence is hourly with manual Sync. Meta reporting delays and quota limits can postpone updates.

Limitations

  • This is a placement-filtered report, not a separate independent ad platform. It can overlap the broader Facebook Ads/Meta report; do not double-count.
  • No Instagram placements in the period can legitimately produce no data. Attributed value is not verified store revenue; keep currencies separate.

Troubleshooting

  • Confirm ad-account roles and saved selection if accounts are missing.
  • For empty reports, check Instagram placement activity and dates before reconnecting. Reconnect for authorization failures; inspect retry status for provider/quota failures.

Disconnect and delete

  • Remove the Data Weaver connection to stop reads and initiate remote Nango cleanup.
  • Use Meta Business Integrations/app settings separately for provider-wide grant removal; it can affect other Meta connections. Request deletion separately for retained app data.

Privacy and help

You stay in control of what you connect. Review how we handle information, request deletion, or contact us.

Back to all documentation

The next conversation starts here

Find the throughline.

Questions about connecting a source? Read the guide, check our privacy and deletion pages, or ask support.

Join the pilot

Pilot requests are reviewed before invitations are sent. Requesting access does not create an account.