Pull a TikTok Business API performance report using the Reporting API

Steps

1. Choose synchronous reporting for small, bounded date-range/dimension pulls, or asynchronous report tasks for large historical or account-wide pulls
2. For sync reports, call the integrated report-get endpoint with advertiser_id, report_type, dimensions, metrics, and a date range, then paginate the response
3. For async reports, create a report task, capture the returned task_id, poll its status endpoint until COMPLETE, then download the result file
4. Check the documented metric/dimension compatibility matrix before building a request, since not every metric can be paired with every dimension
5. Cache advertiser_id/campaign_id lookups locally rather than re-fetching them before every report request
6. Handle rate limits with backoff, since bulk async report generation is throttled per advertiser account