TikTok Ads: Most-used fields

The number of views where a live stream ad was watched for at least 10 seconds.

A unique identifier generated in TikTok Ads Manager to confirm app ownership and enable tracking of app events via SDK and Events API.

The targeted audience for the ad campaign.

The advertising channel where the ad is displayed, such as TikTok or other supported placements.

The main text content or message of the ad creative.

The length dimension (e.g., in pixels or ratio) of an ad creative's visual asset.

The specific date for which the data is reported.

The day of the week when the ad data was recorded.

The format of the ad creative, such as vertical video or square image.

The number representing the month.

The year and month for which data is reported, in a format like '2024|3'.

The advertising platform where the ad was displayed, such as TikTok.

The origin or channel from which the ad data is collected (e.g., TikTok Ads Manager).

The set of audience criteria, demographics, interests, and behaviors used to define who sees the advertisements.

The time dimension used for reporting, often representing a specific date or period for which data is collected.

The starting date of the week for which the report data is aggregated, often used as a dimension in reports.

The sequential number of the week within a year for which the report data is aggregated.

The year for which data is reported.

The year and month for which data is reported, in a format like '2024|3'.

The unique identifier for the ad account.

The name of the ad account.

The number of times a specific achievement level was reached by users.

The rate at which users achieve a specific level, calculated as achievement level completions divided by relevant impressions or clicks.

The total number of user actions or engagements with the ad.

The unique identifier of the ad group to which the ad belongs.

The name of the ad group to which the ad belongs.

The ID of the advertiser account that owns the ad.

The name of the application associated with the ad, relevant for app promotion campaigns.

The call-to-action text displayed on the ad.

The unique identifier for the call to action button used in the ad.

The type of automation applied to an ad campaign, influencing how it runs and optimizes its performance.

The unique identifier of the campaign to which the ad belongs.

The name of the campaign to which the ad belongs.

The ID of the card creative used in the ad.

The rate at which users click on an ad after viewing it, also known as Click-Through Rate (CTR).

The URL used to track clicks on the ad.

The rate at which users complete a desired action (conversion) after interacting with a specific ad.

The timestamp when the ad was created.

Indicates whether permission is granted to display ads in the TikTok For Business Creative Center.

The file format of the image creative used in the ad (e.g., JPG, PNG).

The height of the image creative used in the ad, in pixels.

The file size of the image creative used in the ad, in bytes.

The URL of the image used in the ad creative.

The width of the image creative used in the ad, in pixels.

The bit rate of the video creative used in the ad.

The duration of the video creative used in the ad.

The file format of the video creative used in the ad (e.g., MP4, MOV).

The height of the video creative used in the ad, in pixels.

The URL for a preview of the video creative used in the ad.

The file size of the video creative used in the ad, in bytes.

The URL of the cover image for the video creative used in the ad.

The width of the video creative used in the ad, in pixels.

The deep link URL configured for the ad, used to direct users to specific content within an app.

The type of deep link configured for the ad.

The display name of the ad.

The name of the shallow external action conversion event.

The format of the ad creative (e.g., image, video, carousel).

The unique identifier for the ad group.

The name of the ad group.

The unique identifier for the ad.

The unique identifier for an ad, representing a specific ad creative and its settings.

The unique identifier for an individual ad.

The type of identity used for the ad, such as a TikTok account or business profile.

A list of identifiers for images associated with the ad creative.

The URL used to track impressions of the ad.

The number of ad impressions that are identified as invalid, often due to non-human traffic, fraudulent activity, or other quality control measures.

The portion of ad spend attributed to invalid impressions or clicks for a specific ad.

Indicates if the ad utilizes Automated Creative Optimization (ACO) to generate multiple creative variations.

The primary landing page URL for the ad.

A list of URLs to which users are directed after clicking on the ad.

The timestamp when the ad was last modified.

The name of the ad.

The current operational status of the ad, such as active, paused, or deleted.

The unique identifier of the page associated with the ad.

The ID of the TikTok pixel used to track events for the ad.

The URL for the playable ad creative.

The URL or identifier of the profile image associated with the ad's identity.

The URL of the profile image displayed with the ad.

The secondary status of the ad, providing more granular information beyond the primary status.

The current operational status of the ad, indicating whether it is active, paused, or otherwise.

The main text content of the ad.

A list of text elements used in the ad creative.

The unique identifier for the specific TikTok content item (e.g., video, post) used in the ad.

The type of ad creative (e.g., single image, video, carousel).

The destination URL associated with the ad.

The number of legitimate ad impressions for a specific ad, excluding any impressions identified as invalid.

The portion of ad spend attributed to valid impressions or clicks for a specific ad.

The ID of the video creative used in the ad.

The percentage of times an ad's video creative is viewed for at least 2 seconds.

The percentage of times an ad's video creative is viewed for at least 6 seconds.

The percentage of times an ad's video creative is viewed to 100% completion.

The percentage of times an ad's video creative is viewed to at least 25% completion.

The percentage of times an ad's video creative is viewed to at least 50% completion.

The percentage of times an ad's video creative is viewed to at least 75% completion.

The number of times users initiated adding billing information, such as credit card details.

The percentage of add payment info actions on your website from all clicks attributed to your ads.

The number of unique 'add payment info' actions attributed to your ads.

The rate at which users added payment information after interacting with your ads.

The number of unique 'add to wishlist' actions attributed to your ads.

The rate at which users add items to a wishlist.

The unique identifier of the advertiser account that owns the ad group.

The age demographic targeted by the ad group.

The age ranges used in targeting for your ad group.

The URL where users are directed to download the app after interacting with an ad in this ad group.

The application ID associated with the ad group, primarily for app promotion campaigns.

The state of the app profile page associated with the ad group.

The type of mobile application targeted by the ad group (e.g., iOS, Android).

The audience segments targeted by the ad group.

The unique identifiers for audience lists targeted by the ad group.

The bid amount set for the ad group.

The bid price set for the ad group.

The bidding strategy or type configured for the ad group.

The billing event type selected for the ad group (e.g., CPM, CPC).

The brand safety settings applied to the ad group.

This field specifies the brand safety solution applied to an ad group, determining the content suitability for ad placements (e.g., no brand safety, standard inventory for most brands, limited inventory for sensitive themes, or third-party solutions).

The budget allocated to the ad group.

The budget pacing strategy for the ad group, indicating how the budget is allocated over time (e.g., daily or total).

The unique identifier of the campaign to which the ad group belongs.

The mobile carriers targeted by the ad group.

The category assigned to the ad group.

The time frame after a click within which a conversion is attributed to the ad group.

Indicates whether comments are disabled for ads within this ad group.

The bid amount set for a conversion event at the ad group level.

The identifier of the conversion event that the ad group is optimized for.

The time window after an ad interaction during which a conversion is attributed to the ad group.

The timestamp when the ad group was created.

The creative material mode setting for the ad group, indicating the type of ad creative format used (e.g., single video, image).

The scheduling settings that define specific times of day or days of the week for ad delivery within the ad group.

The bidding strategy for deep conversions or in-app events within the ad group.

The Cost Per Action (CPA) bid specifically for deep conversion events within the ad group.

This field specifies the targeted device price ranges for an ad group, allowing advertisers to reach users with devices within certain price brackets.

The URL for downloading an app or visiting a website associated with the ad group.

A list of audience identifiers that are excluded from targeting for this ad group.

The frequency cap setting for the ad group, controlling how often a user sees an ad.

The frequency capping schedule configured for the ad group.

The genders targeted for your ad group, or the genders of people who engaged with your ad.

The unique identifier for the ad group.

A list of custom actions that are included for optimization within the ad group.

The IDs of interest categories targeted by the ad group.

Indicates if inventory filtering is enabled for the ad group to control ad placement.

The iOS 14 quota type for the ad group, related to SKAdNetwork campaign limitations.

Indicates whether the ad group is configured with the new campaign structure.

The keywords used for targeting within the ad group.

The languages targeted by the ad group.

The geographical location(s) targeted by the ad group.

The geographic region IDs targeted by the ad group.

The timestamp when the ad group was last modified.

The name of the ad group.

The network types (e.g., Wi-Fi, mobile data) targeted by the ad group.

The operating systems targeted by the ad group.

The current operational status of the ad group, indicating whether it is running, paused, or completed.

The optimization status of the ad group.

The specific event the ad group is optimized for (e.g., app install, purchase).

The overall goal for optimization set for the ad group.

The optimization goal set for the ad group (e.g., conversions, clicks).

The pacing strategy for the ad group's budget, controlling daily spend distribution.

The Pixel ID used by the ad group for tracking website events.

The placement type where the ad group's ads will appear.

The source of the products advertised in the ad group, such as a product catalog.

The type of promotion or objective for the ad group.

The number of impressions purchased for the ad group.

The number of unique users reached for the ad group based on purchased media.

The estimated cost per reach for a Reach and Frequency (RF) ad group.

The estimated average number of times a user sees an ad from the reservation campaign within the ad group.

The purchased type for a Reach and Frequency (RF) ad group.

The scheduled end time for the ad group to run.

The scheduled start time for the ad group to run.

The type of schedule applied to the ad group, e.g., always-on or specific hours.

The total budget allocated for the ad group over its scheduled duration.

A secondary conversion event defined for the ad group, used for optimization alongside the primary optimization event.

A secondary status indicator for the ad group, providing more detail than the primary status.

Indicates whether sharing to third-party platforms is disabled for ads within this ad group.

Indicates whether the learning phase for the ad group was skipped, which is a period where the ad platform optimizes ad delivery.

Identifiers of ad groups that are part of a split test along with the current ad group.

The statistical type or method used for reporting metrics at the ad group level.

The current operational status of the ad group (e.g., enabled, paused).

Indicates whether the option to download videos from ads within the ad group is disabled.

The time window during which a view of an ad group's ad can be attributed to a conversion.

The total number of ad impression events from your mobile app counted as app events and attributed to your ads.

The number of ad impressions at the ad group level that are identified as invalid.

The portion of ad spend attributed to invalid impressions or clicks for a specific ad group.

The name or identifier of the ad group (also known as an adset).

The current operational status of the ad group (adset), indicating whether it is active, paused, or otherwise.

The number of legitimate ad impressions for a specific ad group, excluding any impressions identified as invalid.

The portion of ad spend attributed to valid impressions or clicks for a specific ad group.

The type of the advertiser account on the TikTok Ads platform.

The physical address of the advertiser.

The available balance in the advertiser's account.

The brand name associated with the advertiser.

The name of the advertiser's company.

The country where the advertiser is located.

The timestamp when the advertiser account was created.

The currency used by the advertiser's account.

A description of the advertiser or their business.

The display timezone configured for the advertiser's account.

The unique identifier for the advertiser account.

The industry of the advertiser.

The language set for the advertiser's account.

The province where the advertiser's business license is registered.

The name of the advertiser.

The unique identifier of the Business Center that owns the advertiser account.

The province associated with the advertiser's promotion center or primary business location.

The specific reason provided for the rejection of an ad by the advertiser or the platform.

The current status of the advertiser account.

The timezone configured for the advertiser account.

The type of App Event Optimization used for the ad group or campaign.

The age of the targeted audience or users who engaged with the ad.

A list of age groups targeted by the ad.

Percentage of anchor clicks out of all impressions on your ads.

The number of clicks on anchors within video ads.

The URL where the application can be downloaded.

The number of add to cart events that occurred within an app, attributed to your ads.

The rate at which users add items to their cart within an app.

The unique identifier for the application associated with the ad.

The number of app installs attributed to the ad campaign.

The display name of the promoted application.

The type of app promotion, such as app install or deep link.

The type of application (e.g., iOS, Android).

The total count of events attributed to an ad.

The unique identifiers for the audience segments targeted.

The name or identifier of the audience targeted by the ad.

The defined criteria or rules used to target a specific audience for ad delivery.

The type of audience used for targeting, such as custom audience or lookalike audience.

A setting that indicates whether automatic targeting expansion is enabled for an ad group or campaign, allowing the system to find a broader relevant audience.

The web URI for the avatar icon used in the ad.

The average duration a video ad was played.

The average time your video was played per unique user, including any time spent replaying the video.

The average monetary value generated for each page view event on your website or app, attributed to your ads.

The current financial balance or remaining credit in the advertiser's account.

The company associated with the Business Center in TikTok Ads.

The currency code used for the Business Center and advertiser account, such as USD.

The name of the Business Center account.

The geographical area where the Business Center account is registered or operates.

The operational status of the Business Center in TikTok Ads.

The time zone set for the Business Center or ad account. This affects all time-related functions like data reporting and ad scheduling and cannot be changed after registration.

The classification or category of the Business Center account (e.g., Advertiser, Agency).

The bid amount set for the ad group or campaign.

The display mode for bids set at the ad group level.

The specific bid price set for optimization goals.

The bid set for a secondary optimization goal in an ad campaign.

The bidding strategy employed for the ad group or campaign (e.g., lowest cost, cost cap).

The type of bidding strategy used, such as CPC, CPM, or oCPC.

The actual cost incurred for the ads, which has been billed.

The event type on which billing is based (e.g., clicks, impressions).

The third-party brand safety partner integrated with the campaign to ensure ads appear in appropriate contexts (e.g., IAS, DoubleVerify).

The third-party partner used for post-bid brand safety measurement.

The type of brand safety applied to the ad group.

The VAST URL used by a post-bid third-party partner to measure brand safety.

Indicates whether branded content features are disabled for the ad or account, impacting content disclosure and monetization.

The allocated budget for a campaign or ad group.

The mode in which the budget is managed (e.g., daily, lifetime, infinite).

Indicates whether budget optimization is enabled for a campaign or ad group. This is conceptually similar to 'Budget Optimize Switch' at the campaign level.

The number of clicks on a button within the ad creative.

The rate at which users click on buttons within ads.

Refers to the method of buying ads, such as auction or reservation.

The call-to-action text displayed on the ad, prompting users to take a specific action.

The unique identifier for the specific call-to-action button used in the ad.

The name or identifier of the advertising campaign.

The state of the app profile page associated with the campaign.

The automation type configured for the campaign.

The budget allocated to the campaign.

The budget mode for the campaign (e.g., daily, total).

Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign. This is similar to 'Budget Optimize Switch'.

The timestamp when the campaign was created.

The specific type or objective of an advertising campaign, such as an iOS14 Dedicated Campaign.

The bidding strategy used for deep conversions or in-app events at the campaign level.

The unique identifier for the campaign.

The number of ad impressions at the campaign level that are identified as invalid.

The portion of ad spend attributed to invalid impressions or clicks for a specific campaign.

Indicates if the campaign belongs to a new advertising structure or system.

Indicates if the campaign is a Smart Performance Campaign, utilizing automated optimization.

The timestamp when the campaign was last modified.

The name of the campaign.

The marketing objective of the campaign (e.g., Reach, Traffic, Conversions).

The primary objective of the advertising campaign, such as reach, traffic, or conversions.

The current operational status of the campaign, indicating whether it is running, paused, or completed.

The goal for optimization set for the campaign.

The source of the products advertised in the campaign, such as a product catalog.

The type of reach and frequency (RF) campaign.

The target Return On Ad Spend (ROAS) bid set for the campaign.

The secondary status of the campaign, providing more granular information beyond the primary status.

Specifies if the campaign targets or is associated with special industries like Housing, Employment, or Credit.

The current operational status of the campaign (e.g., active, paused, deleted).

The type of the campaign.

The number of legitimate ad impressions for a specific campaign, excluding any impressions identified as invalid.

The portion of ad spend attributed to valid impressions or clicks for a specific campaign.

The unique identifier for the card creative used in the ad.

The index of an image within a carousel ad.

A list of mobile carrier IDs targeted by the ad group for more precise audience reach.

The total cash amount spent on the ad campaign.

The business center ID authorized to manage the product catalog.

Indicates if a product catalog is enabled for the campaign.

The unique identifier for a product catalog used in shopping ads.

The name of the product catalog associated with the ad.

A list of content category IDs that are excluded from ad placements to enhance brand suitability and avoid undesirable content adjacencies.

The number of checkout events attributed to the ad.

The rate at which users initiated or completed a checkout process after interacting with your ads.

The time window during which a click can be attributed to a conversion event.

The URL used to track clicks on the ad.

The total number of clicks on an ad.

The total number of clicks on the hashtag challenge associated with an ad during its campaign.

The number of clicks on the music disc icon within a Spark Ad.

Indicates whether comments are allowed on ads for this ad group on platforms like TikTok, Vigo, and Helo.

The number of comments on an ad.

The number of complete payment events attributed to ads.

The rate of complete payment events attributed to ads.

The Return on Ad Spend (ROAS) specifically for complete payment events.

The number of times users have completed a tutorial.

The rate at which users complete a tutorial after interacting with an ad.

The number of consultation events.

A list of IDs for contextual tags used for targeting. This relates to the 'Contextual Tag' field.

The total number of conversion events attributed to the ad.

The bid price specifically set for conversion optimization.

The percentage of users who clicked on your ad and completed a desired action.

The rate at which ad interactions lead to a desired conversion event, version 2.

The total number of conversions attributed to the ad.

The total amount of money spent on advertising.

The cost incurred for every 1000 unique users reached by the ad.

The average cost incurred for each 10-second view of a live stream ad.

The average cost for each time a user achieved a specific level within your app, attributed to your ads.

The average cost for each 'add payment info' action on your website attributed to your ads.

The average cost for each event where a user added payment information after interacting with your ads.

The average cost for each time a user added an item to a wishlist after interacting with your ads.

The average cost incurred for each in-app 'add to cart' event.

The average cost incurred for each app install.

The average cost incurred for each button click on an ad.

The average cost incurred for each button click event related to a consultation, within a TikTok-owned property.

The average cost for each checkout event initiated or completed by users after interacting with your ads.

The average cost incurred for each completed payment.

The average cost for each time a user completed a tutorial within your app, attributed to your ads.

The average cost incurred for each consideration event, where consideration signifies user engagement or interest in the ad.

The average cost incurred for each consultation event attributed to an ad.

The average cost incurred for each conversion attributed to your ads.

The average cost for each time a user created a gamerole within your app, attributed to your ads.

The average cost for each time a user created a group within your app, attributed to your ads.

The average cost incurred for each app install resulting from a Call To Action (CTA).

The average cost incurred for each conversion resulting from a Call To Action (CTA).

The average cost for each payment event attributed to clicks on a Call-to-Action.

The average cost incurred for each registration resulting from a Call To Action (CTA).

The average cost incurred for each custom in-app event.

The average cost incurred for each custom page event on a website.

The average cost for each click on a download button on the advertiser's website.

The average cost incurred for each instance where a user views the detailed information related to a download, prior to initiating the download.

The average cost for each time a user initiated an app download after interacting with your ads.

The average cost incurred for each conversion attributed to an engaged view-through.

The average cost incurred for each form submission.

The average cost incurred for each click on a form submission button, leading to a lead generation or information capture.

The average cost incurred for each instance where a user views detailed information on a form, typically before completing or submitting it.

The average cost for each click on an ad displayed within your mobile app, attributed to your ads.

The average cost for each impression of an ad displayed within your mobile app, attributed to your ads.

The average cost for each time a user initiated the checkout process after interacting with your ads.

The average cost incurred for each button click within an Instant Experience (IX) ad format. Instant Experience ads are full-screen, interactive landing pages on TikTok.

The average cost incurred for each page view within an Instant Experience (IX) ad format. Instant Experience ads are full-screen, interactive landing pages on TikTok.

The average cost incurred for each product click within an Instant Experience (IX) ad format, indicating user engagement with products showcased in the IX.

The average cost for each time a user joined a group within your app, attributed to your ads.

The average cost incurred for each landing page view.

The average cost for each time a user launched your app after interacting with your ads.

The average cost incurred for each view of a live stream ad.

The average cost for each time a user applied for a loan after interacting with your ads.

The average cost for each time a user received loan credit after interacting with your ads.

The average cost for each time a loan was disbursed to a user after they interacted with your ads.

The average cost for each time a user logged into your app or service after interacting with your ads.

The average cost incurred for each app open on the day following installation.

The average cost incurred for each offline 'Add Payment Info' event, attributed to your ads.

The average cost for each offline 'add to cart' event, attributed to ad campaigns.

The average cost for each offline 'add to wishlist' event, attributed to ad campaigns.

The average cost for each offline 'click button' event, attributed to ad campaigns.

The average cost for each offline 'complete registration' event, attributed to ad campaigns.

The average cost for each offline 'contact' event, attributed to ad campaigns.

The average cost for each offline 'download' event, attributed to ad campaigns.

The average cost incurred for each offline 'form submission' event.

The average cost for each offline 'initiate checkout' event, attributed to ad campaigns.

The average cost for each offline 'place order' event, attributed to ad campaigns.

The average cost for each offline 'search' event, attributed to ad campaigns.

The average cost for each offline 'shopping' event, attributed to ad campaigns.

The average cost incurred for each offline 'subscribe' event.

The average cost for each offline 'view content' event, attributed to ad campaigns.

The average cost incurred for each 'add to wishlist' event that occurred on the website.

The average cost incurred for each order placed on a website.

The average cost incurred for each 'subscribe' event that occurred on the website.

The average cost for each online consultation event attributed to your ads.

The average cost for each 'add billing information' event that occurs directly on the advertiser's website after an ad interaction.

The average cost for each 'add to wishlist' event that occurs directly on the advertiser's website after an ad interaction.

The average cost incurred for each visit to a specific destination page on the advertiser's website, initiated by an ad click.

The average cost for each 'download start' event that occurs directly on the advertiser's website after an ad interaction.

The average cost incurred for each form submission event on the advertiser's website.

The average cost incurred for each 'initiate checkout' event that occurred on the advertiser's website.

The average cost for each 'add to cart' event that occurs directly on the advertiser's website after an ad interaction.

The average cost for each 'view product detail' event that occurs directly on the advertiser's website after an ad interaction.

The average cost associated with a shopping-related event (e.g., product view, add to cart) occurring on the advertiser's website after an ad interaction.

The average cost incurred for each order.

The average cost incurred for a user browsing or viewing a page specifically related to a consultation, attributed to an ad.

The average cost for each page browse or view event on your website or app, attributed to your ads.

The average cost incurred for each instance where a user views the content of a page, typically tracked as a specific event.

The average cost incurred for each search event on a landing page.

The average cost incurred for each page view attributed to the ad.

The average cost for each view of a product details page on your website or app, attributed to your ads.

The average cost incurred for each purchase.

The average cost for each time a user submitted a rating after interacting with your ads.

The average cost for each new user registration attributed to your ads.

The average cost incurred for each desired result (e.g., conversion, click) achieved by your ads.

The average cost incurred for generating a sales lead, attributed to your ads.

The average cost incurred for each search action.

The average cost incurred for each achievement of a secondary goal result, attributed to your ads.

The average cost for each time a user spent credits within your app or service, attributed to your ads.

The average cost for each time a user started a trial for your service or product, attributed to your ads.

The average cost incurred for each subscription event, attributed to your ads.

The total average cost for all times a user achieved a specific level within your app, attributed to your ads.

The total average cost for all times a user added an item to a wishlist after interacting with your ads.

The average cost incurred for each 'add to cart' app event.

The average cost incurred for each total checkout completion event attributed to your ads.

The total average cost for all times a user completed a tutorial within your app, attributed to your ads.

The total average cost for all times a user created a gamerole within your app, attributed to your ads.

The total average cost for all times a user created a group within your app, attributed to your ads.

The total average cost for all clicks on ads displayed within your mobile app, attributed to your ads.

The total average cost for all impressions of ads displayed within your mobile app, attributed to your ads.

The total average cost for all times a user joined a group within your app, attributed to your ads.

The total average cost for all times a user launched your app after interacting with your ads.

The total average cost for all times a user applied for a loan after interacting with your ads.

The total average cost for all times a user received loan credit after interacting with your ads.

The total average cost for all loan disbursements to users after they interacted with your ads.

The total average cost for all times a user logged into your app or service after interacting with your ads.

The average cost for each Day 1 retention (unique next-day open) of your app attributed to your ads.

The average cost for each purchase event attributed to your ads, encompassing all purchases.

The total average cost for all user ratings submitted after interacting with your ads.

The total average cost for all new user registrations attributed to your ads.

The average cost incurred for each total sales lead generated, attributed to your ads.

The average cost incurred for all search actions.

The total cost incurred for all instances where users spent credits, attributed to an ad.

The average cost incurred for each instance where a user initiates a trial period for a product or service after interacting with an ad.

The average cost incurred for each total subscription event, attributed to your ads.

The average cost incurred for each instance where a user unlocks an achievement within an application or game after engaging with an ad.

The average cost incurred for all content view events.

The average cost incurred for each unique ad impression event.

The cost incurred per unique custom app event.

The average cost incurred for each instance where a user unlocked an achievement, attributed to an ad.

The average cost incurred for each new user registration attributed to an ad.

The average cost incurred for each view content event.

The average cost for each app installation attributed via view-through attribution (VTA), meaning the user saw an ad but did not click it before installing.

The average cost incurred for a conversion that is attributed to an ad view (View-Through Attribution), where the user saw the ad but did not click.

The average cost incurred for a purchase that is attributed to an ad view (View-Through Attribution), where the user saw the ad but did not click.

The average cost incurred for a user registration that is attributed to an ad view (View-Through Attribution), where the user saw the ad but did not click.

The average cost incurred for each 'add to cart' web event.

The average cost incurred for each ad impression event. This represents the cost of showing an ad to a user.

The total cost incurred for users initiating adding payment information, attributed to the ad.

The total cost incurred in United States Dollars (USD) for the advertising entity.

Number of clicks on a reminder from the countdown sticker to a specified destination.

The country associated with the ad account or targeted by the ad.

The two-letter ISO 3166-1 code for the country associated with the advertiser or targeted by the ad.

Cost Per Click, the average cost for each click on your ad.

Cost Per Mille, the average cost for 1000 impressions of your ad.

The video duration threshold for Cost Per View (CPV) billing at the ad group level.

The number of unique app create role actions attributed to your ads.

The rate at which users create a game role within an application.

The number of unique app create group actions attributed to your ads.

The rate at which users create a group within an application or platform.

The timestamp when the object (e.g., campaign, ad group) was created.

Indicates if the creative is authorized for use or display in the TikTok Creative Center.

The current status of an ad creative, indicating its approval, rejection, or delivery state.

The mode or type of creative material used in the ad.

The URL for a preview of the ad creative or its final landing page.

The format or type of the ad creative, such as single image, video, or carousel.

The number of app installs triggered by a Call To Action (CTA).

The number of conversions triggered by a Call To Action (CTA).

The number of purchases attributed to clicks on a Call-to-Action button.

The number of registrations triggered by a Call To Action (CTA).

Click-Through Rate, the percentage of users who click on your ad after seeing it.

The currency in which the financial data is reported.

The rate at which users complete custom in-app events.

The total number of custom events that occurred within an app, attributed to ads.

The total monetary value associated with custom in-app events.

The user-defined type or name of a custom event tracked for conversion or action monitoring.

The rate at which users complete custom page events on a website.

The total number of custom events that occurred on a webpage, attributed to ads.

The total monetary value associated with custom webpage events.

The rate at which a specific, customized ad impression event occurs, calculated as the number of customized impression events divided by total impressions.

The status of a 'dark post' ad, which is an unpublished post used for advertising.

The date for which the data is reported.

The schedule for displaying ads during specific times of the day or certain days of the week.

The bidding strategy used for in-app events. This is similar to 'Campaign Deep Bid Type'.

A bidding strategy focused on optimizing for a specific cost-per-action (CPA) for 'deep' conversion events, which occur further down the conversion funnel.

The deeplink URL that directs users to specific content within an app.

Specifies the format type of the deep link used in the ad.

The type of deeplink used for the ad.

A list of UTM parameters appended to deep links for tracking campaign performance.

The delivery mode for an ad group, affecting how ads are served.

The main text content that provides details about the ad or advertised product/service.

The type of device on which the ad was displayed (e.g., mobile, tablet).

The identifier for the brand of the device on which the ad was displayed.

The name of the brand of the device on which the ad was displayed.

The category of device (e.g., mobile, desktop) on which the ad was displayed.

The IDs of specific device models targeted by the campaign or ad group.

Defines the price ranges of user devices that are targeted for ad delivery.

The specific type or brand of device used by the audience viewing the ad.

Indicates whether SKAdNetwork (SKAN) attribution, Apple's conversion attribution solution for iOS campaigns, is disabled for the campaign. This is similar to 'Campaign Disable SKAN'.

A list of clickable text elements and their corresponding URLs for disclaimers in the ad.

The text content of a standard disclaimer displayed in the ad, with a maximum of 90 characters.

The type of disclaimer used in the ad, such as standard, clickable, or AI-generated content.

The total monetary value of discounts applied to TikTok Shop orders attributed to ads.

The percentage of the discount applied to ad charges, often part of an advertiser incentive or coupon program.

The type of discount offered, such as a percentage off or a fixed amount (e.g., Discount Coupon, Ladder Coupon).

The user-friendly name for a field or entity.

The timezone used for displaying report data.

The identifier for the Designated Market Area (DMA) where the ad was shown.

The name of the Designated Market Area (DMA) where the ad was shown.

The number of clicks on a download button in the ad.

The number of times a download initiated after ad interaction.

The rate at which users initiate a download after interacting with an ad.

The target audience type for Dynamic Product Ads (DPA).

The number of clicks on the 'Duet' button associated with an ad.

The duration of the video or audio creative in seconds.

The dynamic destination setting for ads, which can include dynamic landing pages.

The dynamic format used for ad creatives, often for dynamic product ads.

The number of engaged views on a video ad.

The number of times a video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad.

The time window during which an engaged view can be attributed to a conversion.

The number of conversions attributed to users who saw an ad and engaged with it without clicking, within the attribution window.

The percentage of engagements (likes, comments, shares, follows, clicks) an ad receives relative to its impressions.

The total number of engagements with the ad (e.g., likes, comments, shares).

The name of a specific event tracked by the TikTok Ads platform.

The total number of occurrences for a specific event.

The IDs of audience segments that are explicitly excluded from targeting.

A list of custom actions or events that are explicitly excluded from being tracked or used for audience targeting and optimization within an ad group.

The fallback mechanism or type used when a primary ad action or destination fails.

The type of feed associated with the ad group.

The number of new followers gained due to the ad.

The number of form submission events.

The number of times users clicked a form button, attributed to your ads.

The number of details page browse events from forms.

The total number of form submissions attributed to ad interactions.

The percentage of website lead actions from all clicks attributed to your ads.

The average number of times an ad was shown to a unique user.

The average number of times each unique user saw your ads over the entire lifetime of the campaign.

The average number of times a unique user has seen your ad, measured from the beginning of the month to the current date.

The schedule configured for the ad group that controls how often a user sees an ad within a specified period (frequency capping).

The gender of the targeted audience or users who engaged with the ad.

The total number of times an ad was shown.

The total revenue generated before any deductions.

The estimated household income of the audience reached by the ads, used for targeting or reporting.

The ID of the Business Center authorized for the ad's identity.

The unique identifier for the identity (e.g., brand profile) associated with the ad.

The type of identity (e.g., TikTok account, business profile) used to represent the advertiser in the ad.

The unique identifier for an image creative used in an ad.

A list of unique identifiers for images used in the ad creative.

The URL used to track impressions for the ad.

The total number of times an ad was shown.

The number of clicks on an ad within an application.

The rate at which users click on an ad displayed within an application.

The number of unique in-app ad impression events attributed to your ads.

The rate at which in-app ad impressions occur.

A list of custom actions or events that are specifically included for tracking, audience targeting, or optimization purposes within an ad group.

The primary business sector or vertical to which the advertiser belongs or the ad relates.

The number of times a user started the checkout process after interacting with an ad.

The rate at which users initiated a checkout process, attributed to your ads.

The number of clicks on interactive add-ons within the ad, such as polls, quizzes, or other engagement features.

The number of clicks on destinations linked from interactive add-ons within the ad.

The number of impressions for interactive add-ons in an ad.

The number of clicks on option A of an interactive add-on in an ad.

The number of clicks on option B of an interactive add-on in an ad.

The broad category of user interests targeted by the ad group.

The IDs of interest categories targeted by the campaign or ad group.

The name of the interest category targeted.

A second-tier category for audience interest targeting.

The third-level category representing user interests targeted by ad campaigns.

The fourth-level category representing user interests targeted by ad campaigns.

A list of unique identifiers for specific interests or keywords used to target audiences.

Indicates if inventory filtering is enabled, allowing advertisers to control the type of content next to which their ads appear.

A field related to the campaign's measurement and attribution settings in the context of iOS 14 privacy changes, affecting ad performance tracking.

Indicates whether targeting specific to iOS 14 privacy settings is enabled or configured.

Indicates whether Automated Creative Optimization (ACO) is enabled for the ad.

Indicates whether the campaign is an Advanced Dedicated Campaign, leveraging advanced delivery models.

Indicates if the campaign uses the new campaign structure.

Indicates whether the campaign is a Search Campaign.

Indicates whether the ad is a Smart Creative ad.

Indicates whether the campaign is an automated campaign type.

A list of Internet Service Provider (ISP) IDs targeted by the ad group.

The duet status of the TikTok item used in the ad creative.

The identifier for a group of items within a product catalog.

A list of identifiers used to group product variants, helping to optimize ad recommendations.

A unique identifier for an item, typically referring to a product within an ad catalog.

The stitch status of the TikTok item used in the ad creative.

The average duration of video playback.

The total number of clicks on buttons within an Instant Experience ad.

The rate of button clicks within an Instant Experience (IX) ad, calculated as the number of IX button clicks divided by relevant impressions or views.

Average duration users spent on a webpage after interacting with an ad. This is a page event metric.

The total number of page views within an Instant Experience ad.

The rate of page views within an Instant Experience (IX) ad, calculated as the number of IX page views divided by relevant impressions or views.

The average page view rate for Instant Experience (IX) ads, indicating how often users view pages within the IX after engaging with the ad.

The total number of clicks on products displayed within an Instant Experience (IX) ad, showing user interest in specific products.

The rate of product clicks within an Instant Experience (IX) ad, calculated as the number of IX product clicks divided by relevant impressions or views.

The number of video views within an Instant Experience ad.

The number of interactive video views completed 100%.

The number of interactive video views completed 25%.

The number of interactive video views completed 50%.

The number of interactive video views completed 75%.

The number of times users joined a group or community after interacting with an ad.

The rate at which users join a group within an application or platform.

The URL of the landing page where users are directed after clicking the ad.

The percentage of users who viewed the landing page after interacting with an ad.

The primary language of the advertiser or the ad.

A list of languages targeted by the ad or campaign.

The number of times users launched the app, attributed to your ads.

The rate at which users launched the app, attributed to your ads.

The number of likes on an ad.

The number of times viewers visited your LIVE for more than 10 seconds. Revisits are counted.

The number of new followers gained during live stream ads.

The name or title of a live stream event or live shopping campaign.

The number of times viewers clicked a product and viewed its details page during a LIVE ad.

The current operational status of a live stream event or live shopping campaign (e.g., live, ended).

The number of unique viewers who entered your LIVE stream.

The total number of times viewers visited your LIVE stream. Revisits are counted.

The number of unique app loan application actions attributed to your ads.

The rate at which users submit a loan application after interacting with an ad.

The number of unique app loan approval actions attributed to your ads.

The rate at which users are granted credit or a loan after interacting with an ad, often representing a deeper conversion event.

The number of unique app loan disbursal actions attributed to your ads.

The rate at which loan funds are successfully disbursed to users who applied through an ad campaign.

The IDs of geographic locations targeted by the campaign or ad group.

The number of times users have logged into an application or service.

The rate at which users log into a service or application after interacting with an ad.

The unique identifier for an ad creative asset, such as an image or video, used in a campaign.

The maximum budget allowed for ad delivery.

The advertising channel where the ad is displayed, such as TikTok or other supported placements.

A grouping of different media channels where ads are displayed, such as social media or search.

The minimum Android operating system version targeted.

The minimum iOS operating system version targeted.

The unique identifier of the mobile application.

The timestamp indicating when the ad, ad group, or campaign was last modified.

The unique identifier for the music or audio track used in the ad creative.

The name of the campaign, ad group, or ad.

The total advertising cost after any deductions or adjustments.

The network types (e.g., Wi-Fi, mobile data) targeted by the campaign.

The number of unique Day 1 retentions attributed to your ads.

The percentage of users who open an app or revisit a website on the day following their initial interaction with an ad, measuring retention.

The number of unique Day 1 retentions attributed to your ads. This refers to users who launch the app again the day after installing.

The primary advertising objective for the campaign or ad group (e.g., reach, conversions).

The type of objective set for the campaign or ad group.

The rate at which offline 'Add Payment Info' events occur, calculated as the number of such events divided by relevant impressions or clicks.

The total number of offline 'Add Payment Info' events attributed to your ads.

The total monetary value generated from offline 'add payment info' events attributed to ad interactions.

The rate at which offline 'add to cart' events occur, attributed to ad campaigns.

The number of offline add to cart events attributed to your ads.

The total value of offline add to cart events attributed to your ads.

The rate at which offline 'add to wishlist' events occur, attributed to ad campaigns.

The total number of offline 'add to wishlist' events, attributed to ad campaigns.

The total monetary value generated from offline 'add to wishlist' events attributed to ad interactions.

The rate at which offline 'click button' events occur, attributed to ad campaigns.

The total number of offline 'click button' events, attributed to ad campaigns.

The total monetary value generated from offline 'click button' events attributed to ad interactions.

The rate at which offline 'complete registration' events occur, attributed to ad campaigns.

The number of complete registration events recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'complete registration' events attributed to ad interactions.

The rate at which offline 'contact' events occur, attributed to ad campaigns.

The number of contact events (e.g., phone calls, messages) recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'contact' events attributed to ad interactions.

The average cost for each custom event that occurs offline, attributed to ad campaigns.

The rate at which custom events occur offline, attributed to ad campaigns.

The rate at which offline 'download' events occur, attributed to ad campaigns.

The number of offline download events attributed to your ads.

The total monetary value generated from offline 'download' events attributed to ad interactions.

The rate at which offline 'form submission' events occur, attributed to ad interactions.

The number of form submission events recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'form submission' events attributed to ad interactions.

The rate at which offline 'Initiate Checkout' events occur, calculated as the number of such events divided by relevant impressions or clicks.

The number of 'initiate checkout' events recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'initiate checkout' events attributed to ad interactions.

The rate at which offline 'place order' events occur, attributed to ad campaigns.

The number of 'place order' events recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'place order' events attributed to ad interactions.

The rate at which offline 'search' events occur, attributed to ad campaigns.

The number of offline search events attributed to the ad campaign.

The total value generated from offline search events.

The rate at which offline 'shopping' events occur, attributed to ad campaigns.

The number of offline shopping events attributed to your ads.

The Return On Ad Spend (ROAS) generated from offline shopping events.

The total value of offline shopping events attributed to your ads.

The rate at which offline 'subscribe' events occur, attributed to ad interactions.

The number of 'subscribe' events recorded offline, attributed to ad interactions.

The total monetary value generated from offline 'subscribe' events attributed to ad interactions.

The total monetary value generated from all custom offline events attributed to ad interactions.

The total count of custom events that occur offline, attributed to ad campaigns.

The rate at which offline 'view content' events occur, attributed to ad campaigns.

The number of times users viewed content offline that can be attributed to TikTok ads. This includes actions like viewing product details in a physical store or other offline content interactions tracked through the TikTok Offline Events API.

The total monetary value generated from offline 'view content' events attributed to ad interactions.

The number of 'add to wishlist' events that occurred on the website, attributed to ads.

The number of 'add to wishlist' web events per click.

The number of order completion events that occurred on the website, attributed to ads.

The rate of orders placed on the website, attributed to your ads.

The number of subscription events that occurred on the website, attributed to ads.

The percentage of website subscribe actions from all clicks attributed to your ads.

The number of online consultation events.

The rate at which users initiate an online consultation service after engaging with an ad.

The number of onsite add billing events.

The rate at which users add billing information on the advertiser's website after engaging with an ad.

The rate at which users add items to their shopping cart on the advertiser's website or app.

The number of onsite add to wishlist events.

The rate at which users add items to their wishlist on the advertiser's website after engaging with an ad.

The average cost for each instance of a user adding an item to their shopping cart on the advertiser's website or app.

The average cost incurred for each time a user initiates the checkout process on the advertiser's website after engaging with an ad.

The average cost incurred for each view of a product details page on the advertiser's website after engaging with an ad.

The average cost incurred for each purchase completed on the advertiser's website, attributed to ad interactions.

The percentage of users who visited an onsite destination (e.g., Instant Page) after interacting with an ad.

The number of times an onsite download was initiated.

The rate at which users initiate a download on the advertiser's website after engaging with an ad.

The number of onsite form submission events.

The rate at which form submission events occur on the advertiser's website, attributed to ad interactions.

The number of times users initiated a checkout process directly on the platform (onsite).

The rate at which users initiated a checkout process on the advertiser's website, attributed to ad interactions.

The number of onsite add to cart events.

The rate at which users add items to their shopping cart on the advertiser's website after engaging with an ad.

The number of onsite product detail page views.

The rate at which users view product details on the advertiser's website after engaging with an ad.

The rate at which users view product details pages on the advertiser's website after engaging with an ad.

The rate at which users make purchases on the advertiser's site after engaging with an ad.

The return on ad spend generated from purchases made on the advertiser's site.

The number of user shopping behaviors that occur on your website or app.

The rate at which users engage in shopping-related activities (e.g., product views, add to cart, purchases) on the advertiser's website after ad interaction.

The Return On Ad Spend (ROAS) generated from shopping activities directly on the platform (onsite).

The total number of "add to cart" actions performed on TikTok-owned properties, attributed to your ads.

The total monetary value of 'add to cart' events that occurred on the advertiser's website, attributed to ad interactions.

The total number of times users initiated a checkout process on the advertiser's website, attributed to ad interactions.

The total monetary value associated with all checkout initiation events occurring on the advertiser's website after ad interactions.

The total number of product details page views occurring on the advertiser's website after ad interactions.

The total number of purchases completed on the advertiser's website.

The total monetary value generated from purchases on the advertiser's website.

The average monetary value generated for each instance of a user adding an item to their shopping cart on the advertiser's website or app.

The average monetary value generated for each checkout initiation event on the advertiser's website after ad interactions.

The average monetary value generated for each product details page view on the advertiser's website after ad interactions.

The average value generated per purchase made on the advertiser's site.

The operating systems targeted by the campaign.

The operational status of the entity (e.g., campaign, ad group, ad), such as active, paused, or deleted.

The status of automated creative optimization for the ad group.

The primary conversion event that the ad group is optimized for.

The primary goal for ad delivery optimization (e.g., conversions, clicks, reach).

The total number of orders placed.

The Business Center ID of the owner associated with the ad account or advertiser.

The budget delivery strategy for an ad group, determining how spend is distributed over time.

The number of page browse events leading to a consultation, attributed to your ads.

The number of page browse events.

The rate at which users browse or view pages on a website after engaging with an ad.

The percentage of website view content actions from all clicks attributed to your ads.

The number of page content view events triggered by ad interactions.

The number of search events that occurred on a webpage, attributed to ads.

The rate at which users perform a search action on a landing page.

The unique identifier for a business page or profile associated with the ad.

The rate at which users view pages on a website after interacting with an ad.

The number of times a video ad was played for at least 6 seconds or received at least 1 engagement within one day of a user seeing the ad.

The number of times a video ad was played for at least 15 seconds or received at least 1 engagement within one day of a user seeing the ad.

A view that signifies a certain level of engagement with a paid ad.

The number of paid engagements where a video ad was viewed for at least 15 seconds.

The unique identifier of the TikTok pixel used for event tracking.

The specific location or platform where the ad is displayed.

The type of placement where the ad is displayed.

The locations or platforms where the ads are displayed.

The operating system or environment where the ad was displayed (e.g., iOS, Android).

The name of the advertising platform where the ad campaign is running.

The URL for interactive playable ad creatives.

The mode that determines which SKAN 4.0 postback (attribution window) is secured for the campaign.

The predicted number of impressions an ad or campaign is expected to receive.

The rate at which users click on a specific product displayed within an advertisement.

The total number of clicks on a specific product displayed within an advertisement.

The number of times viewers clicked a product and viewed its details page.

The rate at which users browse or view product details pages on a website after engaging with an ad.

The URL of the image for a product.

The total number of times a specific product displayed within an advertisement was viewed.

The name of the product being advertised.

The unique identifier for a product set within a catalog.

The source of products for promotion, such as Catalog, TikTok Shop, or Showcase. This can apply at campaign or ad group level.

The specific type or category of product being promoted, relevant for shopping ads and catalog management.

The current status of the product in the catalog (e.g., active, out of stock).

The profile image used for the ad. This refers to 'Ad Profile image' or 'Profile Image URL'.

The URL of the profile image displayed with the ad.

The number of profile visits attributed to the ad.

The rate of profile visits per impression driven by a paid ad, applicable only to Spark Ads.

The type of objective or goal set for a promotion, such as driving traffic to an app, website, or specific in-app events.

The type of promotion used in a campaign, such as for GMV Max campaigns.

The type of website or landing page used as the destination for a promotion, categorizing the nature of the promotional destination.

Indicates whether the use of music for promotional content is restricted to only commercial music library tracks or if other music is allowed.

The geographical ID of the province targeted by the ad.

The name of the province targeted by the ad.

The number of purchase events attributed to the ad.

A list of IDs for keywords related to user purchase intention used for targeting. This relates to the 'Purchase Intention' field.

The rate at which users make a purchase after interacting with an ad.

The number of impressions that were purchased or guaranteed, especially relevant for reservation campaigns.

The number of unique users reached through purchased ad placements.

The total number of purchases attributed to the ad.

The number of ratings given by users.

The rate at which users provide ratings for products or content.

The number of unique users who saw the ad.

The number of unique users who saw your ads at least once over the entire lifetime of the campaign.

The number of unique users who saw your ad at least once, measured from the beginning of the month to the current date.

The number of app installs reported in near real-time.

The real-time cost associated with app installations, attributed to your ads.

The number of times your ad achieved an outcome, based on the objective and settings you selected, with count based on when the conversion actually happened.

The percentage of real-time conversions received out of all clicks on your ads, calculated based on when the conversion actually happened.

The real-time rate at which users complete a desired action (conversion) after interacting with an ad, calculated using an updated methodology (version 2).

The average amount of money spent on a real-time conversion (Real-time CPA), calculated based on when the conversion actually happened.

The average cost for each real-time result from your ads, calculated based on when the conversion actually happened.

The number of times your ad achieved an outcome based on the optimization goal selected, with count based on when the conversion actually happened.

The percentage of real-time results achieved out of all views/clicks on your ads, calculated based on when the conversion actually happened.

The geographical region targeted by the advertising.

The number of registration events attributed to the ad.

The rate at which users complete a registration after interacting with an ad.

The reason why an ad, ad group, or campaign was rejected.

The number of times your ad achieved an outcome, based on the optimization goal you selected.

The rate at which the campaign achieves its specified result.

The number of events that generated revenue, attributed to ad interactions.

The type of Reach and Frequency (RF) campaign.

The estimated cost per reach for a Reach and Frequency (RF) campaign.

The estimated average number of times a user sees an ad from a reservation campaign.

The purchased type for a Reach and Frequency (RF) campaign.

The target Return On Ad Spend (ROAS) bid.

The Return On Investment (ROI) from advertising efforts.

Indicates whether Realtime API (RTA) bid is enabled for the campaign. This is similar to 'Campaign RTA Bid Enabled'.

The Realtime API (RTA) ID, which is the identifier for the RTA strategy used. This is similar to 'Campaign RTA ID'.

Indicates whether Realtime API (RTA) is enabled to automatically select products for the campaign. This is similar to 'Campaign RTA Product Selection Enabled'.

The destination where users are directed to complete a sale or conversion.

The number of sales leads generated by the ad campaign.

The percentage of unique generate lead events resulting from ad interactions.

The ID of a saved audience segment.

The scheduled end date and time for an ad entity (e.g., campaign, ad group).

Contains detailed information about the ad's delivery schedule, such as start and end times or daily delivery windows.

The scheduled start date and time for an ad entity (e.g., campaign, ad group).

The type of scheduling applied to an ad entity, such as continuous or specific dates.

The budget allocated for an ad campaign or ad group for a specific scheduled period.

The number of search events that are attributed to your ads.

The rate at which users perform a search action.

A setting that indicates whether an ad is enabled to appear within TikTok's organic search results.

The keywords or phrases users searched for that triggered the display of an advertisement, or the terms defined for a search ad campaign.

The number of times your ad achieved an outcome based on the secondary goal selected.

The rate at which secondary goal results were achieved, attributed to your ads.

The secondary event chosen for campaign optimization.

A secondary status for an ad group, providing more granular information beyond the primary status.

Indicates whether sharing to third-party platforms is disabled for the ad.

The number of times an ad was shared.

The total gross revenue generated from shop orders that are attributed to ad interactions.

The total number of items purchased from a shop, attributed to ads.

The type of deeplink used specifically for shopping ads.

The fallback type used for shopping ads when the primary destination is unavailable.

The specific type of retargeting strategy employed for shopping ads, such as retargeting based on website visits, app activity, or cart abandonment.

The specific format or classification of shopping ads, such as Video Shopping Ads, LIVE Shopping Ads, or Product Shopping Ads.

The identifier for a video package specifically used in shopping ads.

A list of products designated to be featured in a creator's or advertiser's showcase.

The number of times the "achieve level" event occurred, as reported via SKAdNetwork.

The number of times the "add payment info" event occurred, as reported via SKAdNetwork.

The rate at which 'Add Payment Info' events are attributed via SKAdNetwork, calculated as the number of SKAN-attributed events divided by relevant impressions or clicks.

The number of 'add to cart' events reported via SKAdNetwork (SKAN) for iOS app campaigns.

The rate at which the "add to cart" event occurred, as reported via SKAdNetwork.

The number of times the "add to wishlist" event occurred, as reported via SKAdNetwork.

The number of app installs reported via SKAdNetwork (SKAN) for iOS app campaigns.

The number of 'checkout' events reported via SKAdNetwork (SKAN) for iOS app campaigns.

The conversion rate attributed to clicks measured through Apple's SKAdNetwork, indicating the percentage of users who completed a conversion event after clicking an ad.

The average cost incurred for each conversion event attributed through Apple's SKAdNetwork, based on click-time attribution.

The number of times the "complete tutorial" event occurred, as reported via SKAdNetwork.

The rate at which users complete a tutorial within an application or game, with attribution measured through Apple's SKAdNetwork.

The total number of conversion events reported via SKAdNetwork (SKAN) for iOS app campaigns.

The average cost incurred for each unique 'achieve level' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'Add Payment Info' event attributed via SKAdNetwork.

The average cost incurred for each 'add to cart' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'add to wishlist' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost for each app install attributed through Apple's SKAdNetwork framework.

The average cost incurred for each 'checkout initiated' or 'complete checkout' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'complete tutorial' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for any conversion event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'create gamerole' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'create group' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each unique in-app ad click event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each in-app ad impression, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'join group' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'launch app' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'loan apply' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'loan credit' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'loan disbursement' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'login' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each purchase event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'rating submitted' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each user registration event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred per result (conversion) as reported via SKAdNetwork.

The average cost for each sales lead attributed through Apple's SKAdNetwork framework.

The average cost incurred for each 'search' event within the app, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'spend credits' event within the app, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'start trial' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'subscribe' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'achieve level' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'add to cart' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'add to wishlist' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'checkout initiated' or 'complete checkout' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'complete tutorial' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'create gamerole' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'create group' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all unique in-app ad click events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all in-app ad impression events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'join group' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'launch app' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'loan apply' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'loan credit' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'loan disbursement' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'login' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all purchase events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'rating submitted' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all user registration events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'sales lead' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'search' events within the app, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'spend credits' events within the app, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'start trial' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'subscribe' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'unlock achievement' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost incurred for all 'view content' events, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'unlock achievement' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The average cost incurred for each 'view content' event, as reported through SKAdNetwork (SKAN) for iOS campaigns.

The total cost associated with 'Add Payment Info' events attributed via SKAdNetwork.

The number of SKAdNetwork-attributed instances where users created a game role.

The number of SKAdNetwork-attributed instances where users created a group.

The number of in-app ad clicks, as reported via SKAdNetwork.

The rate at which users click on in-app advertisements, with attribution measured through Apple's SKAdNetwork.

The number of in-app ad impressions, as reported via SKAdNetwork.

The number of SKAdNetwork-attributed instances where users joined a group.

The number of app launches, as reported via SKAdNetwork.

The number of loan application events, as reported via SKAdNetwork.

The number of SKAdNetwork-attributed instances where users received loan credit.

The number of SKAdNetwork-attributed loan disbursements.

The number of login events, as reported via SKAdNetwork.

The number of purchase events, as reported via SKAdNetwork.

The rate of purchase events, as reported via SKAdNetwork.

The number of rating events, as reported via SKAdNetwork.

The number of user registration events, as reported via SKAdNetwork.

The rate of user registration events, as reported via SKAdNetwork.

The final conversion value or result reported via SKAdNetwork (SKAN) for iOS app campaigns.

The rate of results (conversions), as reported via SKAdNetwork.

The number of sales lead events, as reported via SKAdNetwork.

The number of search events, as reported via SKAdNetwork.

The number of "spend credits" events, as reported via SKAdNetwork.

The number of "start trial" events, as reported via SKAdNetwork.

The rate of "start trial" events, as reported via SKAdNetwork.

The number of subscription events, as reported via SKAdNetwork.

The rate of subscription events, as reported via SKAdNetwork.

The total count of "achieve level" events, as reported via SKAdNetwork.

The total value of SKAdNetwork-attributed instances where users achieved a certain level.

The total count of "add payment info" events, as reported via SKAdNetwork.

The total count of "add to cart" events, as reported via SKAdNetwork.

The total value associated with "add to cart" events, as reported via SKAdNetwork.

The total count of "add to wishlist" events, as reported via SKAdNetwork.

The total count of "checkout" events, as reported via SKAdNetwork.

The total value associated with "checkout" events, as reported via SKAdNetwork.

The total count of "complete tutorial" events, as reported via SKAdNetwork.

The total value of SKAdNetwork-attributed instances where users completed a tutorial.

The total number of SKAdNetwork-attributed instances where users created a game role.

The total number of SKAdNetwork-attributed instances where users created a group.

The total number of in-app ad clicks, attributed via SKAdNetwork.

The total value generated from all in-app ad click events, with attribution measured through Apple's SKAdNetwork.

The total number of in-app ad impressions, attributed via SKAdNetwork.

The total number of times users joined a group, attributed via SKAdNetwork.

The total number of app launches, attributed via SKAdNetwork.

The total number of loan applications, attributed via SKAdNetwork.

The total number of loan credits, attributed via SKAdNetwork.

The total number of loan disbursements, attributed via SKAdNetwork.

The total number of user logins, attributed via SKAdNetwork.

The total number of purchases, attributed via SKAdNetwork.

The total value generated from purchases, attributed via SKAdNetwork.

The total number of user ratings, attributed via SKAdNetwork.

The total number of user registrations, attributed via SKAdNetwork.

The total number of sales leads, attributed via SKAdNetwork.

The total count of search events based on when the events are returned through the SKAdNetwork API.

The total number of times users spent credits, attributed via SKAdNetwork.

The total number of trial starts, attributed via SKAdNetwork.

The total number of subscriptions, attributed via SKAdNetwork.

The total number of content views, attributed via SKAdNetwork.

The number of times an achievement was unlocked, attributed via SKAdNetwork.

The number of content views, attributed via SKAdNetwork.

The rate at which content was viewed, attributed via SKAdNetwork.

Indicates if the learning phase is skipped for campaign delivery optimization.

A list of Stock Keeping Unit (SKU) identifiers, representing unique product items in a catalog.

A flag indicating whether smart audience features are enabled for an ad group, allowing for dynamic audience optimization.

A flag indicating whether smart interest and behavior-based targeting features are enabled for an ad group.

The optimization goal set for smart targeting.

Number of clicks on the 'Use sound' button associated with the ad.

The advertising platform or origin where the ad was run.

Special ad categories that apply to the campaign, such as HOUSING, EMPLOYMENT, or CREDIT. This is similar to 'Campaign Special Industries'.

The total amount of money spent on the ad or campaign.

The total amount of money spent in Euros for the advertising campaign, ad group, or ad.

The number of unique app spend credit actions attributed to your ads.

The percentage of app spend credit actions from all app installs attributed to your ads.

Indicates the status or identification of a split test (A/B test) run to compare different ad versions or strategies.

The unique identifier for a specific group within a split test.

The current status of a split test.

The number of times a trial was started.

The rate at which trials were started.

The specific day for which the statistics are reported.

The hour of the day for which the statistics are reported.

The statistical type or method used for reporting metrics.

The operational status of the ad, ad group, or campaign (e.g., active, paused, deleted).

The number of clicks on the 'Stitch' button in Spark Ads.

The number of subscription events attributed to the ad.

The rate at which users subscribe after interacting with an ad.

The budget allocated to achieve a specific Return On Investment (ROI) target.

A feature that allows the ad platform to automatically expand targeting beyond manually set criteria to find a broader, relevant audience.

The unique identifier for a TikTok post ID, used specifically for Spark Ads.

A category assigned to a TikTok page or content, used for targeting audiences based on their engagement with specific content interests.

The timezone used for report data.

The title of an advertisement, creative, or other content asset.

The estimated range of unique users that a TopView ad is expected to reach, providing a forecast for premium ad placements.

The total number of times users achieved a certain level within an app or game, attributed to the ad.

The total value generated from achieve level events.

The Return On Ad Spend (ROAS) from actively paying users.

The cumulative value attributed to all ad impression events, potentially reflecting estimated revenue or importance.

The Return on Ad Spend (ROAS) specifically calculated based on ad impression events, indicating the revenue generated per unit of ad spend after impressions.

The total value generated from users initiating adding billing information.

The total number of times payment information was added.

The total number of 'add to wishlist' events attributed to your ads.

The total monetary value of 'add to wishlist' events attributed to your ads.

The total number of 'add to cart' events that occurred within your app, attributed to your ads.

The total monetary value of 'add to cart' events that occurred within your app, attributed to your ads.

The total value generated from button clicks on a website or app, attributed to the ad.

The total number of checkout events initiated.

The total monetary value of all checkout events.

The total value of website purchase actions attributed to ads. Despite its name, this metric returns a summed value, not a rate.

The total number of times users have completed a tutorial.

The total value of app complete tutorial actions attributed to your ads.

The total number of app create role actions attributed to your ads.

The total value of app create role actions attributed to your ads.

The total number of times a group was created.

The total value generated from creating groups.

The total value of website download actions attributed to your ads.

The total monetary value generated from form submissions.

The total number of clicks on an ad within an application.

The total value of in-app ad clicks attributed to your ads.

The total number of in-app ad impressions.

The total value generated from in-app ad impressions.

The total monetary value of all initiate checkout events.

The total number of times a group was joined.

The total value generated from joining groups.

The total number of landing page views after ad interaction.

The total number of times the app was launched by users.

The total number of loan applications.

The total number of loan credits.

The total number of loan disbursements.

The total number of user logins.

The total number of times the app was opened the day after installation or engagement.

The total value of 'add to wishlist' actions on the website attributed to ads.

The total monetary value of order events that occurred on the website, attributed to ads.

The total monetary value of subscription events that occurred on the website, attributed to ads.

The total value generated from online consultation events.

The total value generated from onsite add billing events.

The total value generated from onsite add to wishlist events.

The total value generated from onsite form submission events.

The total value generated from onsite initiate checkout events.

The total value generated from onsite add to cart events.

The total monetary value of all onsite shopping events.

The total monetary value of search events that occurred on a webpage, attributed to ads.

The total value associated with page view content events.

The total number of page views.

The total number of purchases.

The total Return on Ad Spend (ROAS) for purchases within 0 days of ad interaction.

The total return on ad spend (ROAS) generated from purchase actions within 72 hours of an app install.

The total Return on Ad Spend (ROAS) for purchases within 6 days of ad interaction.

The total monetary value of purchases.

The total monetary value of purchases in Euros, attributed to ad interactions.

The total monetary value of purchases attributed to ads within zero days of the ad interaction, often indicating immediate purchase conversions.

The total monetary value of purchases within 2 days of ad interaction.

The total monetary value of purchases within 6 days of ad interaction.

The total number of ratings given by users.

The total value of app rate actions attributed to your ads.

The total number of registration events.

The total number of sales leads generated.

The total value generated from sales leads.

The total number of search events that are attributed to your ads.

The total number of app spend credit actions attributed to your ads.

The total value of app spend credit actions attributed to your ads.

The total number of times users have started a trial period.

The total number of subscription events attributed to ads.

The total monetary value of subscription events attributed to ads.

The total number of app unlock achievement actions attributed to your ads.

The total value of app unlock achievement actions attributed to your ads.

The total value generated from user registrations.

The total monetary value generated for each page view attributed to the ad.

The total number of view content events attributed to your ads.

The total monetary value of view content events attributed to your ads.

The total monetary value of 'add to cart' web events.

The unique identifier of the app used for tracking purposes.

The unique identifier of the pixel used for tracking purposes.

The name of the TikTok account associated with the ad.

The URL of the profile image for the TikTok account associated with the ad.

The unique identifier for the TikTok application.

The name of the TikTok application.

The number of unique times an ad was displayed to users.

The number of unique custom in-app events recorded.

The number of times users unlocked an achievement.

The rate at which users unlock achievements.

The number of user registration events.

The rate at which users complete registration.

The average value attributed to each individual ad impression event.

The average value generated each time a user adds billing information, typically after interacting with an ad.

The value generated per button click.

The average value generated per checkout event.

The monetary value generated for each complete payment.

The average value generated each time a user initiates a download, often for an application or software promoted by an ad.

The average value generated per form submission event.

The average value generated per 'initiate checkout' event.

The average monetary value generated for each offline 'add payment info' event, attributed to ad campaigns.

The average monetary value generated for each offline 'add to cart' event, attributed to ad campaigns.

The average monetary value generated for each offline 'add to wishlist' event, attributed to ad campaigns.

The average monetary value generated for each offline 'click button' event, attributed to ad campaigns.

The average monetary value generated for each offline 'complete registration' event, attributed to ad campaigns.

The average monetary value generated for each offline 'download' event, attributed to ad campaigns.

The average monetary value generated for each offline 'form submission' event.

The average monetary value generated for each offline 'initiate checkout' event, attributed to ad campaigns.

The average monetary value generated for each offline 'place order' event.

The average monetary value generated for each 'add to wishlist' event occurring on the advertiser's website.

The monetary value generated for each order completed on the website.

The average value generated each time a user completes an online consultation initiated through an ad.

The average monetary value generated for each 'add billing information' event occurring on the advertiser's website after an ad interaction.

The average monetary value generated for each 'add to wishlist' event occurring on the advertiser's website after an ad interaction.

The average monetary value generated for each form submission event on the advertiser's website.

The average monetary value generated for each 'initiate checkout' event on the advertiser's website.

The average monetary value generated for each 'add to cart' event occurring on the advertiser's website after an ad interaction.

The average monetary value generated for each 'view product detail' event occurring on the advertiser's website after an ad interaction.

The average monetary value generated from each onsite shopping event, such as an add to cart, checkout initiation, or product page view. from TikTok Ads API onsite shopping value metrics query results

The average monetary value generated for each search event performed on a webpage, attributed to ad engagement.

The average monetary value generated for each instance of a user achieving a level within an application or game.

The average monetary value generated for each 'add to wishlist' event, including both in-app and onsite occurrences, attributed to ad interactions.

The average value generated per 'add to cart' event within the app.

The cumulative value generated from all instances where users complete a tutorial within an application or game after engaging with an ad.

The average monetary value generated for each instance of a user creating a game role within an application, attributed to ads.

The average monetary value generated for each instance of a user creating a group within an application or platform, attributed to ads.

The average monetary value generated for each in-app ad click, attributed to ads.

The cumulative value generated from all in-app ad impression events.

The average monetary value generated for each instance of a user joining a group within an application or platform, attributed to ads.

Total monetary value generated for each purchase attributed to an ad.

The average monetary value generated for each user rating action, attributed to ads.

The average value generated per sales lead.

The average value generated per 'spend credits' event.

The average value generated per subscription event.

The cumulative value generated from all instances where users unlock an achievement within an application or game after engaging with an ad.

The average value generated per 'view content' event.

The average value generated per user registration.

The average value generated per 'add to cart' web event.

The unique identifier for a video creative used in an ad.