Adobe Advertising Cloud: Most-used fields#
The table below gives information about most-used fields that you can import from Adobe Advertising Cloud. 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_id |
ad_id |
Unique identifier for the ad. |
dimension |
ad_name |
ad_name |
The name of the ad. |
dimension |
advertiser_costs |
advertiser_costs |
The total cost incurred by the advertiser. |
metric |
advertiser_cpa |
advertiser_cpa |
The cost per acquisition for the advertiser. |
metric |
advertiser_cpc |
advertiser_cpc |
The cost per click for the advertiser. |
metric |
advertiser_cpcv |
advertiser_cpcv |
The cost per completed view for the advertiser. |
metric |
advertiser_cpe |
advertiser_cpe |
The cost per engagement for the advertiser. |
metric |
advertiser_cpi |
advertiser_cpi |
The cost per install for the advertiser. |
metric |
advertiser_cpm |
advertiser_cpm |
The cost per mille (thousand impressions) for the advertiser. |
metric |
advertiser_cpv |
advertiser_cpv |
The cost per view for the advertiser. |
metric |
advertiser_data_fees |
advertiser_data_fees |
The fees associated with data usage for the advertiser. |
metric |
advertiser_io_fees |
advertiser_io_fees |
The insertion order fees for the advertiser. |
metric |
advertiser_margin |
advertiser_margin |
The profit margin generated for the advertiser. |
metric |
advertiser_margin_pct |
advertiser_margin_pct |
The profit margin percentage for the advertiser. |
metric |
advertiser_media_fees |
advertiser_media_fees |
The fees associated with media buying for the advertiser. |
metric |
advertiser_other_fees |
advertiser_other_fees |
Other miscellaneous fees for the advertiser. |
metric |
advertiser_total_fees |
advertiser_total_fees |
The total sum of all fees incurred by the advertiser. |
metric |
advertiser_vcpm |
advertiser_vcpm |
The viewable cost per mille (thousand impressions) for the advertiser. |
metric |
banner_ctr |
banner_ctr |
The click-through rate for banner ads. |
metric |
bid_rate |
bid_rate |
The rate at which bids are placed for ad placements. |
metric |
bids |
bids |
The total number of bids placed. |
metric |
billable_data_fees |
billable_data_fees |
The data fees that are charged to the advertiser. |
metric |
billable_io_fees |
billable_io_fees |
The insertion order fees that are charged to the advertiser. |
metric |
billable_media_fees |
billable_media_fees |
The media fees that are charged to the advertiser. |
metric |
billable_other_fees |
billable_other_fees |
Other miscellaneous fees that are charged to the advertiser. |
metric |
billable_total_fees |
billable_total_fees |
The total sum of all fees that are charged to the advertiser. |
metric |
campaign.account_id |
campaign.account_id |
The unique identifier for the account associated with the campaign. |
dimension |
campaign.ad_group_id |
campaign.ad_group_id |
The unique identifier for the ad group within the campaign. |
dimension |
campaign.advertiser_id |
campaign.advertiser_id |
The unique identifier for the advertiser of the campaign. |
dimension |
campaign.advertiser_name |
campaign.advertiser_name |
The name of the advertiser of the campaign. |
dimension |
campaign.billing_type |
campaign.billing_type |
The method of billing used for the campaign (e.g., CPM, CPC). |
dimension |
campaign.budget_cap |
campaign.budget_cap |
The maximum budget allocated for the campaign. |
dimension |
campaign.budget_cap.amount |
campaign.budget_cap.amount |
The monetary value of the budget cap for the campaign. |
metric |
campaign.budget_cap.enforce_as_cap |
campaign.budget_cap.enforce_as_cap |
Indicates if the budget cap is strictly enforced for the campaign. |
dimension |
campaign.budget_cap.interval |
campaign.budget_cap.interval |
The time interval over which the budget cap is applied (e.g., daily, monthly) for the campaign. |
dimension |
campaign.budget_cap.metric |
campaign.budget_cap.metric |
The metric used to define the budget cap (e.g., impressions, spend) for the campaign. |
metric |
campaign.campaign_key |
campaign.campaign_key |
A unique key for the campaign. |
dimension |
campaign.campaign_type |
campaign.campaign_type |
The type or objective of the campaign (e.g., brand awareness, direct response). |
dimension |
campaign.discount_rate |
campaign.discount_rate |
The discount rate applied to the campaign. |
metric |
campaign.end_age |
campaign.end_age |
The end age target for the campaign audience. |
metric |
campaign.end_time |
campaign.end_time |
The scheduled end date and time of the campaign. |
dimension |
campaign.ethnicity |
campaign.ethnicity |
The ethnicity targeting parameter for the campaign. |
dimension |
campaign.fee |
campaign.fee |
Information regarding fees associated with the campaign. |
metric |
campaign.fee.fee_rate |
campaign.fee.fee_rate |
The rate at which fees are applied to the campaign. |
metric |
campaign.fee.fee_units |
campaign.fee.fee_units |
The units in which the campaign fees are measured. |
dimension |
campaign.frequency_cap |
campaign.frequency_cap |
The maximum number of times an ad in the campaign will be shown to a unique user. |
metric |
campaign.frequency_cap_interval |
campaign.frequency_cap_interval |
The time interval for the frequency cap (e.g., per day, per week) for the campaign. |
dimension |
campaign.gender |
campaign.gender |
The gender targeting parameter for the campaign. |
dimension |
campaign.geos |
campaign.geos |
Geographic targeting parameters for the campaign. |
dimension |
campaign.parent_campaign_id |
campaign.parent_campaign_id |
The unique identifier of the parent campaign, if applicable. |
dimension |
campaign.start_age |
campaign.start_age |
The start age target for the campaign audience. |
metric |
campaign.start_time |
campaign.start_time |
The scheduled start date and time of the campaign. |
dimension |
campaign.status |
campaign.status |
The current operational status of the campaign (e.g., active, paused). |
dimension |
campaign.timezone_id |
campaign.timezone_id |
The identifier of the timezone used for the campaign. |
dimension |
campaign.timezone_use_dst |
campaign.timezone_use_dst |
Indicates whether Daylight Saving Time (DST) is observed for the campaign’s timezone. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the campaign. |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
dimension |
click_per_view |
click_per_view |
The number of clicks per view. |
metric |
click_through_view_rate |
click_through_view_rate |
The rate at which users click through after viewing an ad. |
metric |
companion_click_throughs |
companion_click_throughs |
The number of clicks on companion ads. |
metric |
companion_ctr |
companion_ctr |
The click-through rate for companion ads. |
metric |
companion_impressions |
companion_impressions |
The number of impressions delivered by companion ads. |
metric |
completions |
completions |
The total number of ad completions. |
metric |
completions100 |
completions100 |
The number of times an ad was viewed 100% to completion. |
metric |
completions25 |
completions25 |
The number of times an ad was viewed 25% to completion. |
metric |
completions50 |
completions50 |
The number of times an ad was viewed 50% to completion. |
metric |
completions75 |
completions75 |
The number of times an ad was viewed 75% to completion. |
metric |
conversions_click_through |
conversions_click_through |
The number of conversions attributed to ad clicks. |
metric |
conversions_click_through_avg_days |
conversions_click_through_avg_days |
The average number of days between an ad click and a conversion. |
metric |
conversions_impressions |
conversions_impressions |
The number of conversions attributed to ad impressions. |
metric |
conversions_impressions_avg_days |
conversions_impressions_avg_days |
The average number of days between an ad impression and a conversion. |
metric |
conversions_rate |
conversions_rate |
The rate of conversions. |
metric |
conversions_total |
conversions_total |
The total number of conversions. |
metric |
conversions_view |
conversions_view |
The number of conversions attributed to ad views. |
metric |
conversions_view_avg_days |
conversions_view_avg_days |
The average number of days between an ad view and a conversion. |
metric |
cpa |
cpa |
The cost per acquisition. |
metric |
cpc |
cpc |
The cost per click. |
metric |
cpcv |
cpcv |
The cost per completed view. |
metric |
cpi |
cpi |
The cost per install. |
metric |
cpm |
cpm |
The cost per mille (thousand impressions). |
metric |
cpv |
cpv |
The cost per view. |
metric |
ctp |
ctp |
The click-to-play rate. |
metric |
ctr |
ctr |
The click-through rate. |
metric |
data_spend_cpm |
data_spend_cpm |
The cost per mille for data spend. |
metric |
data_spend_total |
data_spend_total |
The total spend on data fees. |
metric |
day |
day |
The specific day for which the data is reported. |
dimension |
engagements |
engagements |
The total number of user engagements with the ad. |
metric |
estimated_data_fees |
estimated_data_fees |
The estimated fees for data usage. |
metric |
estimated_media_fees |
estimated_media_fees |
The estimated fees for media buying. |
metric |
estimated_other_fees |
estimated_other_fees |
Other estimated miscellaneous fees. |
metric |
estimated_total_fees |
estimated_total_fees |
The estimated total sum of all fees. |
metric |
frequency |
frequency |
The average number of times a unique user is shown an ad. |
metric |
impressions |
impressions |
The total number of times an ad was displayed. |
metric |
margin_pct |
margin_pct |
The percentage of profit margin. |
metric |
media_spend_cpm |
media_spend_cpm |
The cost per mille for media spend. |
metric |
media_spend_total |
media_spend_total |
The total spend on media buying. |
metric |
mobile_installs |
mobile_installs |
The number of mobile application installs attributed to ads. |
metric |
non_billable_data_fees |
non_billable_data_fees |
The data fees that are not charged to the advertiser. |
metric |
non_billable_media_fees |
non_billable_media_fees |
The media fees that are not charged to the advertiser. |
metric |
non_billable_other_fees |
non_billable_other_fees |
Other miscellaneous fees that are not charged to the advertiser. |
metric |
non_billable_total_fees |
non_billable_total_fees |
The total sum of all fees that are not charged to the advertiser. |
metric |
not_viewable_impressions |
not_viewable_impressions |
The number of impressions that were not deemed viewable. |
metric |
not_viewable_pct_impressions |
not_viewable_pct_impressions |
The percentage of impressions that were not deemed viewable. |
metric |
other_spend_cpm |
other_spend_cpm |
The cost per mille for other miscellaneous spend. |
metric |
other_spend_total |
other_spend_total |
The total spend on other miscellaneous fees. |
metric |
package_id |
package_id |
The unique identifier for the ad package. |
dimension |
package_name |
package_name |
The name of the ad package. |
dimension |
pct_completions100 |
pct_completions100 |
The percentage of times an ad was viewed 100% to completion. |
metric |
pct_completions25 |
pct_completions25 |
The percentage of times an ad was viewed 25% to completion. |
metric |
pct_completions50 |
pct_completions50 |
The percentage of times an ad was viewed 50% to completion. |
metric |
pct_completions75 |
pct_completions75 |
The percentage of times an ad was viewed 75% to completion. |
metric |
pct_viewed_avg |
pct_viewed_avg |
The average percentage of an ad that was viewed. |
metric |
placement.ad_template |
placement.ad_template |
The template used for ads within the placement. |
dimension |
placement.budget_cap.amount |
placement.budget_cap.amount |
The monetary value of the budget cap for the placement. |
dimension |
placement.budget_cap.enforce_as_cap |
placement.budget_cap.enforce_as_cap |
Indicates if the budget cap is strictly enforced for the placement. |
dimension |
placement.budget_cap.interval |
placement.budget_cap.interval |
The time interval over which the budget cap is applied (e.g., daily, monthly) for the placement. |
dimension |
placement.budget_cap.metric |
placement.budget_cap.metric |
The metric used to define the budget cap (e.g., impressions, spend) for the placement. |
metric |
placement.end_time |
placement.end_time |
The scheduled end date and time of the placement. |
dimension |
placement.frequency_cap |
placement.frequency_cap |
The maximum number of times an ad in the placement will be shown to a unique user. |
metric |
placement.frequency_cap_interval |
placement.frequency_cap_interval |
The time interval for the frequency cap (e.g., per day, per week) for the placement. |
dimension |
placement.max_bid |
placement.max_bid |
The maximum bid amount set for the placement. |
metric |
placement.start_time |
placement.start_time |
The scheduled start date and time of the placement. |
dimension |
placement_id |
placement_id |
The unique identifier for the ad placement. |
dimension |
placement_key |
placement_key |
A unique key for the ad placement. |
dimension |
placement_name |
placement_name |
The name of the ad placement. |
dimension |
play_rate |
play_rate |
The rate at which video ads begin to play. |
metric |
player_height_avg |
player_height_avg |
The average height of the video player. |
metric |
player_width_avg |
player_width_avg |
The average width of the video player. |
metric |
playtime_per_view |
playtime_per_view |
The average playtime duration per view. |
metric |
profit |
profit |
The profit generated from advertising activities. |
metric |
responses |
responses |
The number of responses received. |
metric |
revenue |
revenue |
The revenue generated from advertising activities. |
metric |
starts |
starts |
The number of times a video ad started playing. |
metric |
timezone |
timezone |
The timezone used for reporting data. |
dimension |
total_click_throughs |
total_click_throughs |
The total number of click-throughs. |
metric |
total_fees |
total_fees |
The total sum of all fees. |
metric |
vCPCV |
vCPCV |
The viewable cost per completed view. |
metric |
vcpm |
vcpm |
The viewable cost per mille (thousand impressions). |
metric |
video_and_overlay_clicks |
video_and_overlay_clicks |
The number of clicks on video ads and their overlays. |
metric |
viewability_instrumented_impressions |
viewability_instrumented_impressions |
The number of impressions that were successfully measured for viewability. |
metric |
viewability_rating |
viewability_rating |
The overall viewability rating of impressions. |
dimension |
viewability_unmeasurable_iframe |
viewability_unmeasurable_iframe |
The number of impressions where viewability could not be measured due to an iframe. |
metric |
viewability_unmeasurable_iframe_other |
viewability_unmeasurable_iframe_other |
The number of impressions where viewability could not be measured due to other iframe-related issues. |
metric |
viewability_unmeasurable_other |
viewability_unmeasurable_other |
The number of impressions where viewability could not be measured due to other unknown reasons. |
metric |
viewable_complete100 |
viewable_complete100 |
The number of viewable ads completed 100%. |
metric |
viewable_complete25 |
viewable_complete25 |
The number of viewable ads completed 25%. |
metric |
viewable_complete50 |
viewable_complete50 |
The number of viewable ads completed 50%. |
metric |
viewable_complete75 |
viewable_complete75 |
The number of viewable ads completed 75%. |
metric |
viewable_impression_rate |
viewable_impression_rate |
The rate of viewable impressions. |
metric |
viewable_impressions |
viewable_impressions |
The number of impressions that were deemed viewable. |
metric |
viewable_measurable_impressions |
viewable_measurable_impressions |
The number of impressions that were both viewable and measurable. |
metric |
viewable_measurable_rate |
viewable_measurable_rate |
The rate of impressions that were both viewable and measurable. |
metric |
viewable_pct_complete100 |
viewable_pct_complete100 |
The percentage of viewable ads completed 100%. |
metric |
viewable_pct_complete25 |
viewable_pct_complete25 |
The percentage of viewable ads completed 25%. |
metric |
viewable_pct_complete50 |
viewable_pct_complete50 |
The percentage of viewable ads completed 50%. |
metric |
viewable_pct_complete75 |
viewable_pct_complete75 |
The percentage of viewable ads completed 75%. |
metric |
viewable_pct_impressions |
viewable_pct_impressions |
The percentage of impressions that were deemed viewable. |
metric |
viewable_unmeasurable_impressions |
viewable_unmeasurable_impressions |
The number of viewable impressions that could not be measured. |
metric |
viewable_unmeasurable_rate_iframe |
viewable_unmeasurable_rate_iframe |
The percentage of impressions where viewability instrumentation failed to initialize due to an iframe error. |
metric |
viewable_unmeasurable_rate_not_supported |
viewable_unmeasurable_rate_not_supported |
The percentage of impressions where viewability instrumentation failed because the environment was not supported. |
metric |
viewable_unmeasurable_rate_other |
viewable_unmeasurable_rate_other |
The percentage of impressions where viewability instrumentation failed due to other issues. |
metric |
viewable_unmeasurable_rate_total |
viewable_unmeasurable_rate_total |
The total percentage of impressions where viewability instrumentation failed. |
metric |
viewable_views |
viewable_views |
The number of times an ad was viewed and considered viewable. |
metric |
viewed_minutes |
viewed_minutes |
The total minutes of ad content viewed. |
metric |
views |
views |
The total number of times an ad was viewed. |
metric |
win_rate |
win_rate |
The rate at which bids won ad placements. |
metric |