TikTok Ads integratie

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; switching advertisers happens in the integration settings, not in chat.

Listing TikTok Ads campaigns

Campaigns of the selected advertiser with objective, buying type, budget, budget mode, status, and timestamps. Filter by ids, name, objective, buying_types (RESERVATION_RF for reach & frequency), status, or manual versus Smart+. Paged. The selected advertiser is applied automatically; never pass one.

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, ad_group_ids, name, objective, or status. Paged. The selected advertiser is applied automatically; never pass one.

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, ad_group_ids, ad_ids, objective, or status. Paged. The selected advertiser is applied automatically; never pass one.

Fetching TikTok Ads report

Performance 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 complete days per campaign; granularity daily gives one row per day. Amounts are in the advertiser currency. The selected advertiser is applied automatically; never pass one.

Listing TikTok Ads audiences

Custom audiences of the selected advertiser (customer files, website and app traffic, engagement, lookalikes) with size, type, validity, and expiry, owned or shared. Paged. The selected advertiser is applied automatically; never pass one.

Fetching TikTok Ads audience details

Status and modification history of specific custom audiences of the selected advertiser, by id from the audience listing. The selected advertiser is applied automatically; never pass one.

Searching 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, video name, or material_ids. Paged. The selected advertiser is applied automatically; never pass one.

Searching 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. The selected advertiser is applied automatically; never pass one.

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. The selected advertiser is applied automatically; never pass one.

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. The selected advertiser is applied automatically; never pass one.

Updating TikTok Ads campaign budget

Set a new budget on one campaign of the selected advertiser (the campaign must use a campaign-level budget). Fetch the current budget and budget_mode first and show old versus new when asking the user to confirm. The selected advertiser is applied automatically; never pass one.