FAQ

Which X Ads entities should I use for a standard performance report?

For most performance dashboards, start with Campaign for top-level metrics and Ad group (Line item) for targeting-level breakdowns. Add Promoted tweet if you want creative-level engagement data. Use Coupler.io's Join transformation to combine them on the campaign ID.

Why can't I see campaign or tweet names in my metrics report?

X Ads API returns entity names (like campaign name or tweet name) separately from performance metrics. Pull the Campaign or Promoted tweet entity to get names and IDs, then use Coupler.io's Join transformation to merge it with your analytics data on the shared ID field. This gives you named rows in your final report.

Why are my add-to-cart or purchase conversions showing as zero?

Conversion metrics are only populated if your X Pixel and conversion tags are correctly configured and firing in X Ads Manager. Go to Tools > Conversion Tracking in your X Ads account to confirm the tags are active. If they're not set up, the API will return zero for all conversion metrics regardless of your settings in Coupler.io.

Can I pull data from multiple X Ads accounts into one report?

Yes. Add a separate source for each ad account within the same data flow, then use the Append transformation to stack them into one table. It helps to add a custom column with the account name so you can filter or group by account in your destination.

What does the "Placement" parameter do and why do my totals look doubled?

When you set Placement to "All", X Ads API returns a separate row for each placement type (e.g., timelines, search, profiles). If you sum all rows, you'll get inflated totals. Either pick a specific placement to filter the report, or aggregate your data carefully in your destination after accounting for the placement breakdown.

Can I send X Ads data to an AI tool for analysis?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can route your X Ads data directly to these tools for natural-language analysis, campaign summaries, or automated reporting insights.

Why does my data flow return no data even though I have active campaigns?

Check three things: (1) your date range covers a period when the selected campaigns were running, (2) at least one metric group is selected, and (3) the entity you chose actually has data for that account (for example, Promoted account only returns data if you ran follower campaigns). See the Missing Data section in Common Issues for more detail.

For a full list of metrics included in each metric group, see the Data Overview article. For help resolving connection or data problems, visit Common Issues. For setup recommendations, see Best Practices.