FAQ

Answers to the most frequently asked questions about using the Facebook Ads source in Coupler.io.

What report types are available?

Coupler.io supports seven Facebook Ads report types: Reports and Insights, List of Sponsored Leads, List of Campaigns, List of Ad Sets, List of Ads, List of Ad Creatives, and List of Ads with Ad Creatives. See the Data Overview for details on each.

Can I pull data from multiple ad accounts?

Yes. When configuring the source, you can select multiple ad accounts. Keep in mind that each ad account counts as a separate account toward your Coupler.io plan limit.

What date range can I pull?

For Reports and Insights and Leads, you set a start and end date using the date picker. There's no hard limit on the date range, but very large ranges with many breakdowns can be slow or hit API limits.

Why doesn't my data match what I see in Ads Manager?

The most common reason is a mismatch in attribution settings. Make sure the attribution window in Coupler.io (under Advanced settings) matches what you use in Ads Manager. Also verify that date ranges, breakdowns, and report types match. See Common Issues for detailed troubleshooting.

Why is data for today missing or incomplete?

The Facebook Ads API typically has a 1–2 day data latency. Data for the current day (and sometimes yesterday) may not be fully processed yet. Set your end date to yesterday for the most reliable results.

What are breakdowns and should I use them?

Breakdowns split your data by dimensions like age, gender, country, device, or publisher platform. They're useful for deeper analysis, but each breakdown multiplies the number of rows in your report. Only use breakdowns you actually need. See Best Practices for tips.

Can I filter data by campaign or ad?

Yes. In the Advanced settings, you can add filters using Facebook's Graph API syntax. For example, to pull only campaigns containing "Brand" in the name: [{"field":"campaign.name","operator":"CONTAIN","value":"Brand"}]

How does Coupler.io count Facebook Ads accounts for billing?

Facebook Ads is a tenant-based source. Coupler.io counts each ad account you select in the setup wizard as one account toward your plan limit. It doesn't matter how many report types or data flows you create — what matters is the number of unique ad accounts used per credential. See Accounts Limit Calculation for full details.

Can I schedule automatic data refreshes?

Yes. After setting up your data flow, you can configure a refresh schedule (hourly, daily, weekly, etc.) under the data flow settings. Your destination will be updated automatically.

Can I change the currency of my Facebook Ads data?

No — the currency is determined by your ad account settings in Meta. Coupler.io pulls monetary values (spend, CPC, conversion values, etc.) in whatever currency the ad account uses. Coupler.io's column formatting lets you change the display label (e.g., show € instead of $), but the underlying numbers remain in the original currency. To get data in a different currency, you would need to create a new ad account in Meta with that currency.

Can I pull ad creative images or thumbnails?

Yes. Use the List of Ad Creatives or List of Ads with Ad Creatives entity. The relevant fields are image_url, thumbnail_url, and video_id. Note that these entities do not include performance metrics — to combine creative details with spend, clicks, or conversions, create a separate Reports and Insights source at the Ad level and join the two on Ad Id using Coupler.io's data stitching.

Can I get UTM parameters from my ads?

UTM parameters are part of the ad creative, not the performance report. Use the List of Ad Creatives or List of Ads with Ad Creatives entity to access the url_tags and link_url fields, which contain the UTM parameters configured in your ads. These fields are not available in Reports and Insights.

Why does Reach in my dashboard not match Ads Manager?

Reach is a unique-users metric — it cannot be summed across days, campaigns, or ad sets. If your dashboard aggregates daily Reach rows (e.g., using SUM in Looker Studio), the total will be inflated because users who saw your ad on multiple days get counted more than once.

To match Ads Manager, use "Split data by period: Totals only" in Coupler.io for the same fixed date range. This returns a single deduplicated Reach value from the API. If you need daily granularity, display Reach per-row and avoid summing it.

How do I get ROAS or purchase revenue?

• For return on ad spend, use the Purchase ROAS or Website Purchase ROAS metric.

• For purchase revenue, use the Value variant of the relevant conversion event — e.g., Conversions: Purchases (Omni) - Value or Conversions: Purchases (FB pixel) - Value.

Make sure your attribution window in Coupler.io matches what you use in Ads Manager. Note that the 1-day engaged-view attribution window is not available through the API, so conversion counts may be slightly lower than in Ads Manager. See Common Issues for details.

How do I get performance metrics alongside creative data?

The List of Ads with Ad Creatives entity provides structural and creative data (image URLs, ad text, video IDs) but does not include performance metrics like spend, clicks, or conversions. To combine both:

1. Create a Reports and Insights source at the Ad level with the metrics you need.

2. Create a List of Ads with Ad Creatives source for the creative fields.

3. Use Coupler.io's data stitching (Join) to combine them on Ad Id.

This gives you a unified dataset with creative details and performance numbers.

What if I need help?

If you can't resolve an issue using this documentation, contact Coupler.io support with your importer ID and screenshots showing the data discrepancy.