GET_AD_METRICS_TIKTOK_ADS

Insights about your TikTok Ads.

icon of TikTok AdsTikTok Ads
Not a big fan of functions?
Use the Actions Wizard to configure any action in Rows without functions.

Parameter List

Syntax
GET_AD_METRICS_TIKTOK_ADS(advertiser id
[campaign id]
[adgroup id]
[ad id]
[report type]
[date range]
[metrics]
[dimensions]
)
advertiser id

The ID of your TikTok Ads account.

[optional] campaign id

The ID of your TikTok Ads account.

[optional] adgroup id

The ID of your TikTok Ads adgroup.

[optional] ad id

The ID of your TikTok Ads ad.

[optional] report type

The type of report.

Selected options:
Basic
Audience
Playable ad
[optional] date range

Date range to get insights for. For example: ">2019", ">2019-11-01" or "[2010-01-01;2019-01-01]". By default, you get insights for the last 30 days.

[optional] metrics

Range of fields to retrieve about the ad account. For example: 'clicks','country'. By default, it returns the most common metrics about the ad account.

Selected options:
Ad Format Asset
Total Cost
CPC (Destination)
Campaign Name
Ad Group Name
Ad Name
Ad url
CPM
Impressions
Gross Impressions (Includes Invalid Impressions)
Clicks (Destination)
CTR (Destination)
Conversion
CPA
CVR (Clicks)
CVR (Impressions)
Real-time Conversions
Real-time CPA
Real-time CVR (Clicks)
Real-time CVR (Impressions)
Result
Cost Per Result
Result Rate (%)
Real-time Result
Real-time Cost Per Result
Real-time Result Rate (%)
Currency
Is Automated Ad
Is Smart Creative Ad
[optional] dimensions

Range of values to break down the results into different sets. For example: 'age'.

Selected options:
Ad ID
Gender
Age
Day
Hour
Video id
Country Code
Province ID
DMA ID
Language
Interest Category
Interest Category Tier 2
Interest Category Tier 3

Examples

GET_AD_METRICS_TIKTOK_ADS("adidas", "ad group Summer", , audience, ">2021-09-01", "impressions,clicks,spend,cpc,cpm", "age") returns report with clicks, spend, cpc and cpm per age of the audience.