advertiser_id returns status unavailable, source adapter-unavailable, reason credentials-missing, and an empty list for that tool. The calls leave delivery unchanged.
Campaigns, ad groups, and ads
page starts at 1. A value above 100000 is stored as 100000. page_size uses page_size when it is set, and otherwise limit. An omitted size is 25. The stored cap is 1000.
Pass fields to replace the default field list. An id filter accepts one id or a list.
get_tiktok_adgroups also echoes campaign_id. get_tiktok_ads also echoes adgroup_id. A successful read includes page_info and request_id.
Performance
Dates usestart_date, date_start, or since, and end_date, date_end, or until. Omitted dates stay off the request. An omitted report_type is BASIC. Report page_size defaults to 1000 and caps at 1000. Id filters are sent in batches of 100. The read stops after 1000 pages.
Default metrics are spend, impressions, clicks, ctr, conversions, and cost_per_conversion.
On the campaign report and on ad performance,
diagnostics is a paging summary: batch_count, page_count, total_rows, and truncated. truncated is true when the read stops at the page cap. get_tiktok_performance_diagnostics uses diagnostics for the delivery rows themselves.
Changing a live campaign name or budget is update_tiktok_campaign on TikTok Ads. That update runs from an approved action.