`tiktok_ads_get_smart_plus_report`

Get TikTok Smart+ Creative Material Report

Tiktok

Description

Get Smart+ creative material performance breakdown. Use this when analyzing Smart+ campaign creative variants — breaks down performance by creative material (video/image), text, and enhancement (CTA) combinations. Required for accurate Smart+ reporting, as the standard reporting tools only show parent ad-level data. Paging: rows come back in \

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_get_smart_plus_report",
    "arguments": {}
  }
}

hopkin tiktok smart-plus-report get

Flag	Type	Required	Description
`--advertiser-id`	`string`	Required	TikTok advertiser account ID.
`--dimensions`	`array`	Required	Creative dimensions to break down by. Examples: material/creative type, text, enhancement/CTA.
`--start-date`	`string`	Required	Start date in YYYY-MM-DD format.
`--end-date`	`string`	Required	End date in YYYY-MM-DD format.
`--metrics`	`array`	Optional	Metrics to retrieve. Defaults to spend, impressions, clicks, conversions, and cost metrics.
`--campaign-ids`	`array`	Optional	Filter by campaign IDs.
`--adgroup-ids`	`array`	Optional	Filter by ad group IDs.
`--smart-plus-ad-ids`	`array`	Optional	Filter by Smart+ ad IDs.
`--main-material-ids`	`array`	Optional	Filter by material (video/image) IDs.
`--main-material-types`	`array`	Optional	Filter by material types.
`--sort-field`	`string`	Optional	Sort by field. Default: spend.
`--sort-type`	`string`	Optional	Sort direction. Default: DESC.
`--page`	`integer`	Optional	Page number (1-indexed) to jump straight to. Default: 1. Ignored when cursor is given; prefer cursor to walk a report.
`--page-size`	`integer`	Optional	Rows per page. Default: 20, maximum: 1000. Check pagination.hasMore and follow pagination.nextCursor for the rest.
`--cursor`	`string`	Optional	Opaque cursor from a previous response's pagination.nextCursor. Pass it back unchanged, with every other parameter identical, to fetch the next page; omit it for the first page. Takes precedence over page. Never construct one by hand.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://tiktok.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`advertiser_id`	`string`	Required	TikTok advertiser account ID.minLength: 1, maxLength: 64
`dimensions`	`array`	Required	Creative dimensions to break down by. Examples: material/creative type, text, enhancement/CTA.
`start_date`	`string`	Required	Start date in YYYY-MM-DD format.
`end_date`	`string`	Required	End date in YYYY-MM-DD format.
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (12)

Name	Type	Required	Description
`metrics`	`array`	Optional	Metrics to retrieve. Defaults to spend, impressions, clicks, conversions, and cost metrics.
`campaign_ids`	`array`	Optional	Filter by campaign IDs.
`adgroup_ids`	`array`	Optional	Filter by ad group IDs.
`smart_plus_ad_ids`	`array`	Optional	Filter by Smart+ ad IDs.
`main_material_ids`	`array`	Optional	Filter by material (video/image) IDs.
`main_material_types`	`array`	Optional	Filter by material types.
`sort_field`	`string`	Optional	Sort by field. Default: spend.
`sort_type`	`string`	Optional	Sort direction. Default: DESC. `ASC` `DESC`
`page`	`integer`	Optional	Page number (1-indexed) to jump straight to. Default: 1. Ignored when cursor is given; prefer cursor to walk a report.min: 1
`page_size`	`integer`	Optional	Rows per page. Default: 20, maximum: 1000. Check pagination.hasMore and follow pagination.nextCursor for the rest.min: 1, max: 1000
`cursor`	`string`	Optional	Opaque cursor from a previous response's pagination.nextCursor. Pass it back unchanged, with every other parameter identical, to fetch the next page; omit it for the first page. Takes precedence over page. Never construct one by hand.minLength: 1, maxLength: 512
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.