Adobe Advertising Cloud: Most-used fields

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