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 days Metric
Represents a 14-day attribution window or reporting period for various marketing metrics.
14 days units Metric
The number of units sold or converted within a 14-day attribution window.
30 days Metric
Represents a 30-day attribution window or reporting period for various marketing metrics.
ACoS Metric
The total advertising cost of sale (TACoS), calculated as total ad cost divided by product ordered revenue.
Account Name Dimension
The name of the advertising account.
Ad Group ID Dimension
The unique identifier for an ad group.
Ad Group Name Dimension
The name assigned to the ad group.
Ad Group Status Dimension
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 ID Dimension
The unique identifier for an advertisement.
Ad Name Dimension
The name assigned to the advertisement.
Ad Type Dimension
The format or category of the advertisement (e.g., Text Ad, Product Ad, Image Ad).
AdGroup ID in Kenshoo Metric
A unique identifier assigned by Skai (formerly Kenshoo) to an ad group.
AdGroup end date Dimension
The date when the ad group is scheduled to stop running.
AdGroup start date Dimension
The date when the ad group is scheduled to begin running.
Avg. CPC Metric
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 Name Dimension
The name of the brand associated with the product or campaign.
CTR Metric
Click-Through Rate, the percentage of people who see an ad and click on it, calculated as (Clicks / Impressions) * 100.
Campaign Bid Strategy Dimension
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 Date Dimension
The scheduled date when the campaign is set to conclude. This is available as the 'end_date' field for campaigns.
Campaign Goal Dimension
The primary objective of the campaign, such as increasing conversions, clicks, or brand awareness.
Campaign ID Dimension
The unique identifier for an advertising campaign.
Campaign Name Dimension
The name assigned to the advertising campaign.
Campaign Start Date Dimension
The scheduled date when the campaign is set to begin. This is available as the 'start_date' field for campaigns.
Campaign Status Dimension
The current operational status of the campaign (e.g., Active, Paused, Deleted).
Campaign Type Dimension
A categorical attribute that classifies campaigns based on their objective or structure, such as search, social, or shopping.
Channel Dimension
The advertising channel where the campaign is running, such as Google, Facebook, or Amazon.
Channel Account ID Dimension
The unique identifier for an account on a specific advertising channel.
Channel Account Publisher ID Metric
The unique identifier for a publisher account within a specific advertising channel.
Channel Ad Group ID Metric
The unique identifier for an ad group on a specific advertising channel.
Channel Ad ID Metric
The unique identifier for an ad on a specific advertising channel.
Channel Campaign ID Metric
The unique identifier for a campaign on a specific advertising channel.
Clicks Metric
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. Rate Metric
Conversion Rate, the percentage of clicks or ad interactions that result in a conversion.
Conversions Metric
The total number of desired actions taken by users after interacting with an ad.
Cost Metric
The total amount spent on advertising.
Cost/Conv. Metric
Cost per Conversion, the average cost incurred to achieve one conversion.
Currency Dimension
The monetary unit used for financial transactions and reporting.
Custom Parameter 1 Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Custom Parameter 2 Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Custom Parameter 3 Dimension
A user-defined custom parameter (Dimension) that can store additional data for reporting and segmentation.
Daily Budget Metric
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.
Date Dimension
The specific calendar date for which the data is reported.
Device Preference Dimension
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 Name Dimension
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 Type Dimension
A categorization of the target audience (e.g., remarketing audience, interest-based audience). This is a dimension available for reporting and segmentation.
Dimensions: Campaign Type Dimension
The classification of a campaign, such as 'TEXT_CAMPAIGN' or 'SHOPPING_STANDARD'. This is available as the 'campaign_type' field for campaigns.
Dimensions: Market Dimension
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 Category Dimension
A dimension identifying the category of products associated with ad groups or campaigns. This can be derived from product group nodes.
Dimensions: Product Name Dimension
A dimension representing the name of a product. Data for individual products can be reported via the 'PRODUCT_ASSET' entity.
Dimensions: Promotions Dimension
A custom dimension used for categorizing and reporting on advertising campaigns or assets related to specific promotions.
Dimensions: SKU ID Dimension
A dimension representing the Stock Keeping Unit (SKU) identifier for products. Product-level data is available through the 'PRODUCT_ASSET' entity.
Dimensions: Territory Dimension
A custom dimension used for categorizing and reporting on advertising campaigns or assets based on geographical territory or region.
Dimensions: UTM_Medium Parameter Dimension
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 URL Dimension
The URL that is shown in an advertisement to users.
From Dimension
The start date or point in time for a reporting period.
Headline Dimension
The main title or heading of an advertisement.
Headline 2 Dimension
The secondary headline text used in an advertisement.
Headline 3 Dimension
The third headline text used in an advertisement, if applicable.
Image Name Dimension
The name of the image asset used in an advertisement.
Image Url Dimension
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.
Impressions Metric
The number of times an ad was displayed to users.
Keyword Dimension
A word or phrase that advertisers use to match their ads with the terms people are searching for.
Land URL Dimension
The final URL where users are directed after clicking on an ad.
Line 1 Dimension
The first line of description text in an advertisement.
Line 2 Dimension
The second line of description text in an advertisement.
Match Type Dimension
The type of match (e.g., Broad, Exact, Phrase) applied to keywords to control which searches can trigger an ad.
Mobile URL Dimension
The URL optimized for mobile devices where users are directed after clicking on an ad.
Modified Dimension
The date and time when a particular record or entity was last updated or modified.
Network Dimension
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 1 Dimension
The first optional path shown in the display URL of an ad.
Path 2 Dimension
The second optional path shown in the display URL of an ad.
Portfolio ID Dimension
A unique identifier for a portfolio, which groups campaigns for collective management and budgeting. This is available as the 'id' field for portfolios.
Portfolio Name Dimension
The name assigned to the portfolio.
Product ID Metric
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 Type Dimension
A classification that describes the kind of product being advertised.
Profile ID Dimension
The unique identifier for a user profile in the Skai platform, representing a distinct advertiser account or client.
Profile Name Dimension
The name of the user profile in the Skai platform.
Profit Metric
The financial gain from advertising activities after deducting costs.
Publisher Dimension
The platform or network where ads are displayed (e.g., Google, Facebook, Amazon).
Quality Score Metric
A diagnostic score reported by search engines that reflects the quality and relevance of keywords, ads, and landing pages.
ROI Metric
Return on Investment, a performance measure used to evaluate the efficiency of an investment, calculated as (Revenue - Cost) / Cost.
Report End Date Dimension
The last date included in the report's data range.
Report Start Date Dimension
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 Error Dimension
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 ID Dimension
A unique identifier for a tag applied to marketing entities like campaigns or ad groups. The API supports getting and editing tags.
Targeting Type Dimension
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.
To Dimension
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 ID Metric
A unique identifier used for tracking purposes, often associated with a conversion pixel or analytics tag.
Tracking Template Dimension
A URL template used to define how tracking information is appended to landing page URLs.
conversions Metric
The total number of desired actions taken by users after interacting with an ad.
new to brand orders Metric
The number of orders placed by customers who are new to the brand, as defined by the advertiser.
new to brand units Metric
The number of product units sold to customers who are new to the brand, as defined by the advertiser.
offline purchase Metric
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_revenue Metric
The revenue generated from offline purchase conversions. The API supports including revenue columns for selected conversion types in reports.
orders Metric
The number of successful purchase transactions or conversions resulting from advertising efforts. This is a critical conversion metric.
orders_revenue Metric
The revenue generated from orders. The API supports including revenue columns for selected conversion types in reports.
revenue Metric
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 sold Metric
The total number of product units purchased by customers.
videocomplete Metric
A performance metric indicating the number of times a video ad played to 100% completion. This is available as a video-specific performance metric.
videostart Metric
A performance metric indicating the number of times a video ad began playing. This is available as a video-specific performance metric.