FAQ
Can I export data from multiple TikTok Ads accounts in one data flow?
Yes. When you select your ad accounts, you can choose multiple accounts from the dropdown. All data will be combined in a single export. Include the "Advertiser name" dimension so you can distinguish which rows belong to which account. If you need to aggregate metrics across accounts, use Coupler.io's Aggregate transformation.
What's the difference between "Campaigns" and "Basic campaign report"?
"Campaigns" is a snapshot report showing your current campaign structure (name, status, budget, bid strategy) without performance metrics or a specific date range. "Basic campaign report" shows performance metrics (impressions, clicks, spend, conversions) for a selected date range. Use "Campaigns" if you need a list of active campaigns; use "Basic campaign report" for performance analysis.
Can I break down data by multiple dimensions at once (e.g., country AND age)?
Yes. In the "Audience dimensions" or other dimension fields, you can select multiple options. Each combination will create a separate row in your export. For example, if you select "Country code" and "Age," you'll see impressions/clicks/spend for each country-age combination. Note: this increases the number of rows and API query size, so results may take longer.
Why is my conversion data missing or zero?
Conversion data requires an active conversion tracking pixel or app event in your TikTok Ads account. If you don't see conversions in your export:
Go to TikTok Ads Manager → Conversions
Verify you have at least one active pixel or app event
Check that your campaigns are configured to track that conversion
Wait 24 hours for data to populate (new pixels take time)
Once verified, re-run your Coupler.io data flow.
Can I use date macros to automate my date range?
Yes. TikTok report types that support date ranges (e.g., "Basic campaign report") allow date macros. Instead of manually entering dates, use macros like {{previousMonth}}, {{30daysago}}, or {{startOfMonth}}. This way, your data flow automatically pulls rolling date ranges without manual updates. See Coupler.io's macro documentation for the full list.
What's the difference between audience reports and basic reports?
Basic reports (campaign, ad group, ad) show performance metrics aggregated by your campaign structure. Audience reports show the same metrics broken down by audience segments (gender, age, country, interests, language, platform, etc.). Use basic reports for quick performance overviews; use audience reports when you want to understand which demographic or interest segment converts best.
How often should I refresh my data flow?
TikTok's API updates data within 24 hours. Schedule daily refreshes for early morning (6–8 AM) so you're pulling yesterday's complete data. Avoid hourly or 4-hour schedules; they'll hit rate limits and waste resources. If you only need weekly reports, schedule once per week (e.g., Monday morning).
Can I combine TikTok Ads data with other ad platforms (Meta, Google Ads)?
Yes. Create separate data flows for each platform, then use Coupler.io's Append transformation to combine them in one spreadsheet or table. For example, append TikTok campaign data with Meta campaign data, then use a pivot table to compare performance across platforms. You can also use Join if you want to match campaigns by name or date.
What should I do if I see "Request to TikTok API has failed"?
This is usually temporary. Wait 15–30 minutes, then try running the data flow again. If it persists:
Reduce your date range (large ranges can timeout)
Remove unnecessary dimensions or metrics
Check that your selected ad accounts still exist in TikTok Ads Manager
Reconnect your TikTok account in Coupler.io's Connections section
If errors continue, contact Coupler.io support with your data flow ID.
Can I send TikTok Ads data to ChatGPT or Claude?
Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Cursor, Gemini, Perplexity, and OpenClaw. Select your AI destination instead of a traditional spreadsheet or data warehouse. This is useful for generating insights, creating summaries, or automating analysis — for example, "Summarize my top 5 performing campaigns and suggest bid adjustments."
Why does my data look different from TikTok Ads Manager?
Small differences are normal and usually due to:
Data freshness: The API lags by up to 24 hours; the dashboard shows real-time estimates
Attribution window: The API uses 1-day click attribution; the dashboard may use 3, 7, or 30 days
Time zone: Verify your TikTok Ads Manager and export time zones match
Filters: Coupler.io filters may exclude data visible in the dashboard
For details on available metrics and how attribution works, see the Data Overview.
Can I pull data for GMV Max or Dynamic Showcase Ads campaigns?
Yes. Select "GMV Max campaign report" for GMV Max campaigns or any of the "Dynamic Showcase Ads (DSA)" report types for DSA campaigns. These reports include product-level data (product ID, SKU, catalog) and commerce-specific metrics (GMV, revenue, orders, ROAS). You must have active GMV Max or DSA campaigns and a linked e-commerce catalog or TikTok Shop to use these reports.
How do I handle duplicate data if I pull the same date range twice?
If you've accidentally pulled overlapping dates and your destination is in Append mode, you'll have duplicates. Use Coupler.io's Deduplicate transformation to remove them. Alternatively, delete the duplicate rows manually in your spreadsheet. In the future, use date macros or carefully track which date ranges you've already exported.
Last updated
Was this helpful?