Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
Send feedback
applied_incentive
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition Represents an applied incentive.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT clause.
applied_incentive.coupon_code
Field description Output only. The coupon code of the incentive.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.currency_code
Field description Output only. The currency code for all monetary amounts (for example,
"USD").
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.current_spend_towards_fulfillment_micros
Field description Output only. The current amount spent towards the fulfillment requirements,
in micros.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.fulfillment_expiration_date_time
Field description Output only. The time by which the incentive's fulfillment requirements
must be met, in "YYYY-MM-DD HH:MM:SS" format in UTC.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.granted_amount_micros
Field description Output only. The amount of the reward granted in micros.
This field is not set if the reward has not been granted.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.incentive_state
Field description Output only. The current state of the incentive.
Category ATTRIBUTEData Type
ENUM
EXPIRED
FULFILLED
INVALIDATED
REDEEMED
REWARD_EXHAUSTED
REWARD_EXPIRED
REWARD_GRANTED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.IncentiveStateEnum.IncentiveState Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.redemption_date_time
Field description Output only. The redemption time of the incentive in "YYYY-MM-DD HH:MM:SS"
format in UTC.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.required_min_spend_micros
Field description Output only. The minimum amount that must be spent to fulfill the coupon
requirements, in micros.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.resource_name
Field description Output only. The resource name of the incentive.
Incentive resource names have the form:
customers/{customer_id}/appliedIncentives/{coupon_code}
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.reward_amount_micros
Field description Output only. The maximum potential reward amount in micros for the
incentive.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable False Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.reward_balance_remaining_micros
Field description Output only. The remaining balance of the granted reward in micros.
This field is not set if the reward has not been granted.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.reward_expiration_date_time
Field description Output only. The time when the granted reward expires in "YYYY-MM-DD
HH:MM:SS" format in UTC. This field is not set if the reward has not been
granted.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
applied_incentive.reward_grant_date_time
Field description Output only. The time when the reward was granted in "YYYY-MM-DD HH:MM:SS"
format in UTC. This field is not set if the reward has not been granted.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-14 UTC."],[],[]]
