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 |