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 preceding resources can be selected along with this
resource in your SELECT and WHERE clauses. These fields do not segment
metrics in your SELECT clause.
applied_incentive.coupon_code
Field description Output only. The coupon code of the incentive.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
applied_incentive.currency_code
Field description Output only. The currency code for all monetary amounts (for example,
"USD").
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
applied_incentive.current_spend_towards_fulfillment_micros
Field description Output only. The current amount spent towards the fulfillment requirements,
in micros.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
applied_incentive.incentive_state
Field description Output only. The current state of the incentive.
Category ATTRIBUTE
Data Type ENUM
EXPIRED
FULFILLED
INVALIDATED
REDEEMED
REWARD_EXHAUSTED
REWARD_EXPIRED
REWARD_GRANTED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.IncentiveStateEnum.IncentiveState
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type RESOURCE_NAME
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
applied_incentive.reward_amount_micros
Field description Output only. The maximum potential reward amount in micros for the
incentive.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: False Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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 ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: applied_incentive
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-11-17 UTC.
[null,null,["Last updated 2026-11-17 UTC."],[],[]]