TikTok Ads integration

Fetching TikTok Ads advertiser

Account details of the selected TikTok Ads advertiser: name, currency, time zone, status, balance, company, and contact fields. Set all_authorized to list every advertiser account this connection can reach.

Listing TikTok Ads campaigns

Campaigns of the selected advertiser with objective, buying type, budget, status, and timestamps. Filter by ids, name, objective, buying_types (RESERVATION_RF for reach & frequency), or status. Paged; page_info.total_number holds the row count.

Listing TikTok Ads ad groups

Ad groups of the selected advertiser with targeting, placements, budget, bid, schedule, optimization goal, and status. Filter by campaign_ids, adgroup_ids, name, objective, or status. Paged.

Listing TikTok Ads ads

Ads of the selected advertiser with ad text, call to action, landing page, creative ids (video_id, image_ids), identity, and status. Filter by campaign_ids, adgroup_ids, ad_ids, name, objective, or status. Paged.

Fetching TikTok Ads report

Performance report (synchronous integrated report) for the selected advertiser: spend, impressions, clicks, CTR, CPC, CPM, conversions, reach, frequency, video and engagement metrics at advertiser, campaign, ad group, or ad level. Use report_type AUDIENCE for demographic and placement breakdowns and service_type RESERVATION with RESERVATION_* levels for reach & frequency campaigns. Defaults to the last 30 days per campaign; add stat_time_day to dimensions for daily rows. Amounts are in the advertiser currency.

Listing TikTok Ads audiences

Custom audiences of the selected advertiser (customer files, website and app traffic, engagement, lookalikes) with size, type, validity, and expiry. Pass custom_audience_ids for full details of specific audiences. Paged.

Listing TikTok Ads videos

Video creatives in the selected advertiser's creative library: id, material id, name, duration, size, format, preview and poster URLs, and whether they are still usable. Filter by video_ids, material_ids, dimensions, ratio, or displayable. Paged.

Listing TikTok Ads images

Image creatives in the selected advertiser's creative library: id, material id, name, dimensions, format, URL, and whether they are still usable. Filter by image_ids, material_ids, dimensions, ratio, or displayable. Paged.

Updating TikTok Ads campaign status

Pause (DISABLE) or activate (ENABLE) up to 20 campaigns of the selected advertiser. Look the campaigns up first and name them when asking the user to confirm.

Updating TikTok Ads ad group status

Pause (DISABLE) or activate (ENABLE) up to 20 ad groups of the selected advertiser. Look the ad groups up first and name them when asking the user to confirm.

Updating TikTok Ads campaign budget

Set a new budget on one campaign of the selected advertiser (campaign-level budget must be enabled on the campaign). Fetch the current budget and budget_mode first and show old versus new when asking the user to confirm.

Updating TikTok Ads ad group budget

Set a new budget on one ad group of the selected advertiser. Fetch the current budget and budget_mode first and show old versus new when asking the user to confirm.