How to troubleshoot failed reports

Last updated: October 2024

In TikTok Ads Manager, reports help you view, organize, and analyze your data. Large sets of data are exported into tables and charts to help you better visualize your results and spot impactful patterns and trends. In certain cases, you may find that the system fails to, or takes a long time to export a report.

There are three primary reasons why your report may fail to download:

  1. The size of the selected data is too large: Data reports can take a longer time to export, or even fail to export if the data size is too large. For certain combinations of dimensions and time ranges, you may experience download issues because of an overwhelming amount of data.

  • We recommend selectively choosing your dimensions/metrics in your report when using the Run and Export feature. This feature is best when you choose to export reports within a shorter, selective timeframe.

  • If you want to export dimensions with a wider time range, we suggest using the Scheduled Running feature to allow the system to deliver results over certain time intervals and prevent potential download issues that are experienced from data overload.

  1. Server is busy: In very few cases, your download may fail as our servers are busy due to excessive queries. We suggest that you attempt to download the report again in 30 minutes.

  2. Downloading too many reports simultaneously: If you attempt to export multiple reports at once, your downloads may fail. To prevent this, we recommend that you export reports one at a time.