Fields listing for TikTok Ads

The number of times your video played for at least 2 seconds. Replays will not be counted.

The number of times your video played for at least 6 seconds, or completely played. Replays will not be counted.

Number of times your LIVE was viewed for at least 10 seconds from an ad. Revisits are counted.

The number of times your video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad. Engagements to be measured: Likes, shares, follows, profile visits, clicks, hashtag clicks, music clicks, anchor clicks, and interactive add-ons activity clicks.

Get the Account available balance（The unit is related to the advertiser's currency type currency）.

Achieve Level (Total No.) (The total count is based on when you were billed.)

The percentage of unique achieve level events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of unique achieve level events out of all app install events.

Ad delivery arrangement, in the format of a string that consists of 48 x 7 characters. Each character is mapped to a 30-minute timeframe from Monday to Sunday. Each character can be set to either 0 or 1. 1 represents delivery in the 30-minute timeframe, and 0 stands for non-delivery in the 30-minute timeframe. The first character is mapped to 0:01-0:30 of Monday; The second character is mapped to 0:31-1:00 of Monday, and the last character represents 23:31-0:00 Sunday. Note Not specified, all-0, or all-1 are considered as full-time delivery.

Get the Ad delivery end time (UTC+0). Format should be YYYY-MM-DD HH:MM:SS.

Get the Ad delivery start time (UTC+0). Format should be YYYY-MM-DD HH:MM:SS.

Get the frequency, together with frequency_schedule, controls how often people see your ad (only available for REACH ads). For example, frequency = 2 frequency_schedule = 3 means "show ads no more than twice every 3 day".

Get the Ad group ID.

Get the Ad group Name.

Get the Ad group status.

Get the Ad ID.

Whether the campaign is a new structure (for the same campaign, the structure of campaign, adgroups and ads are the same).

Get the Ad Name.

Get the Operation vstatus, optional values include: DISABLE (the ad is disabled), ENABLE (the ad is enabled), FROZEN (the ad is terminated and cannot be enabled).

Get the Ad status.

Get the ad text. It is shown to your audience as part of your ad creative, to deliver the message you intend to communicate to them. Keyword match type is exact match..

Get the .

The percentage of unique add payment info events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The total value returned from add billing events.

The number of TikTok Shop add to cart actions attributed to your ads. Add-to-cart is reported based on the time each ad impression occurred.

The number of add to cart events.

The percentage of add to cart events out of all click events.

The percentage of TikTok Shop add-to-cart actions from clicks on your ads. Add-to-cart is reported based on the time each ad impression occurred.

The total value of TikTok Shop add-to-cart actions attributed to your ads. Add-to-cart is reported based on the time each ad impression occurred.

The percentage of unique add to wishlist events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of add to wishlist events out of all click events.

Time at which the Ad Group was created.

Get the Gender that you want to target. Enum: GENDER_FEMALE,GENDER_MALE,GENDER_UNLIMITED.

Get the Time at which the Ad Group was Modified.

Get the Optimization goal.

Get the Advertiser address information.

Get the Advertiser contact email, desensitised data.

Get the Advertiser ID.

Get the Advertiser industry category.

Get the Language used by advertisers.

Get the Advertiser name.

Get the Advertiser role.

Get the Advertiser status.

Get the Advertiser's company name.

Get the Advertiser's create time.

Get the Advertising objective.

The Age.

Get the App download link.

The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of times your mobile app was installed that were recorded as app events and attributed to your ads. The total count is based on when the events are returned through the SKAdNetwork API. There may be a delay between the actual conversion time and when the conversion is reported.

The number of unique app install events that are attributed to your ads, with withheld values due to Apple's privacy threshold. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Get the display name of app download ad.

Get the App retargeting audience type. For enum values, see Enumeration - App Retargeting Audience Type..

Get the Application id of the promoted app.

Get the Audience minimum ios version.

The Audience Network.

Get the Avatar URL.

The average order value per TikTok Shop purchase attributed to your ads. Gross revenue and purchases are reported based on the time each ad impression occurred.

Behavior.

Get the CPC, CPM bidding, oCPM learning bidding.

Get the Bid method.

Get the Bidding strategy on the campaign level. Return only when Campaign Budget Optimization is enabled.

Get the Bidding Strategy.

Get the Bidding strategy for in-app events.

Get the Billing method of Reach & Frequency ad groups. For more details, see Enumeration - Reach & Frequency Buy Type. Returned when objective_type of the related campaign is RF_REACH.

Get the Brand description, i.e. promotional content.

Get the Brand safety partner. Available only when brand_safety is THIRD_PARTY. Enum values: IAS, OPEN_SLATE. To get the countries and regions that your ads can be deployed to based on your brand safety settings, use the /tools/regions/ endpoint. You need to pass in the brand safety type and brand safety partner.

Get the Brand safety type. Currently, the only supported value is THIRD_PARTY. To get the countries and regions that your ads can be deployed to based on your brand safety settings, use the /tools/regions/ endpoint. You need to pass in the brand safety type and brand safety partner.

Get the Budget mode.

Whether Campaign Budget Optimization is enabled. Return only when Campaign Budget Optimization is enabled.

Get the Budget type.

Get the Call to action.

Get the ID of the CTA portfolio that you want to use in your ads. A CTA portfolio is a group of auto-optimized CTAs. If both this field and call_to_action are specified, this field will be used, and call_to_action will be ignored.

Get the Campaign Automation Type.

Get the Campaign budget.

Time at which the campaign was created.

Get the Campaign ID.

Whether the campaign is a new structure (for the same campaign, the structure of campaign, adgroups and ads are the same).

Get the Time at which the campaign was Modified.

Get the Campaign name.

Get the Operation status. Enum values: DISABLE, ENABLE.

Get the Optimization goal. Return only when Campaign Budget Optimization is enabled.

Get the Campaign status（Secondary status).

Get the Campaign type (application or landing page). Allowed values include: APP(application), LANDING_PAGE(Landing page).

Get the Campaign Type, indicates the campaign is a regular campaign or iOS 14 campaign. Enum values: REGULAR_CAMPAIGN and IOS14_CAMPAIGN.

Get the Image card ID, gift code card ID, or premium badge ID.

Get the Catalog ID。 Return when the corresponding campaign objective_type is CATALOG_SALES.

Get the Catalog video template ID. Return when the corresponding campaign objective_type is CATALOG_SALES.

For catalogs in Business Center, this field returns the ID of the Business Center that a catalog belongs to.

The percentage of TikTok Shop initiate checkout actions from clicks on your ads. Initiate checkout is reported based on the time each ad impression occurred.

The total value of TikTok Shop initiate checkout actions attributed to your ads. Initiate checkout is reported based on the time each ad impression occurred.

The number of TikTok Shop initiate checkout actions attributed to your ads, such as clicks on "Buy now" and "Buy with coupon" buttons on your product pages. Initiate checkout is reported based on the time each ad impression occurred.

The number of button click events.

The percentage of button click events out of all click events.

Get the Click monitoring URL.

Number of clicks from your ads. This includes clicks that lead to destination as well as those for social and interaction purposes.

The clicks

Clicks on Hashtag Challenge

The number of clicks on the official music in your Boosted TikTok ad during the campaign. Available only if you are on the allowlist for the Boosted TikTok feature.

The percentage of user registration events out of all click events.

Complete Tutorial (Total No.) (The total count is based on when you were billed.)

The percentage of unique complete tutorial events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Get the Contact Person.

The percentage of contact events out of all click events.

Get the conversion bid statistic type, bid for EVERYTIME (Each Purchase)/ NONE (Unique Purchase).

The conversion rate.

Percentage of conversions you received out of all destination clicks on your ads.

Percentage of conversions you received out of all impressions on your ads.

Get the The time frame when you would like a conversion to happen after a user clicks on or views your ad. Your ad delivery will be optimized using the conversion data during the time frame you select. This setting will not impact your attribution data.

The Conversions.

The number of times your ad achieved an outcome based on the objective and settings you selected. Data may be partial due to SKAdNetwork(SKAN) limitations.

Number of times your ad resulted in an intended outcome based on your optimization event.

The cost per 1000 reached.

Cost per Achieve Level (The total count is based on when you were billed.)

The average cost for each achieve level event that is attributed to your ads.

Cost per Add Payment Info (The total count is based on when you were billed.)

The average cost for each add payment info event that is attributed to your ads.

Cost per Add to Cart (The total count is based on when you were billed.)

The average cost per TikTok Shop add-to-cart action attributed to your ads. Add-to-cart is reported based on the time each ad impression occurred.

The average cost for each add to cart event that is attributed to your ads.

The average cost of each add to cart event.

Cost per Add to Wishlist (The total count is based on when you were billed.)

The average cost for each add to wishlist event that is attributed to your ads.

The average cost of each add to wishlist event.

The average cost for each app install event. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each app install event. The total count is based on when the events are returned through the SKAdNetwork API. There may be a delay between the actual conversion time and when the conversion is reported.

Cost per Checkout (The total count is based on when you were billed.)

The average cost for each checkout event that is attributed to your ads.

The average cost per TikTok Shop initiate checkout action attributed to your ads. Initiate checkout is reported based on the time each ad impression occurred.

The average cost of each button click event.

The average cost of each user registration event.

Cost per Complete Tutorial (The total count is based on when you were billed.)

The average cost for each complete tutorial event that is attributed to your ads.

The average cost of each contact event.

The cost per conversions.

Average amount you spent on a conversion.

Cost per Create Group (The total count is based on when you were billed.)

The average cost for each create group event that is attributed to your ads.

Cost per Create Role (The total count is based on when you were billed.)

The average cost for each create role event that is attributed to your ads.

The average cost per each app install event attributed to a click on your ad.

The average cost per each app install event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The average cost per each conversion event attributed to a click on your ad.

The average cost per each in-app conversion event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Average cost per in-app purchase event attributed to a click on your ad.

The average cost per each in-app purchase event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Average cost for an in-app registration event attributed to a click on your ad.

The average cost per each in-app registration event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The average cost per custom app event attributed to your ads.

Average cost incurred per custom page event triggered.

Cost per Day 1 Retention (The total count is based on when you were billed.)

The average cost of each download button click events.

The average cost per each app install event attributed to an ad impression within the EVTA conversion window.

The average cost per each conversion event attributed to an ad impression within the EVTA conversion window.

The average cost per in-app purchase action attributed to engaged views of your ad.

The average cost per website purchase action attributed to engaged views of your ad.

The average cost per registration action attributed to engaged views of your ad.

Cost per Generate Lead (The total count is based on when you were billed.)

The average cost for each generate lead event that is attributed to your ads.

Cost per In-App Ad Click (The total count is based on when you were billed.)

The average cost for each in-app ad click event that is attributed to your ads.

Cost per In-App Ad Impr (The total count is based on when you were billed.)

The average cost for each in-app ad impression event that is attributed to your ads.

The average cost of each initiate checkout event.

Cost per Join Group (The total count is based on when you were billed.)

The average cost for each join group event that is attributed to your ads.

The average cost of each landing page view event.

Cost per Launch App (The total count is based on when you were billed.)

The average cost for each launch app event that is attributed to your ads.

Cost per Loan Apply (The total count is based on when you were billed.)

The average cost for each loan apply event that is attributed to your ads.

Cost per Loan Approval (The total count is based on when you were billed.)

The average cost for each loan approval event that is attributed to your ads.

Cost per Loan Disbursement (The total count is based on when you were billed.)

The average cost for each loan disbursement event that is attributed to your ads.

Cost per Login (The total count is based on when you were billed.)

The average cost for each login event that is attributed to your ads.

The average cost of each page browse event.

The average cost of each page browse event.

The average cost of each add billing event.

The average cost of each place an order event.

The average cost per TikTok Shop product details page view attributed to your ads. Product details page views are reported based on the time each ad impression occurred.

Cost per Purchase (The total count is based on when you were billed.)

The average cost per TikTok Shop purchase attributed to your ads. Purchases are reported based on the time each ad impression occurred.

The average cost for each purchase event that is attributed to your ads.

The average cost of each Purchase event.

Cost per Rate (The total count is based on when you were billed.)

The average cost for each rate event that is attributed to your ads.

The average cost for each app install event. (The total count is based on when the conversion actually happened.)

Cost per Registration (The total count is based on when you were billed.)

The average cost for each registration event that is attributed to your ads.

Get the cost per result.

Average cost per each result from your ads.

Cost per Search (The total count is based on when you were billed.)

The average cost for each search event that is attributed to your ads.

Get the cost per secondary goal result.

Cost per Spend Credit (The total count is based on when you were billed.)

The average cost for each spend credit event that is attributed to your ads.

Cost per Start Trial (The total count is based on when you were billed.)

The average cost for each start trial event that is attributed to your ads.

The average cost of each form submission event.

Cost per Subscribe (The total count is based on when you were billed.)

The average cost for each subscribe event that is attributed to your ads.

The average cost for each unique achieve level event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique achieve level event that is attributed to your ads.

The average cost for each unique add payment info event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique add payment info event that is attributed to your ads.

The average cost for each unique add to cart event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique add to cart event that is attributed to your ads.

The average cost for each unique add to wishlist event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique add to wishlist event that is attributed to your ads.

The average cost for each unique checkout event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique checkout event that is attributed to your ads.

The average cost for each unique complete tutorial event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique complete tutorial event that is attributed to your ads.

The average cost for each unique create group event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique create group event that is attributed to your ads.

The average cost for each unique create role event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique create role event that is attributed to your ads.

The average cost per unique custom app event attributed to your ads.

The average cost for each unique day 1 retention event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique generate lead event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique generate lead event that is attributed to your ads.

The average cost for each unique in-app ad click event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique in-app ad click event that is attributed to your ads.

The average cost for each unique in-app ad impression event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique in-app ad impression event that is attributed to your ads.

The average cost for each unique join group event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique join group event that is attributed to your ads.

The average cost for each unique launch app event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique launch app event that is attributed to your ads.

The average cost for each unique loan apply event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique loan apply event that is attributed to your ads.

The average cost for each unique loan approval event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique loan approval event that is attributed to your ads.

The average cost for each unique loan disbursal event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique loan disbursal event that is attributed to your ads.

The average cost for each unique login event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique login event that is attributed to your ads.

The average cost of each unique purchase. (The total count is calculated based on the time each ad impression occurred.)

The average cost of each unique purchase that is attributed to your ads.

The average cost for each unique rate event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique rate event that is attributed to your ads.

The average cost for each unique registration that is attributed to your ad. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique registration event that is attributed to your ads.

The average cost for each unique search event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique search event that is attributed to your ads.

The average cost for each unique spend credits event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique spend credit event that is attributed to your ads.

The average cost for each unique start trial event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique start trial event that is attributed to your ads.

The average cost for each unique subscribe event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique subscribe event that is attributed to your ads.

The average cost for each unique unlock achievement event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique unlock achievement event that is attributed to your ads.

The average cost for each unique view content event that is attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The average cost for each unique view content event that is attributed to your ads.

Cost per Unlock Achievement (The total count is based on when you were billed.)

The average cost for each unlock achievement event that is attributed to your ads.

Cost per View Content (The total count is based on when you were billed.)

The average cost for each view content event that is attributed to your ads.

The average cost per each app install event attributed to an ad impression.

The average cost per each app install event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The average cost per each conversion event attributed to an ad impression.

The average cost per each conversion event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Average cost per in-app purchase event attributed to an ad impression.

The average cost per each in-app purchase event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Average cost of each website purchase event attributed to someone only viewing your ad.

Average cost per registration event attributed to an ad impression.

The average cost per each in-app registration event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The Country.

The Country code.

The average amount of money you've spent on a conversion. Data may be partial due to SKAdNetwork(SKAN) limitations.

The CPC

The cpm

Create Group (Total No.) (The total count is based on when you were billed.)

The percentage of unique create group events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Create Role (Total No.) (The total count is based on when you were billed.)

Get the Time at which the ad was created.

Get the Creative delivery mode. Note: When you choose automated ad, your creative materials will automatically be combined for delivery. Tiktok Ads' smart optimization algorithm is applied and will be used to achieve the best ad performance during delivery. Enum values: CUSTOM(custom), DYNAMIC(automated).

Get the creative type. Enum values: SINGLE_IMAGE, SINGLE_VIDEO, CAROUSEL.

The number of app install events attributed to a click on your ad.

The number of app install events attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The number of conversion events attributed to a click on your ad.

The number of in-app conversion events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The number of in-app purchase events attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Number of in-app purchase events attributed to clicks on your ad based on information received from your measurement partner.

The number of in-app registration events attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Number of in-app registration events attributed to a click on your ad based on information received from your measurement partner.

Percentage of impressions that resulted in a click out of all impressions.

The ctr

The percentage of custom app events from all app installs attributed to your ads.

The total value of custom app events attributed to your ads.

The number of custom app events attributed to your ads.

The rate at which the custom page event occurred relative to impressions or clicks.

Number of times the custom page event was triggered.

Total value generated by all custom page events.

The percentage of conversions from all clicks of your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The percentage of conversions from all impressions on your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Year, month, and day.

Day 1 Retention (Total No.) (The total count is based on when you were billed.)

The percentage of unique day 1 retention events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Day of the year

Week of the year

Get the Deep bid.

Get the Secondary-goal event when the optimize_goal is INSTALL or VALUE..

The Device Brand.

The Device.

Get the Display monitoring URL.

Get the display name of landing page or pure exposure ad.

The DMA.

The percentage of download button click events out of all click events.

In DPA scenario, the fallback behavior of deeplink evokes failed. Return when the corresponding campaign objective_type is CATALOG_SALES.

Indicates the source of the direct link used in the ad. This field is returned when the corresponding campaign objective_type is CATALOG_SALES.

Get the dpa target audience type.

The number of engaged views. Engaged view means that people watch six seconds or longer of your video OR interact with the video (for example, Like/Share). Note: This feature is on the allowlist. If you would like access to it, please reach out to your TikTok representative.

Get the estimated cost per mile reach. Returned when objective_type of the related campaign is RF_REACH.

Get the estimated show frequency. Returned when objective_type of the related campaign is RF_REACH.

The number of app install events attributed to an ad impression within the EVTA conversion window.

The number of conversion events attributed to an ad impression within the EVTA conversion window.

The number of in-app purchase actions attributed to engaged views of your ad.

The number of website purchase actions attributed to engaged views of your ad.

The number of registration actions attributed to engaged views of your ad.

Get the Conversion event for the ad group.

Get the Fallback Type. If the audience do not have the app installed, you can have them fall back to install the app, or to view a specific web page. Not applicable for Deferred Deeplink. Allowed values: APP_INSTALL, WEBSITE, UNSET. If website is chosen, you need to specify the url via landing_page_url field.

The average number of times each unique user saw your ads in the reporting period. This metric is estimated.

Get the frequency, together with frequency, controls how often people see your ad (only available for REACH ads).

The Gender.

Generate Lead (Total No.) (The total count is based on when you were billed.)

The percentage of unique generate lead events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Get the Ad account time zone including GMT offset. For example, "Etc/GMT".

The gross revenue of TikTok Shop orders attributed to your ads. It's the amount people pay, plus any discounts provided to them by TikTok Shop platform. Gross revenue is reported based on the time each ad impression occurred.

Hour of the day

The impressions

Get the Impressions to be purchased. Returned when objective_type of the related campaign is RF_REACH.

In-App Ad Click (Total No.) (The total count is based on when you were billed.)

The percentage of unique in-app ad click events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

In-App Ad Impr (Total No.) (The total count is based on when you were billed.)

The percentage of unique in-app ad impression events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of initiate checkout events out of all click events.

Instant Page (InstantForm or Storefront Page) ID.

Get the Instant page type in your ad group. Currently, the only supported type is TIKTOK_NATIVE_PAGE, which stands for TikTok instant pages. null means no instant pages are used in the ad group.

Interest Category first level.

Interest Category fourth level

Interest Category second level

Interest Category third level

Interest Category V2 first level.

Get the Inventory filtering (filtering security videos, hides unsafe videos), valid only for the PLACEMENT_TIKTOK placement. Optional values are: true to filter, false not to filter..

Whether the campaign will be counted against the iOS 14 dedicated campaign quota. Enum: OCCUPIED, UNOCCUPIED. For non-R&F campaigns, when ios_target_device is IOS14_PLUS, this field is automatically set to OCCUPIED.

The iOS devices that you want to target. UNSET: This is the previous default value of the field. IOS14_MINUS: Devices with iOS 14.4 or earlier version that are not affected by the iOS 14 privacy update. This is the default value for ad groups that are created after the introduction of this field. IOS14_PLUS: Devices with iOS 14.5 and above. The iOS 14 privacy update has been enforced in this group of devices..

Whether the ad is an automated ad. Set to true for automated ad and false for non-automated ad.

Whether to allow comments on your ads on TikTok, Vigo, Helo. Enum values: 0 (allow), 1 (restrict). The default calue is allow.

Whether you grant displaying some of your ads in our TikTok For Business Creative Center. Only valid for non-US advertisers, the default value is false.

Whether the promoted product is HFSS foods (foods that are high in fat, salt, or sugar).

Whether the campaign is a new structure

Whether to disable the promotional use of the music in the Spark Ad post. The default value is true. If you want to allow dueting and stitching for the Spark Ad post, you need to set this field to false. This field is only valid for Spark Ad posts.

Whether to enable dueting for the Spark Ad post. This field is valid only when promotional_music_disabled is set to false. Enum values: ENABLE, DISABLE. This field is only valid for Spark Ad posts.

Whether to enable stitching for the Spark Ad post. This field is valid only when promotional_music_disabled is set to false. Enum values: ENABLE, DISABLE. This field is only valid for Spark Ad posts.

Join Group (Total No.) (The total count is based on when you were billed.)

The percentage of unique join group events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of click events that are landing page view events.

Get the Landing page URL.

Language

Launch App (Total No.) (The total count is based on when you were billed.)

The percentage of unique launch app events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Get the License number.

Get the License preview address, the link is valid for an hour by default.

Number of time viewers clicked a product and viewed its details page during your LIVE.

Number of unique users who saw your LIVE at least once from an ad.

Number of times your LIVE was viewed from an ad. Revisits are counted.

Loan Apply (Total No.) (The total count is based on when you were billed.)

The percentage of unique loan apply events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Loan Approval (Total No.) (The total count is based on when you were billed.)

The percentage of unique loan approval events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Loan Disbursement (Total No.) (The total count is based on when you were billed.)

The number of unique loan disbursals in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

Login (Total No.) (The total count is based on when you were billed.)

The percentage of unique login events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Get the Minimum Android version.

Whether Moat Viewability Verification is enabled for the ad. TikTok has partnered with Moat to launch viewability measurement for Brand Auction and Reach & Frequency In-feed ads purchased on TikTok for Business.

Get the mobile app id.

Get the Time at which the ad was Modified.

Month and day

Month of the year

Get the oCPM conversion bid.

Get the specific location where you want your audience to go if they have your app installed. See open_url_type for more.

Get the open URL type. Allowed values differs based on campaign objectives. Allowed values: NORMAL(supported in Traffic, Conversion & CatalogSales), DEFERRED_DEEPLINK(supported in AppInstall & Catalog Sales).

Get the Operational status. Enum: DISABLE (ad group is disabled), ENABLE (ad group is enabled), FROZEN (terminated and cannot be used again).

Get the Optimized video playback duration. Optional values include: SIX_SECONDS (video playback 6 seconds) and TWO_SECONDS (video playback 2 seconds).

Get the You can choose between PACING_MODE_SMOOTH and PACING_MODE_FAST. For PACING_MODE_SMOOTH, the budget is allocated evenly within the scheduled time. PACING_MODE_FAST would consume budget and produce results as soon as possible. When Campaign Budget Optimization (budget_optimize_switch) is on, your setting will be ignored and it will be set as PACING_MODE_SMOOTH. Otherwise, this field is required.

The number of page browse events.

The percentage of page browse events out of all click events.

The percentage of page browse events out of all click events.

The number of comments your video creative received within 1 day of a user seeing a paid ad.

The sum of Paid Likes, Paid Shares and Paid Comments.

The number of new followers that were gained within 1 day of a user seeing a paid ad. This metric is only for Boosted TikToks.

The number of likes your video creative received within 1 day of a user seeing a paid ad.

The number of shares your video creative received within 1 day of a user seeing a paid ad.

The number of add billing events.

Get the Contact mobile number, desensitised data.

Get the Pixel ID. Only application for landing pages.

The percentage of place an order events out of all click events.

The Placement.

Get the Placement type. Allowed values: PLACEMENT_TYPE_AUTOMATIC (automatic placement), PLACEMENT_TYPE_NORMAL (manual placement).

Get the Playable material url.

The number of product details page browse events.

The average cost of each product details page browse event.

The percentage of product details page browse events out of all click events.

The percentage of TikTok Shop product details page views from clicks on your ads. Product details page views are reported based on the time each ad impression occurred.

The total value of TikTok Shop product details page views attributed to your ads. Product details page views are reported based on the time each ad impression occurred.

The number of TikTok Shop product details page views attributed to your ads. Product details page views are reported based on the time each ad impression occurred.

Get the ProductSet ID of the catalog. 0 means selecting all product sets. Return when the corresponding campaign objective_type is CATALOG_SALES.

The number of profile visits the ad drove during the campaign. This metric is only for Boosted TikToks.

The rate of profile visits per impression the paid ad drove during the campaign. This metric is only for Boosted TikToks.

Get the Promotion type.

Get the promotion type.

The Province.

Purchase (Total No.) (The total count is based on when you were billed.)

The percentage of unique purchase event out of all the app install event. (The total count is calculated based on the time each ad impression occurred.)

The percentage of Purchase events out of all click events.

The percentage of TikTok Shop purchases from clicks on your ads. Purchases are reported based on the time each ad impression occurred.

Return on ad spend (ROAS) from purchase events. (The total count is based on when you were billed.)

The total return on ad spend (ROAS) from purchase events. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The total return on ad spend (ROAS) from Purchase events that are attributed to your ads.

Get the Purchased user reach. Returned when objective_type of the related campaign is RF_REACH.

The number of TikTok Shop order submission actions attributed to your ads. Purchases are reported based on the time each ad impression occurred.

Quarter of the year

Rate (Total No.) (The total count is based on when you were billed.)

The percentage of unique rate events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The Reach

The real time conversion

The reat time conversion rate

The real time cost per conversion

Get the real time cost per result.

Get the real time result.

Get the real time result rate.

The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is based on when the conversion actually happened.)

Get the Reason for rejection.

The percentage of unique registration events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Get the result.

Get the result rate.

Percentage of results that happened out of all impressions on your ads.

Number of times your ad resulted in an intended outcome based on your campaign objective and optimization goal.

The return on ad spend (ROAS) from TikTok Shop gross revenue attributed to your ads. Gross revenue is reported based on the time each ad impression occurred.

Get the ROAS goal for Value Optimization.

The schedule type can be either SCHEDULE_START_END or SCHEDULE_FROM_NOW. If you choose SCHEDULE_START_END, you need to specify a start time and an end time. If you choose SCHEDULE_FROM_NOW, you only need to specify a start time.

The number of search events.

The average cost of each search event.

The percentage of unique search events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of search events out of all click events.

Get the secondary goal result rate.

Get the secondary goal result.

Whether to skip the learning stage. Optional values include: 0 (not skip), 1 (skip).

The spend

Spend Credit (Total No.) (The total count is based on when you were billed.)

The percentage of unique spend credits events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of unique spend credit events out of all app install events.

Get the Split Test variables. Optional values: TARGETING, BIDDING_OPTIMIZATION , CREATIVE. Null means that the campaign will not be a Split Test Campaign.

Start Trial (Total No.) (The total count is based on when you were billed.)

The percentage of unique start trial events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of form submission events out of all click events.

Subscribe (Total No.) (The total count is based on when you were billed.)

The average cost of each subscribe event.

The percentage of unique subscribe events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of subscribe events out of all click events.

Get the The advertiser's country.

Get the ID of the TikTok post to be used as an ad. It can be obtained from Get Spark Ad post endpoint.

Get the Timezone name in the format of "Region/City" (based on the TZ database name conventions. For example, "Europe/London".

The number of times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads.

Total Achieve Level Value (The total count is based on when you were billed.)

The value of achieve level events in your mobile app that were recorded as app events and attributed to your ads.

Total Add Payment Info. The total count is based on when you were billed.

The number of times a user added payment info in your mobile app that were recorded as app events and attributed to your ads.

Add to Cart (Total No.) (The total count is based on when you were billed.)

The number of times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads.

Total Add to Cart Value (The total count is based on when you were billed.)

The value of add to cart events in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from add to cart events.

Add to Wishlist (Total No.) (The total count is based on when you were billed.)

The number of times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads.

The number of add to wishlist events that are attributed to your ads.

Total Add to Wishlist Value (The total count is based on when you were billed.)

The value of add to wishlist events in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from all add to wishlist events.

Checkout (Total No.) (The total count is based on when you were billed.)

The number of times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads.

Total Checkout Value (The total count is based on when you were billed.)

The value of checkout events in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from button click events.

The number of user registration events.

The total value returned from user registration events.

The number of times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads.

Total Complete Tutorial Value (The total count is based on when you were billed.)

The value of complete tutorial events in your mobile app that were recorded as app events and attributed to your ads.

The number of contact events.

The total value returned from contact events.

The number of groups created in your mobile app that were recorded as app events and attributed to your ads.

Total Create Group Value (The total count is based on when you were billed.)

The value of create group events in your mobile app that were recorded as app events and attributed to your ads.

The number of times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads.

Total Create Role Value (The total count is based on when you were billed.)

The value of create role events in your mobile app that were recorded as app events and attributed to your ads.

The number of download button click events.

The total value returned from download button click events.

The number of leads generated in your mobile app that were recorded as app events and attributed to your ads.

Total Generate Lead Value (The total count is based on when you were billed.)

The value of generate lead events in your mobile app that were recorded as app events and attributed to your ads.

The number of in-app ad click events that occurred in your mobile app and are attributed to your ads.

Total In-App Ad Click Value (The total count is based on when you were billed.)

The value of in-app ad click events in your mobile app that were recorded as app events and attributed to your ads.

Total In-App Ad Impr Value (The total count is based on when you were billed.)

The number of in-app ad impression events that occurred in your mobile app and are attributed to your ads.

The value of in-app ad impression events in your mobile app that were recorded as app events and attributed to your ads.

The number of initiate checkout events.

The total value returned from initiate checkout events.

The number of times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads.

Total Join Group Value (The total count is based on when you were billed.)

The value of join group events in your mobile app that were recorded as app events and attributed to your ads.

The number of landing page view events from your ads.

The number of times a user launched your mobile app that were recorded as app events and attributed to your ads.

The number of times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads.

The number of times a user was approved for a loan in your mobile app that were recorded as app events and attributed to your ads.

The number of loan disbursals in your mobile app that were recorded as app events and attributed to your ads.

The number of logins in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from page browse events.

The total number of page browse events.The total count is calculated based on the time each ad impression occurred.

The total value returned from page browse events.

The number of place an order events.

The total value returned from place an order events.

The total value returned from product details page browse events.

The number of purchases in your mobile app that were recorded as app events and attributed to your ads.

The number of Purchase events.

Total Purchase Value (The total count is based on when you were billed.)

The total value of purchase events in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from Purchase events.

The number of ratings in your mobile app that were recorded as app events and attributed to your ads.

Total Rate Value (The total count is based on when you were billed.)

The value of rate events in your mobile app that were recorded as app events and attributed to your ads.

Total Registration. The total count is based on when you were billed.

The number of registrations in your mobile app that were recorded as app events and attributed to your ads.

Total search (The total count is based on when you were billed.)

The number of searches in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from search events.

The number of times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads.

Total Spend Credit Value (The total count is based on when you were billed.)

The value of spend credit events in your mobile app that were recorded as app events and attributed to your ads.

The number of times a user started a trial in your mobile app that were recorded as app events and attributed to your ads.

The number of form submission events.

The total value returned from form submission events.

The number of subscriptions in your mobile app that were recorded as app events and attributed to your ads.

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

Total Subscribe Value (The total count is based on when you were billed.)

The value of subscribe events in your mobile app that were recorded as app events and attributed to your ads.

The total value returned from all subscribe events.

The number of times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads.

Total Unlock Achievement Value (The total count is based on when you were billed.)

The value of unlock achievement events in your mobile app that were recorded as app events and attributed to your ads.

Total View Content. The total count is based on when you were billed.

The number of times a user viewed content in your mobile app that were recorded as app events and attributed to your ads.

Total View Content Value (The total count is based on when you were billed.)

The value of view content events in your mobile app that were recorded as app events and attributed to your ads.

Get the tt app id.

Get the tt app name.

Get the Type of currency used by advertisers.

Get the types of ad redirection in the catalog. Returned when the corresponding campaign objective_type is CATALOG_SALES.

The number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads.

The number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique add payment info events out of all app install events.

The number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique add to cart events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of unique add to cart events out of all app install events.

The number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique add to wishlist events out of all app install events.

The number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique checkout events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of unique checkout events out of all app install events.

The number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique complete tutorial events out of all app install events.

The number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads.

The percentage of unique create group events out of all app install events.

The number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads.

The percentage of unique create role events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The percentage of unique create role events out of all app install events.

The number of unique custom app events attributed to your ads.

The number of unique day 1 retentions in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique generate lead events out of all app install events.

The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads.

The percentage of unique in-app ad click events out of all app install events.

The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads.

The percentage of unique in-app ad impression events out of all app install events.

The number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads.

The percentage of unique join group events out of all app install events.

The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique launch app events out of all app install events.

The number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique loan apply events out of all app install events.

The number of unique times a user was approved a loan in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user was approved for a loan in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique loan approval events out of all app install events.

The number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique loan disbursals in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique loan disbursals in your mobile app that were recorded as app events and attributed to your ads.

The number of unique logins in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique logins in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique login events out of all app install events.

The percentage of add billing events out of all click events.

The number of unique purchases event occurred in your app that were recorded by your measurement partner. (The total count is calculated based on the time each ad impression occurred.)

The number of unique purchases that occurred in your app and were recorded by your measurement partner.

The percentage of unique purchase events out of all app install events.

The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique rate events out of all app install events.

The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique registration events out of all app install events.

The number of unique searches in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique searches in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique search events out of all app install events.

The number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads.

The number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique start trial events out of all app install events.

The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique subscribe events out of all app install events.

The number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads.

The percentage of unique unlock achievement events out of all app install events.

The number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.)

The number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads.

The percentage of unique view content events out of all app install events.

Unlock Achievement (Total No.) (The total count is based on when you were billed.)

The percentage of unique unlock achievement events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

Value per Achieve Level (The total count is based on when you were billed.)

Value per Add to Cart (The total count is based on when you were billed.)

The average value of TikTok Shop add-to-cart actions attributed to your ads. Add-to-cart is reported based on the time each ad impression occurred.

The average value returned from add to cart events.

Value per Add to Wishlist (The total count is based on when you were billed.)

The average value returned from each add to wishlist event.

Value per Checkout (The total count is based on when you were billed.)

The average value of TikTok Shop initiate checkout actions attributed to your ads. Initiate checkout is reported based on the time each ad impression occurred.

The average value returned from button click events.

The average value returned from user registration events.

Value per Complete Tutorial (The total count is based on when you were billed.)

The average value returned from contact events.

Value per Create Group (The total count is based on when you were billed.)

Value per Create Role (The total count is based on when you were billed.)

The average value per custom app event attributed to your ads.

Monetary value associated with each custom page event.

The average value returned from download button click events.

Value per Generate Lead (The total count is based on when you were billed.)

Value per In-App Ad Click (The total count is based on when you were billed.)

Value per In-App Ad Impr (The total count is based on when you were billed.)

The average value returned from initiate checkout events.

Value per Join Group (The total count is based on when you were billed.)

The average value returned from page browse events.

The average value returned from page browse events.

The average value returned from add billing events.

The average value returned from place an order events.

The average value returned from product details page browse events.

The average value of TikTok Shop product details page views attributed to your ads. Product details page views are reported based on the time each ad impression occurred.

Value per Purchase (The total count is based on when you were billed.)

The average value returned from Purchase events.

Value per Rate (The total count is based on when you were billed.)

The average value returned from search events.

Value per Spend Credit (The total count is based on when you were billed.)

The average value returned from form submission events.

Value per Subscribe (The total count is based on when you were billed.)

The average value returned from each subscribe event.

Value per Unlock Achievement (The total count is based on when you were billed.)

Value per View Content (The total count is based on when you were billed.)

The average time your video was played per person, including any time spent replaying the video. This metric is estimated.

The average time your video was played per single video view, including any time spent replaying the video.

COVER URL for video creative.

Whether users can download your video ads on TikTok. Allowed values: ALLOW_DOWNLOAD ,PREVENT_DOWNLOAD Default: ALLOW_DOWNLOAD.

Get the video ID. When TikTok posts are used as ads, video_id is invalid. You can get the the ID of a TikTok post via the tiktok_item_id field.

Preview URL for video creative.

The number of times your video starts to play. Replays will not be counted.

The number of times your video was played at 25% of its length. Replays will not be counted.

The number of times your video was played at 50% of its length. Replays will not be counted.

The number of times your video was played at 75% of its length. Replays will not be counted.

The number of times your video was played at 100% of its length. Replays will not be counted.

The percentage of unique view content events out of all app install events. (The total count is calculated based on the time each ad impression occurred.)

The number of app install events attributed to an ad impression.

The number of app install events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The number of conversion events attributed to an ad impression.

The number of conversion events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

The number of in-app purchase events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Return on ad spend (ROAS) from purchase events attributed to someone only viewing your ad.

Total value of purchase events attributed to someone only viewing your ad.

Number of in-app purchase events attributed to an ad impression based on information received from your measurement partner.

Website purchase events attributed to someone only viewing your ad.

The number of in-app registration events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations.

Number of registration events attributed to an ad impression based on information received from your measurement partner.

Week of the year

Week of the year

Year such as 2017.

Year and month.

Year, month, day, and hour.

Year and quarter.

Year and week.