Simpli.fi: Most-used fields

Simpli.fi: Most-used fields#

The table below gives information about most-used fields that you can import from Simpli.fi. 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.

API name

Adverity UI name

Description

Use in Adverity

Ad Ad File Type

Ad Ad File Type

The file format of the advertisement creative (e.g., JPG, PNG, GIF, MP4).

dimension

Ad Ad ID

Ad Ad ID

Unique identifier for an individual advertisement.

metric

Ad Ad Name

Ad Ad Name

The name of the specific advertisement.

dimension

Ad Ad Size

Ad Ad Size

The dimensions of an advertisement, typically expressed in pixels (e.g., ‘300x250’).

dimension

Ad Group Name

Ad Group Name

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

dimension

Campaign Advertiser Name

Campaign Advertiser Name

The name of the advertiser associated with the campaign.

dimension

Campaign Campaign ID

Campaign Campaign ID

Unique identifier for an advertising campaign.

metric

Campaign Campaign Name

Campaign Campaign Name

The name of the advertising campaign.

dimension

Campaign Campaign Type

Campaign Campaign Type

The classification or category of an advertising campaign (e.g., display, video, search).

dimension

Campaign End Date

Campaign End Date

The scheduled end date for the advertising campaign.

dimension

Campaign Media Type

Campaign Media Type

The type of media used for advertising within a campaign (e.g., image, video, audio).

dimension

Campaign Start Date

Campaign Start Date

The scheduled start date for the advertising campaign.

dimension

Companies Client ID

Companies Client ID

A unique identifier for the client associated with the advertising campaign.

metric

Companies Client Name

Companies Client Name

The name of the client associated with the advertising campaign.

dimension

Companies Company ID

Companies Company ID

A unique identifier for the company managing or owning the advertising campaigns.

metric

Companies Company Name

Companies Company Name

The name of the company managing or owning the advertising campaigns.

dimension

Companies Platform ID

Companies Platform ID

A unique identifier for the advertising platform used for the campaign.

metric

Companies Platform Name

Companies Platform Name

The name of the advertising platform used for the campaign.

dimension

Conversion Rate Campaign Conversion Rate

Conversion Rate Campaign Conversion Rate

The percentage of ad interactions (e.g., clicks, impressions) that resulted in a conversion for a specific campaign.

metric

Conversion Rate Natural Conversion Rate

Conversion Rate Natural Conversion Rate

metric

Conversion Segment Conversion Segment Name

Conversion Segment Conversion Segment Name

The name of the specific conversion segment to which a conversion event is attributed.

dimension

Conversions CPA

Conversions CPA

The Cost Per Acquisition (CPA) for conversions, calculated as total spend divided by the total number of conversions.

dimension

Conversions Clickthrough Leads

Conversions Clickthrough Leads

The number of leads generated from users who clicked on an ad.

dimension

Conversions Clickthrough Other

Conversions Clickthrough Other

The number of miscellaneous conversion events resulting from users who clicked on an ad.

dimension

Conversions Clickthrough Sales

Conversions Clickthrough Sales

The number of sales generated from users who clicked on an ad.

dimension

Conversions Clickthrough Signups

Conversions Clickthrough Signups

The number of sign-ups or registrations generated from users who clicked on an ad.

dimension

Conversions Clickthrough Total

Conversions Clickthrough Total

The total number of conversions that occurred as a result of a user clicking on an ad.

metric

Conversions Clickthrough Visits

Conversions Clickthrough Visits

The number of website visits generated from users who clicked on an ad.

metric

Conversions Total Leads

Conversions Total Leads

The total number of leads generated from advertising efforts.

dimension

Conversions Total Other

Conversions Total Other

The total count of conversion events that do not fall into predefined categories like leads, sales, or signups.

dimension

Conversions Total Sales

Conversions Total Sales

The total number of sales generated from advertising efforts.

dimension

Conversions Total Signups

Conversions Total Signups

The total number of user sign-ups or registrations attributed to advertising campaigns.

dimension

Conversions Total Visits

Conversions Total Visits

The total number of website visits attributed to advertising campaigns.

dimension

Conversions Viewthrough Leads

Conversions Viewthrough Leads

The number of leads generated from users who viewed an ad but did not click on it.

dimension

Conversions Viewthrough Other

Conversions Viewthrough Other

The number of miscellaneous conversion events resulting from users who viewed an ad but did not click on it.

dimension

Conversions Viewthrough Sales

Conversions Viewthrough Sales

The number of sales generated from users who viewed an ad but did not click on it.

dimension

Conversions Viewthrough Signups

Conversions Viewthrough Signups

The number of sign-ups or registrations generated from users who viewed an ad but did not click on it.

dimension

Conversions Viewthrough Total

Conversions Viewthrough Total

The total number of conversions that occurred after a user viewed an ad but did not click on it.

metric

Conversions Viewthrough Visits

Conversions Viewthrough Visits

The number of website visits generated from users who viewed an ad but did not click on it.

metric

Conversions Weighted Actions

Conversions Weighted Actions

A metric representing the sum of conversions, where different conversion types may be assigned different weight values.

metric

Day Counts By User Campaign Days to Convert

Day Counts By User Campaign Days to Convert

The number of days it took for a user to convert after interacting with a campaign ad.

metric

Day Counts By User Natural Days to Convert

Day Counts By User Natural Days to Convert

metric

Domain Domain Name

Domain Domain Name

The domain name of the website where an ad was displayed or where a conversion occurred.

dimension

End Date

End Date

The end date for the reporting period or campaign.

dimension

Geography Conversion Geo Fence ID

Geography Conversion Geo Fence ID

A unique identifier for the geo-fenced area where a conversion event occurred.

metric

Geography Conversion Geo Fence Name

Geography Conversion Geo Fence Name

The name of the geo-fenced area where a conversion event occurred.

dimension

Geography Country

Geography Country

The country where an advertising event occurred or where the target audience is located.

dimension

Geography Geo Fence Name

Geography Geo Fence Name

The name of a defined geographic boundary or geo-fence used for targeting or reporting.

dimension

Geography Postal Code

Geography Postal Code

The postal code where an advertising event occurred or where the target audience is located.

dimension

Keyword Keyword Name

Keyword Keyword Name

The name of the keyword associated with a search advertising campaign or relevant to content.

dimension

Lift Conversion Lift

Lift Conversion Lift

The measured increase in conversion rate directly attributable to an advertising campaign compared to a control group.

metric

Lift New Conversion Lift

Lift New Conversion Lift

The measured increase in new conversions attributable to an advertising campaign, focusing on conversions from users who haven’t converted before.

metric

Margins by CPM Behavioral CPM

Margins by CPM Behavioral CPM

The Cost Per Mille (CPM) attributed to advertising based on user behavioral targeting segments.

metric

Margins by CPM Contextual CPM

Margins by CPM Contextual CPM

The Cost Per Mille (CPM) attributed to advertising based on contextual targeting, where ads are placed on websites relevant to the ad content.

metric

Margins by CPM Demographic CPM

Margins by CPM Demographic CPM

The Cost Per Mille (CPM) attributed to advertising based on demographic targeting segments.

metric

Margins by CPM Geographic CPM

Margins by CPM Geographic CPM

The Cost Per Mille (CPM) attributed to advertising based on geographic targeting segments.

metric

Margins by CPM Media CPM

Margins by CPM Media CPM

The Cost Per Mille (CPM) attributed to advertising based on the media type used for delivery.

metric

Margins by CPM Platform CPM

Margins by CPM Platform CPM

The Cost Per Mille (CPM) attributed to advertising based on the specific advertising platform used.

metric

Margins by CPM Search CPM

Margins by CPM Search CPM

The Cost Per Mille (CPM) attributed to advertising delivered via search advertising campaigns.

metric

Margins by CPM Segment CPM

Margins by CPM Segment CPM

The Cost Per Mille (CPM) attributed to advertising based on various audience segments.

metric

Performance CTR

Performance CTR

The click-through rate, calculated as clicks divided by impressions, indicating ad effectiveness.

dimension

Performance Clicks

Performance Clicks

The total number of clicks received by the advertisement or campaign.

dimension

Performance Impressions

Performance Impressions

The total number of times an advertisement was displayed.

metric

Performance Total Spend

Performance Total Spend

The total monetary amount spent on advertising campaigns.

metric

Performance eCPC

Performance eCPC

The effective Cost Per Click (eCPC), calculated by dividing the total advertising spend by the total number of clicks.

dimension

Performance eCPM

Performance eCPM

The effective Cost Per Mille (eCPM), or cost per thousand impressions, calculated by dividing the total advertising spend by the number of impressions in thousands.

dimension

Plat Plat City

Plat Plat City

The city associated with the advertising platform or specific campaign targeting.

dimension

Plat Plat State

Plat Plat State

The state associated with the advertising platform or specific campaign targeting.

dimension

Plat Plat Zip Code

Plat Plat Zip Code

The postal code associated with the advertising platform or specific campaign targeting.

dimension

Plat Plat Zip Short

Plat Plat Zip Short

A shortened version of the postal code, potentially for broader geographic targeting or reporting.

metric

Platform

Platform

The name of the advertising platform or channel where ads are served.

dimension

Start Date

Start Date

The start date for the reporting period or campaign.

dimension

Time Event Date

Time Event Date

The specific date on which an event or statistic was recorded.

dimension

Time Event Hour

Time Event Hour

The hour of the day when an advertising event (e.g., impression, click, conversion) occurred.

metric

User Counts Campaign Converters

User Counts Campaign Converters

The number of unique users who completed a conversion action as a result of a campaign.

metric

User Counts Campaign Users

User Counts Campaign Users

The total number of unique users exposed to or interacting with a campaign.

metric

User Counts Natural Converters

User Counts Natural Converters

metric

User Counts Natural Target Fence Users

User Counts Natural Target Fence Users

metric

User Counts New Campaign Converters

User Counts New Campaign Converters

The number of unique users who converted for the first time as a result of a campaign.

metric

User Counts New Natural Converters

User Counts New Natural Converters

metric

Video Events Complete

Video Events Complete

The count of times a video ad was played to 100% completion.

dimension

Video Events Complete Rate

Video Events Complete Rate

The percentage of video ad plays that were completed.

dimension

Video Events First Quartile

Video Events First Quartile

The count of times a video ad was played to at least 25% completion.

dimension

Video Events Fullscreen

Video Events Fullscreen

The count of times a video ad was viewed in full-screen mode.

dimension

Video Events In Banner

Video Events In Banner

The count of times a video ad was played within a banner ad placement.

dimension

Video Events In Stream Mid Roll

Video Events In Stream Mid Roll

The count of times a video ad was played as a mid-roll ad within streaming content.

dimension

Video Events In Stream Post Roll

Video Events In Stream Post Roll

The count of times a video ad was played as a post-roll ad within streaming content.

dimension

Video Events In Stream Pre Roll

Video Events In Stream Pre Roll

The count of times a video ad was played as a pre-roll ad within streaming content.

dimension

Video Events Interstitial

Video Events Interstitial

The count of times a video ad was displayed as an interstitial ad (full-screen, interrupting content).

dimension

Video Events Midpoint

Video Events Midpoint

The count of times a video ad was played to at least 50% completion.

dimension

Video Events Mute

Video Events Mute

The count of times a video ad was muted by the user.

dimension

Video Events Mute Rate

Video Events Mute Rate

The percentage of video ad plays that were muted by the user.

dimension

Video Events Pause

Video Events Pause

The count of times a video ad was paused by the user.

dimension

Video Events Pause Rate

Video Events Pause Rate

The percentage of video ad plays that were paused by the user.

dimension

Video Events Resume

Video Events Resume

The count of times a video ad was resumed by the user after being paused.

dimension

Video Events Start

Video Events Start

The count of times a video ad began to play.

dimension

Video Events Third Quartile

Video Events Third Quartile

The count of times a video ad was played to at least 75% completion.

dimension

Video Events Unknown Type

Video Events Unknown Type

dimension

Video Events Unmute

Video Events Unmute

The count of times a video ad was unmuted by the user.

dimension

ad_id

ad_id

Unique identifier for an individual advertisement.

dimension

campaign_id

campaign_id

Unique identifier for an advertising campaign.

dimension

campaign_name

campaign_name

The name of the advertising campaign.

dimension

clicks

clicks

The total number of clicks received by the advertisement or campaign.

dimension

cpa

cpa

The Cost Per Acquisition (CPA), representing the cost incurred for each conversion.

metric

cpc

cpc

The Cost Per Click (CPC), representing the cost incurred for each click on an advertisement.

dimension

cpm

cpm

The Cost Per Mille (CPM), or cost per thousand impressions, representing the cost for one thousand ad impressions.

dimension

ctr

ctr

The click-through rate, calculated as clicks divided by impressions.

metric

impressions

impressions

The total number of times an advertisement was displayed.

metric

name

name

The name associated with the data entry, which can be a campaign name or an ad name depending on the report granularity.

dimension

stat_date

stat_date

The date for which the statistics are reported.

dimension

total_spend

total_spend

The overall monetary amount expended on advertising campaigns.

metric

vcr

vcr

The Video Completion Rate (VCR), which is the percentage of video ads played to completion.

metric

weighted_actions

weighted_actions

The sum of conversions, where different conversion types are assigned specific weight values.

metric