Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
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.