Skai: Most-used fields
The table below gives information about most-used fields that you can import from Skai. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
14 daysMetric
Represents a 14-day attribution window or reporting period for various marketing metrics.
14 days unitsMetric
The number of units sold or converted within a 14-day attribution window.
30 daysMetric
Represents a 30-day attribution window or reporting period for various marketing metrics.
ACoSMetric
The total advertising cost of sale (TACoS), calculated as total ad cost divided by product ordered revenue.
Account NameDimension
The name of the advertising account.
Ad Group IDDimension
The unique identifier for an ad group.
Ad Group NameDimension
The name assigned to the ad group.
Ad Group StatusDimension
The current operational state of an ad group, such as 'Active', 'Paused', or 'Deleted'. This is available as the 'status' field for ad groups.
Ad IDDimension
The unique identifier for an advertisement.
Ad NameDimension
The name assigned to the advertisement.
Ad TypeDimension
The format or category of the advertisement (e.g., Text Ad, Product Ad, Image Ad).
AdGroup ID in KenshooMetric
A unique identifier assigned by Skai (formerly Kenshoo) to an ad group.
AdGroup end dateDimension
The date when the ad group is scheduled to stop running.
AdGroup start dateDimension
The date when the ad group is scheduled to begin running.
Avg. CPCMetric
Average Cost Per Click, a common performance metric indicating the average amount paid for each click on an advertisement. This metric is usually available in performance reports.
Brand NameDimension
The name of the brand associated with the product or campaign.
CTRMetric
Click-Through Rate, the percentage of people who see an ad and click on it, calculated as (Clicks / Impressions) * 100.
Campaign Bid StrategyDimension
The strategy used to manage bids for a campaign or portfolio, which can include various automated or manual bidding methods to achieve specific marketing objectives like maximizing clicks or conversions. This is reflected in fields like 'bidding_method' for ad groups and 'publisher_bid_strategy' for portfolios.
Campaign End DateDimension
The scheduled date when the campaign is set to conclude. This is available as the 'end_date' field for campaigns.
Campaign GoalDimension
The primary objective of the campaign, such as increasing conversions, clicks, or brand awareness.
Campaign IDDimension
The unique identifier for an advertising campaign.
Campaign NameDimension
The name assigned to the advertising campaign.
Campaign Start DateDimension
The scheduled date when the campaign is set to begin. This is available as the 'start_date' field for campaigns.
Campaign StatusDimension
The current operational status of the campaign (e.g., Active, Paused, Deleted).
Campaign TypeDimension
A categorical attribute that classifies campaigns based on their objective or structure, such as search, social, or shopping.
ChannelDimension
The advertising channel where the campaign is running, such as Google, Facebook, or Amazon.
Channel Account IDDimension
The unique identifier for an account on a specific advertising channel.
Channel Account Publisher IDMetric
The unique identifier for a publisher account within a specific advertising channel.
Channel Ad Group IDMetric
The unique identifier for an ad group on a specific advertising channel.
Channel Ad IDMetric
The unique identifier for an ad on a specific advertising channel.
Channel Campaign IDMetric
The unique identifier for a campaign on a specific advertising channel.
ClicksMetric
The number of times users clicked on an ad.
Conv.Metric
The total number of conversions recorded. This corresponds to the 'Conversions' field (ID 'T2106') available in performance and conversion type reports.
Conv. RateMetric
Conversion Rate, the percentage of clicks or ad interactions that result in a conversion.
ConversionsMetric
The total number of desired actions taken by users after interacting with an ad.
CostMetric
The total amount spent on advertising.
Cost/Conv.Metric
Cost per Conversion, the average cost incurred to achieve one conversion.
CurrencyDimension
The monetary unit used for financial transactions and reporting.
Custom Parameter 1Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Custom Parameter 2Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Custom Parameter 3Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Daily BudgetMetric
The maximum amount allocated to be spent on a campaign or ad group per day. This can be found in the 'budget' field with 'DAILY' as the 'budget_type' for ad groups, and a general 'budget' for campaigns.
DateDimension
The specific calendar date for which the data is reported.
Device PreferenceDimension
The preferred device type (e.g., mobile, desktop, tablet) for displaying ads.
Dimension - Funnel stage (auto-tag)Dimension
An automatically generated tag or label indicating the stage of the marketing funnel an ad group or campaign is targeting. This relates to 'Smart Tags' or 'Dimensions' which are AI-powered insights or user-defined labels.
Dimensions Ad Group NameDimension
The name of the ad group, used as a dimension for reporting and analysis. This corresponds to the 'name' field of an ad group.
Dimensions: Audience TypeDimension
A categorization of the target audience (e.g., remarketing audience, interest-based audience). This is a dimension available for reporting and segmentation.
Dimensions: Campaign TypeDimension
The classification of a campaign, such as 'TEXT_CAMPAIGN' or 'SHOPPING_STANDARD'. This is available as the 'campaign_type' field for campaigns.
Dimensions: MarketDimension
An organization-level labeling column representing a specific market. This is part of the 'Dimensions' column group, defined by users in the organization.
Dimensions: Product CategoryDimension
A dimension identifying the category of products associated with ad groups or campaigns. This can be derived from product group nodes.
Dimensions: Product NameDimension
A dimension representing the name of a product. Data for individual products can be reported via the 'PRODUCT_ASSET' entity.
Dimensions: PromotionsDimension
A custom dimension used for categorizing and reporting on advertising campaigns or assets related to specific promotions.
Dimensions: SKU IDDimension
A dimension representing the Stock Keeping Unit (SKU) identifier for products. Product-level data is available through the 'PRODUCT_ASSET' entity.
Dimensions: TerritoryDimension
A custom dimension used for categorizing and reporting on advertising campaigns or assets based on geographical territory or region.
Dimensions: UTM_Medium ParameterDimension
The value of the 'utm_medium' URL parameter, used for tracking the originating channel or medium of traffic to a website. This is a common marketing attribution dimension.
Display URLDimension
The URL that is shown in an advertisement to users.
FromDimension
The start date or point in time for a reporting period.
HeadlineDimension
The main title or heading of an advertisement.
Headline 2Dimension
The secondary headline text used in an advertisement.
Headline 3Dimension
The third headline text used in an advertisement, if applicable.
Image NameDimension
The name of the image asset used in an advertisement.
Image UrlDimension
The URL of the image asset used in an advertisement.
Imp.Metric
The total number of impressions, representing how many times an advertisement was displayed. This is available as the 'Impressions' field (ID 'S3012') in performance reports.
ImpressionsMetric
The number of times an ad was displayed to users.
KeywordDimension
A word or phrase that advertisers use to match their ads with the terms people are searching for.
Land URLDimension
The final URL where users are directed after clicking on an ad.
Line 1Dimension
The first line of description text in an advertisement.
Line 2Dimension
The second line of description text in an advertisement.
Match TypeDimension
The type of match (e.g., Broad, Exact, Phrase) applied to keywords to control which searches can trigger an ad.
Mobile URLDimension
The URL optimized for mobile devices where users are directed after clicking on an ad.
ModifiedDimension
The date and time when a particular record or entity was last updated or modified.
NetworkDimension
The advertising network (e.g., Search Network, Display Network) where ads are displayed.
New to Brand Bid Adj.Metric
This field represents a bid adjustment applied to advertising campaigns with the goal of optimizing for the acquisition of new-to-brand customers. It reflects strategies to attract customers who have not previously purchased from the brand.
Path 1Dimension
The first optional path shown in the display URL of an ad.
Path 2Dimension
The second optional path shown in the display URL of an ad.
Portfolio IDDimension
A unique identifier for a portfolio, which groups campaigns for collective management and budgeting. This is available as the 'id' field for portfolios.
Portfolio NameDimension
The name assigned to the portfolio.
Product IDMetric
The unique identifier for a product.
Product Pages Bid Adj.Metric
A percentage increase or decrease in the bid for this placement, specifically on product pages.
Product TypeDimension
A classification that describes the kind of product being advertised.
Profile IDDimension
The unique identifier for a user profile in the Skai platform, representing a distinct advertiser account or client.
Profile NameDimension
The name of the user profile in the Skai platform.
ProfitMetric
The financial gain from advertising activities after deducting costs.
PublisherDimension
The platform or network where ads are displayed (e.g., Google, Facebook, Amazon).
Quality ScoreMetric
A diagnostic score reported by search engines that reflects the quality and relevance of keywords, ads, and landing pages.
ROIMetric
Return on Investment, a performance measure used to evaluate the efficiency of an investment, calculated as (Revenue - Cost) / Cost.
Report End DateDimension
The last date included in the report's data range.
Report Start DateDimension
The first date included in the report's data range.
Rest of Search Bid Adj.Metric
A percentage increase or decrease in the bid for placements outside of the top-of-search results.
Rev.Metric
Abbreviation for Revenue, the total income generated from advertising campaigns.
Rev./Conv.Metric
Revenue per Conversion, the average revenue generated from each conversion.
Serving ErrorDimension
Indicates errors encountered during the delivery or 'serving' of ads or other marketing content. These errors can be reported in API responses, often within error arrays for specific entities, or through system-level HTTP status codes like 400 or 500.
Tag IDDimension
A unique identifier for a tag applied to marketing entities like campaigns or ad groups. The API supports getting and editing tags.
Targeting TypeDimension
The method or criteria used to define the audience for an ad group, such as demographics, interests, or behaviors. This is part of the 'targeting' object in Ad Group entities.
ToDimension
The end date or point in time for a reporting period.
Top of Search Bid Adj.Metric
A percentage increase or decrease in the bid for top-of-search placement.
Tracking IDMetric
A unique identifier used for tracking purposes, often associated with a conversion pixel or analytics tag.
Tracking TemplateDimension
A URL template used to define how tracking information is appended to landing page URLs.
conversionsMetric
The total number of desired actions taken by users after interacting with an ad.
new to brand ordersMetric
The number of orders placed by customers who are new to the brand, as defined by the advertiser.
new to brand unitsMetric
The number of product units sold to customers who are new to the brand, as defined by the advertiser.
offline purchaseMetric
A conversion event representing a purchase made offline. This can be categorized under 'External report conversion' or 'Skai pixel conversion' types which collect conversions from files, integrations, or Skai's pixel.
offline purchase_revenueMetric
The revenue generated from offline purchase conversions. The API supports including revenue columns for selected conversion types in reports.
ordersMetric
The number of successful purchase transactions or conversions resulting from advertising efforts. This is a critical conversion metric.
orders_revenueMetric
The revenue generated from orders. The API supports including revenue columns for selected conversion types in reports.
revenueMetric
An aggregation of all monetary value of conversion actions, originating from publishers, Skai's pixel, and third-party integrations. This metric is available in performance reports.
units soldMetric
The total number of product units purchased by customers.
videocompleteMetric
A performance metric indicating the number of times a video ad played to 100% completion. This is available as a video-specific performance metric.
videostartMetric
A performance metric indicating the number of times a video ad began playing. This is available as a video-specific performance metric.