Ad Insights
Per-creative performance inside TikTok Smart+ ads
Breaks a Smart+ ad (or ad group) down by creative material, one row per Spark post, video or image, from TikTok's Smart+ material report. For a Spark post tiktokItemId is the TikTok post id. Conversion metrics are TikTok web (pixel) events. TikTok allows two dimensions per report, so rows are keyed by the Smart+ ad (level=ad) or by the ad group (level=adGroup), not both. Metrics TikTok returns empty come back as null.
get/v1/ads/tiktok-smart-plus-materials
Query parameters
accountIdstring required
A tiktok or tiktokads account ID
adAccountIdstring required
TikTok advertiser ID
startDatestring date required
YYYY-MM-DD, in the advertiser's time zone
endDatestring date required
YYYY-MM-DD, on or after startDate
level'ad' | 'adGroup'
Key each row by Smart+ ad or by ad group
smartPlusAdIdsstring
Comma-separated Smart+ ad ids to filter by (up to 100)
adGroupIdsstring
Comma-separated ad group ids to filter by (up to 100)
pageinteger
pageSizeinteger
Response
Material rows